This document describes how to install Caché 4.1 on a computer running Windows 95, 98, 2000, ME, or NT (with service pack 4, 5, or 6). After Caché is installed, you can adjust the configuration to suit your needs or use an existing Caché configuration.
Installation Requirements
This section describes the hardware and software requirements for new and upgrade installations.
Hardware
Any system that can effectively support Windows should be sufficiently powerful to run Caché. Caché performance greatly improves with increased processor and disk speed.
Caché uses approximately 100 Mb disk storage (not including disk space for user data). You must have 10 Mb additional disk space free on your Windows system disk for installation.
Your system must have access to a CD-ROM drive for installation, either attached to your computer or available across a network.
Supported Platforms
Caché is supported on the following versions of the Windows operating system:
To install Caché on a Windows NT platform, you need NT system administrator privileges.
Any Windows client that runs the Caché application development or system administration utilities must have Microsoft Internet Explorer 5 installed in order to access the online help in the Microsoft HTML Help format.
If you are installing Caché from a network, first copy the entire contents of the CD to the network drive. Map the network drive to a particular drive letter, for instance, “Q:”, by clicking Map Network Drive from the Tools menu in Windows Explorer.
The Caché installer requires a drive letter in order to operate; do not use the netuse command from the command prompt (also known as the MS-DOS prompt).
Installation Directory Restrictions
You cannot install Caché into a destination directory that has any of the following characteristics:
Supported Upgrade Paths
For specific information on upgrading, please first read the Caché Upgrade and Compatibility Guide to check for any compatibility issues.
Caché Installation
The steps for each type of Caché installation are fundamentally the same, but differ in step 7, selecting the type of installation. The differences are detailed in subsections after the standard installation description.
Caché Standard Installation
The standard installation procedure installs both Caché server and client components on the computer. To perform a standard installation follow these steps:
  1. If you are upgrading, stop any running Caché server on the computer. Also, close all other Windows applications and shut down the Web server if it is installed on the same computer. Ensure that you have access to the source. For a CD-ROM installation, load the software CD into your CD drive. For a network installation, ensure that you have access to the files.
  2. Click Start and click Run from the menu. In the Open text box of the Run dialog box, enter:
    [drive]:\setup.exe
    The drive value is the letter of your CD-ROM drive. The Caché Setup dialog box appears.
  3. Click on Install. The Caché setup begins. While preparing for the installation, setup checks that you have at least 10 Mb of free disk space. Within setup, reply to the prompts as they appear:
  4. If this is a new installation, choose Yes to confirm that you accept the Caché License Agreement.
  5. If this is an update installation, the Select Install Configuration dialog box is displayed. If a version of Caché for Windows exists, setup displays a list of existing installation directories. You can select one of these directories to update, or install into a new directory.
  6. If this is a new installation, the Define Caché Installation Name dialog box is displayed and prompts you to enter an initial configuration name. CACHE is the default configuration name. Accept the default or enter another name. Update installations maintain your current default configuration name.
  7. At the Setup Type dialog box, select the type of installation:
    This dialog box also allows you to select a destination directory for the Caché software; the default location is C:\CacheSys. You can enter another directory by clicking Browse. The directory pathname can be a maximum of 32 characters.
  8. Select either 8-bit (the default) or Unicode support for your installation:
  9. The Install Summary dialog box shows the selected installation items and destination directory for the software files. Click Next to continue. Setup installs Caché in the selected directory.
  10. If you do not have a Caché license already on your computer, Caché asks if you want to enter your license now. See the Enter Your License Key section for more information.
  11. At the Setup Complete dialog box, click Finish. Caché will start automatically. If a reboot is necessary, you will be prompted to start one.
  12. Click Exit in the Caché Setup dialog box.
