This chapter describes the installation steps for ObjectStore Release 5.1 for Windows 95 and Windows NT.

Installation Procedure

1. Execute setup.exe. When you run setup in the top level of the CDROM, the utility starts a series of dialog boxes that walk you through the installation procedure. The first dialog box that appears is the screen that displays the ObjectStore C++, Java, ActiveX, and Component Server buttons.
   
   
2. Select the ObjectStore C++ button. This begins the installation. If you are upgrading, the procedure detects the existing ObjectStore copy and asks if you want to install before displaying the Welcome screen.
   
   
3. Register. The next screen prompts you for your registration information. If you are reinstalling ObjectStore, this information is picked up automatically from the Windows registry.
   
   
4. Select your license type. Once your registration information is verified, select your license type from the displayed list and select the Next button. There is no option to install the non-on-line license types; use the corresponding on-line selection. For your convenience, there is a single option to install two licenses - a Client and a Server - on a single machine.
   
   
5. Choose an installation type . Select the icon for a Typical or Custom installation path. Use the Custom installation if you want to
   
   
   • Set Server parameters to other than the default values
   • Choose specific components to install
   • Set up or modify a rawfs file system
6. Select components to install. Select the ObjectStore components you want to install. The available components vary depending on the license type selected. ObjectStore/Single is only available if the license type includes a client (so it is not available for On-Line Run-Time Server or Development Server). Examples are only available for the Development license types. The disk space required for each component and the available disk space for the selected drive are displayed on the screen. Choices for a development installation are
   
   
   • ObjectStore DBMS
   • ObjectStore/Single (Development Client/Server license only)
   • Example Source Files (Development license only)
   • ObjectStore HTML and PDF Documentation When this dialog appears, the items that are selected vary depending on which license you have, and whether you choose typical or custom installation.

7. Specify where to install ObjectStore. In the same dialog, choose the destination directory for the ObjectStore sources.
   
   ObjectStore can be installed on any type of file system partition. Note that Server logs and database partitions must be on a local hard drive. ObjectStore itself takes 28 MB of disk for the development version, and 11 MB for the run-time version, plus at least an additional 2.5 MB for the Server log file and/or database partition file.

8. Verify the destination directory selection. If the directory you specified as the location for the ObjectStore installation already exists, you are given three options: overwrite the existing directory, rename the existing directory, or install ObjectStore after the installation program deletes the files in the existing directory.
   
   
9. Create and store ObjectStore icons. In a custom installation, the Select Program Folder dialog adds ObjectStore program icons to the folder you specify. This can be an existing folder or a new folder you name with this dialog.
   
   
10. Check the settings you have chosen and install ObjectStore. This dialog summarizes the settings you have selected. If you want to change a setting, except for Server parameters, use the Back button to get to the appropriate menu. Otherwise, select the Next button to begin installation. File copying begins.
    
    
11. To install the ObjectStore full-text-searchable documentation, you must install the ObjectStore C++ Interface first, choose Custom installation and check off the ObjectStore HTML Documentation checkbox. This copies the documentation on your hard disk, and put two icons in your ObjectStore Win32 program group. One is called OSSearch Setup and the other is ObjectStore Documentation. OSSearch Setup installs the documentation initially.When installation is complete, you access the on-line documentation using the ObjectStore Documentation icon.
    
    

Configuring ObjectStore

1. Modify the Server Parameters. When copying is completed, the setup utility asks you whether you want to modify Server parameters before proceeding. See ObjectStore Management for information on Server parameters' purpose and values. (Custom installation only.)
   
   
2. Add or modify the rawfs. The setup utility asks you if you want to create or modify the rawfs components.
   
   
3. Initialize (or Reinitialize) the Server log file. Select this option before starting the ObjectStore services. Reinitialize appears when the installation procedure detects an existing log file.
   
   
4. Start ObjectStore Services. Supply a pathname and verify that you want to initialize the Server log file. If you are unable to or do not want to initialize the Server, you can do so later with the command OSSERVER -con -i.
   
   

   Choosing to start Objectstore services automatically

   Users without Administrator privileges on Windows cannot start and stop ObjectStore services. Consequently, if the necessary ObjectStore services are not started automatically, these users are unable to run ObjectStore applications. In particular, the Cache Manager must be started automatically, even if there is no Server running on the machine. By default, ObjectStore services are always started automatically; therefore, this issue only arises if you change the defaults for service start-up.

   Start the Cache Manager

   The ObjectStore Cache Manager starts automatically at system start-up and is required to run ObjectStore. You are asked whether to start the ObjectStore Cache Manager 5.1 immediately.

5. Finish the Installation. The dialog enables you to bring up the README file immediately after you complete the installation by selecting finish.
   
   
6. The setup utility returns you to the top-level screen that offers you the option of installing the Java interface, the ActiveX interface, and the Component Server. Each of these packages has its own installation procedure that is menu driven and easy to install. If you choose to install either or both of these interfaces, respond to the dialog choices in a manner similar to the one you used for the ObjectStore C++ installation.
   
   

Environment variable changes

Updated: 04/08/98 13:04:40