Installation and Upgrade

Caché Direct is installed automatically when you install Caché. Sometimes, however, you may want to upgrade the server without reinstalling Caché or you may want to install the client-side software on a machine where Caché is not installed. This appendix describes how to do both of these things.

Upgrading Your Caché Direct Server

Caché Direct uses a server that is automatically installed with the rest of the Caché installation, but you can upgrade it easily without performing a new Caché installation. The Caché Direct server code is built to be backward compatible with older clients and all platforms. This means that you can upgrade the Caché Direct server to correct problems or install new features without other major upgrades.

To upgrade your Caché Direct server:

Get the latest Caché Direct encrypted text file for your platform from the InterSystems InterSystems Worldwide Response Center (WRC)Opens in a new tab and place it on the Caché server machine. This file has the extension .enc.
Stop any running Caché Direct jobs.
In the Terminal, enter the following command:
Do rload^%CDCrypt(<path_to_.enc file>[,password])
For example:
```
Do rload^%CDCrypt("C:\\temp\\CDCache.enc","SYS")
```

This decrypts the source, loads the resulting .int code, compiles it, and destroys the source. The optional password is for the case where the server source is to be preserved. It is usually left off. If the password is provided and is correct, the .int source is retained. If you need to perform some activity that requires the source (such as debugging or testing changes), you can get the password from the InterSystems InterSystems Worldwide Response Center (WRC)Opens in a new tab.

Installing VisM on a New Machine

The easiest way to install VisM is to install the Caché client software as usual. You can, however, install the Caché Direct client software manually. To do so:

Make sure that you have installed the Microsoft Visual 2008 Redistributable Package, which is needed in order to register the VisM DLLs.
Copy the following files from a machine where the client is installed:
- For Caché Direct before version 5.1 32–bit systems
  - NTI.dll
  - NTIIPTCP.dll
  - Cmvism32.dll and all files with similar names
  - ISLog.dll
  - VISM.ocx
- For Caché Direct 5.1 and later 32–bit systems
  - cconnect.dll
  - Cmvism32.dll and all files with similar names
  - ISCDLink.dll
  - ISLog.dll
  - VISM.ocx
- For Caché Direct 5.1 and later 64-bit systems
  - cconnect64.dll
  - Cmvism64.dll and all files with similar names
  - ISCDLink64.dll
  - ISLog64.dll
  - VISM64.ocx
Copy the files from the directory C:\Program Files\Common Files\InterSystems\Cache and paste them into the same directory on the target machine.
Open a command prompt, navigate to this directory, and enter the following command to register the ActiveX control (must be run by a user with administator privileges):
For 32-bit systems
```
C:\Windows\SysWOW64\regsvr32 vism.ocx
```
For 64-bit systems
```
C:\Windows\System32\regsvr32 vism64.ocx
```