Installing software for MQ queues

VisionWeb using VPN

VisionWeb requires two pieces of software to be installed on the computer running the Rx-Universe Remote Processor session (usually the server).  These two pieces are the "Cisco VPN Client" and the "IBM WebSphere" connectors.

Up to date installation files can be obtained from VisionWeb upon request.

Installing Cisco VPN Client

On operating systems such as Windows Server 2016 and Windows 10, you will need to install the Citrix DNE Update software before installing the Cisco VPN.

Make sure to use the correct 32-bit or 64-bit of the install files, matching your system.  If you are unsure whether you have a 32-bit or 64-bit operating system, please consult your networking or IT personnel.

You should have install files for both similar to the following:

Install the dneupdate64.msi file first (assuming a 64-bit operating system).

Following successful install of the DNE update, install the "vpnclient_setup.msi" file by double-clicking on the file.  You may be prompted to reboot your computer following installation.

Once the Cisco VPN software is installed, install the IBM Websphere client - the C48UML.EXE.  Right-click and select "Run as Administrator", and follow the prompts for a "Typical" installation.

Installing on a Windows 10 computer

On a Windows 10 computer, you will need to edit the system registry to correct errors in the registry entries.

Launch Regedit.exe.

NOTE: The Windows Registry file is vital to the operation of the Windows operating system. Incorrectly editing or otherwise corrupting the Windows Registry file could prevent your computer from booting properly.

Navigate to the following location to modify the entry necessary to enable the VPN client within Windows 10:

                                HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CVirtA

Find the Display Name key and double-click it to edit the entry. Change it from:

"@oem8.ifn,%CVirtA_Desc%;Cisco Systems VPN Adapter"

to:

32bit: Remove the "@oem8.ifn,%CVirtA_Desc%;” so you just have "Cisco Systems VPN Adapter"

64bit: Remove the "@oem8.ifn,%CVirtA_Desc%;” so you just have “Cisco Systems VPN Adapter for 64-bit Windows”

All Operating Systems

Modify the default Environment Variable “PATH” to include the path that the Cisco VPN Client software was installed into – unfortunately, the Cisco software does not automatically place itself into the path. 

On Windows 2000 or XP computers, this is accomplished by right clicking on the “My Computer” icon on the desktop and selecting “Properties”.  Then select the Advanced tab and then press the “Environment Variables” button.  Under “System Variables”, highlight the “PATH” selections and press the EDIT button.  Add the Cicso Systems path to the end of the list; remember to separate this new addition from the other using a semi-colon.  The default installation path is “C:\Program Files\Cisco Systems\VPN Client”.  (Refer to your Windows user manuals for setting the PATH for other operating systems).

Also, if the WebSphere install put quotes around the entries for its path, you will need to REMOVE those quote marks (for example, if it set “C:\Program Files\IBM\WebSphere MQ\bin”, you will need to change that to C:\Program Files\IBM\WebSphere MQ\bin.  If the path to the WebSphere program is not in the path, you will need to add it, in addition to the path to the Cisco VPN software.

On Windows 10, click on the Windows button, start typing "Environment" and then select "Edit the system environment variables".  The following window should appear:

Click "Environment variables" to see a screen similar to:

Click on "Path" and then "edit" - add the path to the VPN client to the end of the screen, for example:

Click "OK" and then close the "Environment variables" window as well.


Set Up Cisco VPN Client

Once the Cisco VPN software is installed, it needs to be configured for use with VisionWeb.  Open the Cisco VPN Client, you’ll see a screen similar to the following:

Click the "New" button, and create an entry:

Create a new connection entry called Vision Web.

Host IPN is provided by Vision Web (clientgw.visionweb.com)

Group Authentication User / Password – this is the same for all OMICS and Rx-Universe labs (Omics, 0Mic$#!)

Transport – set to Enable transparent tunneling as IPSec over UDP

Keep all of the other defaults

After you “Save” the settings, you’ll be back to the main VPN screen:

Double-click on the “Vision Web” connection entry; you’ll be presented with a window like:

The username and password will be assigned by VisionWeb, and are different for each lab.  The default (test) settings are Omicsuser1 and omic$uzer1.  Once you enter your username and password, you should be connected to the VisionWeb network.  If you want to test this, you should be able to ping address 192.168.12.162.

(Note that the FIRST time you access this screen, the “save password” box is not available – you must connect, disconnect, and connect again in order to be able to check the “save password” box).