These instructions explain how to install Objectivity/DB and other optional components.

Some of the installation choices are based on user permissions. If you want the installer to set environment variables and start servers (select platforms), root privileges are required. If you do not have these privileges, some installation options will be disabled.

  1. Log in as root.
  2. Double click on the single-file installer, Objectivity.version.platform.run, to start it.
  3. In the Setup dialog, choose Typical or Full installation, and either accept the default installation directory (installDir) or select a different one.
    The installer suggests a default appropriate for your platform. Typically, /opt/Objectivity/version.
  4. In the Installation Options dialog:
    • (Optional) Select a license file to use. The license file will be copied into installDir.
      Alternatively, you can manually install a license file later.
    • Decide whether the installer should modify system environment variables. When installing as root, it is recommended that you do not have the installer modify environment variables.
  5. If prompted, choose the individual components you want to install.
    Objectivity/DB is a prerequisite for using any other Objectivity products.
  6. If installing Objectivity/C++, choose how to designate your C++ compiler for DDL. For example, choose your existing C++ compiler.
  7. When done, exit the installer.
  8. Perform general and platform-specific product configuration.

Installation Results

Depending on your UNIX platform, the installation and configuration of Objectivity servers varies:

  • On Linux platforms, Objectivity servers are installed as Linux services, and the lock server is auto-started.
  • On other UNIX platforms, Objectivity servers are installed simply as tools, and the lock server is not started.

The lock server, which controls database access by granting locks, must be running in order to use Objectivity/DB. Other Objectivity/DB servers that are not necessarily required for running Objectivity/DB can be configured and started at a later time; see about Objectivity Servers.

Installation Output Files

On completion, the installer produces a log file that lists any warning messages and provides information about what was installed. This log is placed in the top-level installation directory:

installDir/Objectivity-x.x-installLog.log

As a convenience, the installer also creates a setup script that contains commands for temporarily setting environment variables in a shell window:

installDir/setup.sh

Uninstalling

See Uninstalling.