Page History

This is a guide to installing the WhereScape Enablement Pack for Oracle for WhereScape RED

Prerequisites For PostgreSQL Metadata

Before you begin the following prerequisites must be met:

• Create Database and ODBC DSN:
  • Supported* version of PostgreSQL (PostgreSQL 12 or higher)
    • A database to house the RED Metadata Repository.
    • A database to house scheduler (Optional)
• Software Installations
  • WhereScape RED10.1.x.x with valid license key entered and EULA accepted
  • WhereScape Enablement Pack for target database version RED10.1.x.x 
• Windows Powershell (64-bit) version 4 or higher
  • To check the Windows Powershell Version:
    • Run the below command in Windows Powershell
      

      Code Block
      Get-Host|Select-Object Version

• • • Run the below command in the Command Prompt
      

      Code Block
      powershell $psversiontable

• Run the following command using PowerShell
  • • The security protocol TLS 1.0 and 1.1 used by PowerShell to communicate with the PowerShell gallery has been deprecated and TLS 1.2 has been made mandatory
      

      Code Block
      \[Net.ServicePointManager\]::SecurityProtocol = \[Net.ServicePointManager\]::SecurityProtocol -bor \[Net.SecurityProtocolType\]::Tls12 Register-PSRepository -Default -Verbose Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

• • • Progress bar placeholder info line
      

      Code Block
      Install-Module -Name PoshProgressBar -SkipPublisherCheck -Force

      
      
• RED supports the following versions for the metadata repository: PostgreSQL 12 or higher 

Prerequisites for Target Database

Before you begin the following prerequisites must be met:

1. Access to an Oracle System, with the following connectivity information:
   • TNS Service Name
   • Database Name
   • Port
   • User Name
   • Password
2. Setting up Oracle ODBC driver (64-bit)
   • Oracle Instant basic package (Oracle Instant Client Basic Package Windows 64-bit)
   • Download the Instant Client ODBC package. Unzip it in the same directory as your Basic package.
   • After unzipping all tools in the same directory Execute odbc_install.exe from the Instant Client directory.
3. After Oracle Instant client ODBC installed
   • Create Oracle ODBC driver DSN to connect to your RED Data Warehouse on Oracle.
4. Python 3.8 or higher 
   • Select "Add Python 3.8 to PATH" from the installation Window
   • Pip Manager Install with the command: python -m pip install --upgrade pip

Post Install Steps – Optional

If you used the script Setup Wizard for installation then the following optional post-install steps are available.
Configure Connections
There were two connections added that will optionally require your attention :

1. Connection: 'Database Source System' - this connection was set up as an example source connection,
   • open it's properties and set it up for a source DB in your environment
   • or you can remove it if not required
2. Execute Update Procedure for dim_date_or to Initialize Date Dimension for Target
   Image RemovedImage Added
   

   Note
   Please avoid regenerating the procedure update_dim_date_or as it is a custom procedure.

   
   

Source Enablement Pack Support

Troubleshooting and Tips

Run As Administrator

Press the Windows Key on your keyboard and start typing cmd.exe, when the cmd.exe icon shows up in the search list right click it to bring up the context menu, select Run As Administrator
Now you have an admin prompt navigate to to the folder where you have unpacked your WhereScape Red Enablement Pack using the cd command:
C:\Windows\system32> cd <full path to the unpacked folder> 
Run Powershell (.ps1) scripts from the administrator prompt by typing the Powershell run script command, for example:
C:\temp\EnablementPack>Powershell -ExecutionPolicy Bypass -File .\Setup_Enablement_Pack.ps1

Windows Powershell Script Execution

On some systems, Windows Powershell script execution is disabled by default. There are several workarounds for this which can be found by searching the term "Powershell Execution Policy".
Here is the most common workaround that WhereScape suggests, which does not permanently change the execution rights:
Start a Windows CMD prompt as Administrator, change the directory to your script directory, and run the WhereScape Powershell scripts with this command:

• cmd:>Powershell -ExecutionPolicy Bypass -File .\<script_file_name.ps1>

Restarting failed scripts

Some of the setup scripts will track each step and output the step number when there is a failure. To restart from the failed step (or to skip the step) provide the parameter -startAtStep <step number> to the script.
Example: 
Powershell -ExecutionPolicy Bypass -File .\<script_file_name.ps1> -startAtStep 123

Python requirements for offline install
Additionally to the base Python installation being required, the WhereScape Python Template set also requires certain additional Python libraries. The install scripts use the PIP (package manager) to download these libraries, however, for offline installs, you will need to install the required libraries yourself.
Required Python libraries/add-ons:

• pywin32-ctypes
• python-tds
• pywin32
• glob2
• gzip-reader
• regex
• pyodbc

If a valid RED installation can not be found

If you have RED 10.x or higher installed but the script (Setup_Enablement_Pack.ps1) fails to find it on your system then you are most likely running the PowerShell (x86) version which does not show installed 64-bit apps by default. Please open a 64-bit version of Powershell instead and re-run the script.