After Caché is installed, you should see the Caché Cube icon in the system tray area of the Windows tool bar. Using the right mouse button (right-click) on the icon to bring up the Caché menu. In addition, you will have a Caché icon on the Programs menu.
For NT servers, the installation names the Caché service as Caché Controller for configname, using the name entered in the Define Caché Installation Name dialog box. The service is set up to start automatically as an NT service when you boot up your server. If you entered license key information so that the license server is running on the same computer, the license server will start automatically also.
Caché Client Installation
If you wish, you can install only those parts of Caché that are required on a client machine. These include the Caché system and programmer utilities. The client installation follows a set of dialog boxes similar to a Caché standard installation.
This software is included when you install Caché and does not require a separate installation medium.
To perform a client installation:
  1. Follow steps 1-6 of the standard installation.
  2. At the Setup Type dialog box, select Client.
    The dialog box allows you to select a destination directory for the Caché software; the default location is C:\CacheSys. You can enter another directory by clicking Browse. The directory pathname can be a maximum of 32 characters.
  3. Continue with steps 8-12 of the standard installation.
Caché Custom Installation
The Caché installation program allows you to select certain Caché components to be installed on the computer. For example, you may want to install only the Caché SQL ODBC Driver. Keep in mind that some selections require that you also install other components.
The following table lists the components you can select.
Caché Custom Components
Component Description Other Required Components
ActiveX Connectivity Installs ActiveX components that allow connectivity between client applications and Caché. Caché Direct Connectivity
Caché Direct Connectivity Installs Caché Direct, which is needed for client connectivity.
Caché Engine Installs the base Caché database engine. Caché Tools and Utilities, Caché Direct Connectivity, ActiveX Connectivity
Caché Engine Link Libraries Installs C header files and object files that are necessary for relinking Caché on Windows platforms.
Caché Tools and Utilities Installs development tools (such as the Caché Studio and Caché Architect) and system management utilities (such as the Caché Configuration Manager). Caché Direct Connectivity and ActiveX Connectivity
Documentation Installs the Caché documentation. The documents are in either HTML or PDF format.
Manager Utility Source Code Installs the utility source code into the %SYS Namespace. Caché Engine
ODBC Connectivity Installs the Caché SQL ODBC Client Driver. Caché Direct Connectivity
Samples Installs sample programs for Caché Objects, Java, and other features.
Web Server Gateway (CSP) Installs the Caché Server Pages (CSP) gateway on the installation machine's Web server.
WebLink Installs Caché WebLink, which links your Caché database to the World Wide Web.
Note:
The default selections on the custom menu are Caché Engine, Web Server Gateway, ActiveX Connectivity, ODBC Connectivity, Caché Tools and Utilities, Caché Direct Connectivity, Samples, and Documentation; these are the same components installed in a standard installation.
To perform a Caché custom installation:
  1. Follow steps 1-6 of the standard installation.
  2. At the Setup Type dialog box, select Custom.
    The dialog box allows you to select a destination directory for the Caché software; the default location is C:\CacheSys. You can enter another directory by clicking Browse. The directory pathname can be a maximum of 32 characters.
  3. Select the components you wish to install.
  4. Continue with steps 8-12 of the standard installation.
Enter Your License Key
The Caché license server is required if you use a ClientServerPrimary, ClientServerAdditional, Enterprise, Division, or Workgroup license. Terminal and Server licenses do not require a license server. Stand-alone single-user PCs use the default single-user license. For more information about licensing, contact your InterSystems sales representative.
Note:
Licenses from versions prior to Caché 4.0 or other InterSystems products will not work with Caché 4.1.
From the Enter License dialog box:
If you have a license, but it is not already installed, or if you have updated your license information, you are asked whether you want to add one as part of the installation.
Follow the instructions below to specify your license key from the Caché License Wizard:
  1. Click Next in the Introduction dialog box.
  2. A dialog box appears asking if you wish to obtain a license from an existing server. When entering a license key do not select the Use License Server check box. Click Next.
    If, however, you require a license server that varies from the standard setup, follow the procedure in the Use a License Server section to enter this information.
  3. In the Set License Information dialog box, enter the identifying information from the license that you obtained from InterSystems. The information includes the Customer Name, Order Number, Product Authorization Key, Expiration Date, Machine Type, and Machine ID. Be sure that you enter the information exactly as specified in your license.
  4. In the Set License Capacity Info dialog box, enter the specific information from your license.
  5. Click Finish. When Caché starts, your new license information takes effect.
    If you have any problems entering your license information, see the License Troubleshooting section.
