The following instructions were adapted from Nancy Anthracite's document entitled InstallingVistAWithSingleUserVersionCache5.2, which was created to guide a user through installing InterSystems Caché onto a Windows operating system. The instructions were using an older version of Caché; this uses the Caché 2011 trial version and shows the updated Management Portal interface.
Trial versions of the Caché installer can be downloaded from
http://download.intersystems.com/download/register.csp.
This installation guide uses Caché 2011.1, it should also apply for Cache 2013. If you already have a Caché installation and are looking to install VistA as an additional database, you do not have to re-install Caché. Please use your existing installation and pick up the instructions at the point where the folder is created within the mgr folder.
Download the Caché installer from the above link and double click on the downloaded .exe file. The first window that requires interaction is the Licensing Agreement shown in the figure below. Agree to the license in order to continue in the installation process.
The next window asks to set the directory in which Caché will be installed. Most users will be able to accept the default path. If more than one instance is found on the machine, the next instances will be denoted with a number appended to the end of the instance name.
Once the install directory is set, the installer will display a summary of the instance that will be installed in the process. There is the option to enter a license if you have one, but this is not a required step for the current testing configuration.
After the installation has finished, the completion screen is shown.
The first sign of a correctly installed and running instance of Caché is the Caché Cube in the taskbar, like below.
Clicking on the Cube will open a menu that displays the options to interact with the Caché database.
The next test to ensure that your Caché instance is working is to open the documentation. This will bring up the documentation home page in your default web browser.
Once Caché is installed, it is time to create the proper folders and environment to run the VistA instance within Caché. The first step is to go to the mgr folder of Caché and create a new folder as shown below. This folder will hold the database file cache.dat that will contain the VistA routines and globals.
As an example, the folder has been given the name "VistA." While the choice of name has no bearing on the installation, the testing code requires that the Namespace chosen below in matches the folder name created in this step.
At this point we are ready to stand up the VistA instance. Right click on the Caché cube and select Management Portal of Caché.
This link will open a Management Portal web page. Click on System Administration to show administrative options.
System Administration shows those options that can be used to change the Caché system. Our goal is to use the Configuration function to create and initialize an empty database that can then be filled with the VistA routines and globals. Starting from System Administration page of Management Portal:
Click on Configuration, System Configuration, and Local Databases to arrive at System Configuration menu. Create the database by clicking on the Local Databases tab and then selecting Go.
This resulting page contains the list of all of the local databases. All of the selections shown were created automatically during the installation of Caché. Create a new database by clicking on the "Create New Database" button. This will bring up a wizard.
Set the directory entry to the folder that you created and set the database name. We recommend using the same name as the folder, but this is not necessary. When satisfied, select "Next" to proceed.
It is not necessary to change any of the default settings to enable testing and we recommend simply hitting Finish to proceed. However, if there are known required settings for the current site, these settings can be modified.
Verify that the newly created database appears in the database listing.
We now will configure the namespace for the newly created database. Navigate back to the System Configuration menu, click on the Namespaces option.
Then, click on the "Create New Namespace" button to open a wizard.
In the wizard, enter the name of the namespace and then select the database created above. Be certain to name the Namespace the same as the folder created above. Click on "Save" to finish the Namespace creation and to return to the namespace listing.
Verify that the new namespace is now in the list of current namespaces.
The next steps will be configuring the global and routine mappings, both of which are accessed from this page. We will focus on the global mapping first.
To create the new mapping, click on New Global Mapping. This opens another configuration wizard.
For VistA, there is only one global mapping that needs to be made. First set the Global Database location to the VistA database name, and for the Global Name enter "%Z*". This will map all globals that start with "%Z" to be specific to the VistA namespace. Click OK and the wizard will exit and display the new mapping in the window. Be sure to click on Save Changes before navigating back to the Namespaces page.
Verify that the global mapping has been saved to the namespace.
The final step before Caché is ready for the import is to map the routines. From within the Namespaces menu in the Management Portal, click on the Routine Mappings link.
This page will list the current routine mappings for the VistA namespace. Much like the globals, there are no current mappings. Click on the New Routine Mapping button to bring up the routine mapping wizard.
Again select the database location that corresponds to the VistA database, enter "%DT*" into the Routine name, and click Apply. This adds the first namespace mapping to the VistA database.
There are six other mappings that need to be entered in the same manner -
%RCR %XU* %ZIS* %ZO* %ZT* %ZV* |
After the final mapping is set, click OK to be sent back to the Routine Mapping page. You should now see the seven mappings listed on the page. Click on the Save Changes button.
The final step of preparing the Caché installation for testing is to set the instance to allow TELNET service. This is done though the System Administration > Security > Services menu.
Click on Go to be brought to the menu which lists all services that are supported by Caché. Near the bottom of the list you will see the "%Service_Telnet" listing.
Click on the link to bring up the "Edit Service" page.
To enable the Telnet session, simply check the box next to "Service Enabled" and then click "Save".
After saving, the Services menu will now show that the Telnet service is enabled.