Use a License Server
The license server can run either locally or on a remote system. Run only one license server for each license group. Each Caché server operating under that license must include the network location of that license server as part of its system configuration.
To enter the location of your license server:
  1. Select the Use License Server check box to obtain a license from an existing server and click Next.
  2. Enter the IP Address or the Host Name of the system running the license server. For the IP Address, use the decimal format (for example: 194.7.104.33). If you run the license server locally, you can use 127.0.0.1 as the address. You can also use the actual IP address, which you can find with the Windows Control Panel.
  3. Enter the port number (default is 4001) of the system running the license server.
  4. In addition you may have a license which will be submitted to the license server during Caché startup. If so, select the Enter a License check box and click Finish. You will be at step 3 in the Entering Your License Key procedure.
    Otherwise, do not select the check box and click Finish. When the configuration is started, Caché will obtain licenses from the license server.
License Troubleshooting
InterSystems Caché Packet Drivers
To use Raw Ethernet, DDP, or LAT (needed for NT only) with Caché on Windows systems, you must install the appropriate packet driver as described below. First load the CD-ROM or verify the network location of the appropriate driver file.
Install Caché Packet Driver for Windows NT
For Windows NT 4.0 systems, install the InterSystems Packet Driver for Windows NT as follows:
  1. Right-click Network Neighborhood on the desktop and click Properties.
    You can also click Start, point to Settings and click Control Panel, then double-click Network.
  2. Click the Protocol tab.
  3. Click Add and then click Have Disk.
  4. Type the path of the CD-ROM or network drive and click OK.
  5. Select InterSystems Caché for NT Packet Driver 3.1 and click OK. The driver is installed to the appropriate directory on your system.
  6. When complete, click Close to start the binding procedure.
  7. When binding is complete, click Yes to restart your computer.
After you restart Windows NT, Caché is fully available to you.
Install Caché Packet Driver for Windows 2000
For Windows 2000 systems, install the InterSystems Packet Driver for Windows 2000 as follows:
  1. Right-click My Network Places on the desktop and click Properties.
    You can also click Start, point to Settings and click Network and Dial-up Connections.
  2. Right-click Local Area Connection and click Properties.
  3. Click Install.
  4. Click Protocol in the Select Network Component Type dialog box and then click Add.
  5. Click Have Disk in the Select Network Protocol dialog box.
  6. Enter the path to the packet driver kit and click OK.
    You can also enter the appropriate drive letter and click Browse to search for the correct path,\drivers\win2k, that contains the file ispkt2k.inf. Click Open and then click OK.
  7. After the driver is installed, click Close.
After you restart Windows 2000, Caché is fully available to you.
Install Caché Packet Driver for Windows 95/98/ME
For Windows 95/98 or ME systems, install the InterSystems Packet Driver for Windows as follows:
  1. Right-click on Network Neighborhood from the desktop and then click Properties.
    You can also click Start, point to Settings and click Control Panel, then double-click the Network icon.
  2. Click the Configuration tab and then click Add. A dialog box appears, prompting you to select a Network Component Type. Select Protocol and then click Add.
  3. Click Have Disk. Type the CD or network drive in the Install From Disk dialog box. Click OK.
  4. Select InterSystems Caché for Windows 95 Packet Driver 2.0 from the Select Network Protocol dialog box and click OK.
  5. You should now see InterSystems Caché for Windows 95 Packet Driver displayed in the Installed Network Component list box. Click OK.
  6. The Network Control Panel installs the drivers into the appropriate directories on your system. The installer may require the Windows CD-ROM or installation diskettes if you do not have all of the necessary base components installed.
  7. Restart your system.
After you restart Windows, Caché is fully available to you.
Caché Silent Installation
The Caché for Windows installation utility provides you the option of performing a silent installation on your computer. A typical (non-silent) installation receives the necessary input from the user in the form of responses to dialog boxes. A silent installation does not prompt the user for input; it must get its user input from a response file. The InstallShield Silent application reads the necessary input from the response file at run time and logs setup information in a file.
For each step in a silent installation, use the Setupi.exe installation program from the NT directory. The Setup.exe that is on the root of the CD has nothing to do with InstallShield's installation, and does not pass any arguments to the InstallShield executables that eventually get called.
Record a Response File
A response file is a plain text file consisting of sections containing data entries. To create a response file, simply run the setup with the -r command line parameter:
Setupi.exe -r
Answer the prompts as appropriate. InstallShield will record all your setup choices in a response file named Setup.iss and place the file in the Windows directory.
Run a Silent Install
After you have created the response file, you are ready to run the setup in silent mode using InstallShield Silent. When running a setup in silent mode, be aware that no messages are displayed. Instead, a log file named Setup.log captures setup information, including whether the setup was successful. You can review the log file and determine the result of the setup.
To launch InstallShield Silent, run setup with the -s command line parameter:
Setupi.exe -s
The setup will play back the script created in the previous step. InstallShield also provides the -f1 and -f2 parameters so that you can specify the name and location of the response file and the location of the log file. There are additional parameters available that are described in the following section.
To verify if a silent setup succeeded, look at the ResultCode value in the “[ResponseResult]” section of Setup.log. InstallShield writes an appropriate return value after the ResultCode keyname.
InstallShield Silent Command Line Parameters
The following table describes the silent installation parameters. Unless otherwise indicated these are not case sensitive; uppercase or lowercase letters can be used.
InstallShield Silent Command Line Parameters
Command Line Parameter Description
-fpath\CompiledScript Specifies an alternate compiled script. Unless the compiled script (.ins file) also resides in the same directory as Setupi.exe, the full path to the compiled script must be specified. The _setup.dll file must also reside in the same directory as your .ins file. For example, Setupi -ftest.ins will launch setup using test.ins instead of Setup.ins.
-f1path\ResponseFile Specifies an alternate location and name of the response .iss file. If this option is used when running InstallShield Silent, the response file is read from the directory or file specified by path\ResponseFile. If this option is used with the -r option, the response file is written to the file specified bypath\ResponseFile. If the -f option is used. The -f1 parameter must follow the -f parameter
-f2path\LogFile Specifies an alternate location and name of the log file created by the silent installation. By default, Setup.log file is created and stored in the same directory as Setup.ins. If the -f option is used. The -f2 parameter must follow the -f parameter.
-mfilename Causes InstallShield to generate a Management Information Format (.MIF) file automatically at the end of the installation. Do not include a path because the .mif file is always placed in the Windows directory. filename is optional; if you do not specify a file name, the resulting file is named Status.mif.
-m1serial_number Instructs InstallShield to place the indicated serial number in the created .mif file.
-m2locale_string Tells setup to place the indicated locale in the .mif file. English (ENU) is the default. Refer to Microsoft documentation for a complete listing of locale strings.
-r Causes Setupi.exe to automatically generate a silent installation .iss file, which is a record of the installation input, in the Windows directory.
-s Runs InstallShield Silent to execute a silent installation.
-SMS Prevents a network connection and Setup from closing before the installation is complete. This parameter, which must be in uppercase, works with installations originating from a Windows NT server over a network.
-z Prevents Setup from checking the available memory during initialization. This parameter is necessary when running a setup on a machine with more than 256 MB of memory; if it is not used, Setup reports insufficient memory and exits.
Silent Setup Log
The default name for the silent setup log file is Setup.log and its default location is Disk1 (in the same directory as Setup.ins). You can specify a different name and location for Setup.log using the -f1 and -f2 parameters.
The Setup.log file contains three sections:
  1. [InstallShield Silent] — Identifies the version of the InstallShield Silent application used in the silent setup. It also identifies the file as a log file.
  2. [Application] — Identifies the name and version of the installed application, and the company name.
  3. [ResponseResult] — contains the result code indicating whether or not the silent setup succeeded.
An integer value is assigned to the ResultCode keyname in the “[ResponseResult]” section. InstallShield places one of the following return values after the ResultCode keyname.
ResultCode Return Values
Return Value Description
0 Successful installation
-1 General error
-2 Invalid mode
-3 Required data not found in the Setup.iss file
-4 Not enough memory available
-5 File does not exist
-6 Cannot write to the response file
-7 Unable to write to the log file
-8 Invalid path to the InstallShield Silent response file
-9 Not a valid list type (string or number)
-10 Data type is invalid
-11 Unknown error during setup
-12 Dialog boxes are out of order
-51 Cannot create the specified folder
-52 Cannot access the specified file or folder
-53 Invalid option selected
The following example shows a Setup.log file for a successful silent setup of InstallShield.
[InstallShield Silent]
Version=v5.00.000
File=Log File

[Application]
Name=InstallShield5
Version=5.00.000
Company=InstallShield

[ResponseResult]
ResultCode=0
Change a Non-English Caché to English
When you install Caché on a computer that is configured as a non-English system, a language-specific utility DLL is installed in the CacheSys\Bin directory. This DLL contains localized strings and messages.
The name of the DLL is UTILxxx.DLL, where xxx is a 3-letter code that signifies the following languages:
Language Codes for Language-Specific DLLs
Code Language
DEU German (Standard)
ENU English (United States)
ESP Spanish (Spain)
FIN Finnish
FRA French
ITA Italian (Standard)
JPN Japanese
KOR Korean
NLD Dutch (Standard)
PTB Portuguese (Brazilian)
RUS Russian
In addition to the language-specific DLL, the English DLL (UTILENU.DLL) is always installed. For example, a German computer would have UTILDEU.DLL and UTILENU.DLL in the Bin directory.
If you are running a non-English version of Caché and wish to change to the English locale, either delete or rename the language-specific DLL. Leave the UTILENU.DLL, so that it remains as the only language DLL for Caché.
Uninstall Caché
Use only the Caché-supplied Uninstall program when uninstalling Caché. On a Windows NT system, for example, use the Add/Remove Programs utility from the Windows Control Panel. Other uninstall programs are not supported, and using them may cause unexpected results.
Installation Warning Messages
This section describes some warning or error messages that you may see during the installation procedure.
DLL Overwrite Message
While installing (especially on Windows 95/98), you may receive a warning message similar to this:
c:\windows\system\msvcrt.dll  Overwrite?
This is the correct behavior for a file that is marked as read-only. If this occurs, answer Yes or Yes to All.
MS-DOS Mode Message
On some Windows 95/98 systems, the MS-DOS Prompt properties (command.pif) in the Windows directory have been modified so the advanced program properties specify "MS-DOS mode". Caché cannot operate in such an environment.
You can tell that this incompatibility exists on your system if you see the following message in a window entitled MS-DOS Prompt during installation:
This program is set to run in MS-DOS mode and cannot run while other programs 
are running. All other programs will close if you choose to continue.
If you need to run command.com in MS-DOS mode for some reason, you can work around this problem as follows:
  1. Copy command.com and command.pif from the Windows directory to a directory that is not in your path. (For example, to C:\ or move it to the directory of any program that needs to run command.com in MS-DOS mode.)
  2. Update the properties of the command.pif in the Windows directory so the advanced program properties of the \Windows\command.pif file specifies: "Suggest MS-DOS mode as necessary."
This change permits Caché to operate normally.
Uninstallation Message
You may receive a warning message if you accidentally double-click Install twice in the Caché Setup dialog box; you will be running two instances of the install option.
The second install process returns a warning about not being able to install because an uninstallation is in progress, and the installation may appear to hang. This is caused by having too many intermediate InstallShield directories (named _ins*.dir) in the Temp directory. If you delete the directories except for the latest one, the installation will proceed.