2. Installation

Ovrimos fully functional copies can either be downloaded from http://www.ovrimos.com or purchased together with licenses in a CD package. Installation is fast and easy for the following reasons:

• Consists of a few simple steps.
• It is not necessary to modify system files.
• Rebooting is not required.

System Requirements  

• TCP/IP should be installed  and DNS should be properly configured.
• 4 Mb of free disk space, 10 MB RAM minimum, plus 1 MB per database.

Before installing Ovrimos, keep the following in mind:

• We use the term <Ovrimos root dir> to denote the user-specified directory where the Ovrimos files will be installed.

• Avoid installing Ovrimos in your system's root directory.
• Avoid installing Ovrimos on a disk that is likely to become full.
• Some steps may require root privileges. However, it is recommended that you select with care which user will own the installation, because Ovrimos will run with his/her privileges. All steps not requiring root privileges should be performed by that user who is denoted by the term <Ovrimos user>.

NOTE:
Before installing or using Ovrimos, please read the License Agreement (refer to http://www.ovrimos.com). You indicate your acceptance of such License Agreement by installing and using Ovrimos unless you have agreed to license terms by executing a separate written license agreement with Ovrimos S.A.

   
2.1 Unix Installation

It is assumed that Ovrimos files will be installed from the CD. In case you have downloaded Ovrimos from http://www.ovrimos.com, skip the first step.

1.

Mount the CD. This is system specific and may require root privileges. We assume that you already have a directory called /cdrom for mapping the CD ROM drive.

Example:
mount -t iso9660 /dev/cdrom /cdrom

2.

As <Ovrimos user> create the <Ovrimos root dir>. Then, change the working directory to the <Ovrimos root dir>.

Example:
mkdir ovrimos
cd ovrimos

3.

As <Ovrimos user> extract the contents of the .tar file corresponding to your platform into the <Ovrimos root dir>. 
If you install from a CD, look for
<CDRom Mount Point>/<OS>/<Architecture>.tar.

Example:
tar xvf /cdrom/linux/alpha.tar

4.

To complete the installation, follow the step which corresponds to your decision to have system files modified or not at this point.

If you wish to have Ovrimos started automatically every time you reboot your computer, you will have to modify system files, which requires root privileges. If you don't wish to modify system files, you will have to start Ovrimos manually every time (see Section 4.2).

(a)

If you wish system files to be modified at this point, do the following:
Run the install script as root. This script creates the initialization files for Database Manager (refer to Chapter 4) and for testbase  (an empty demonstration database). The script also installs Ovrimos in the boot sequence and runs it.

Example:
./install

(b)

If you don't wish system files to be modified do the following:

i.

As <Ovrimos user> run the dbman.ini.create script. This script creates the initialization files for Database Manager and for testbase, as above and sets the setuid bit of bin/dbman.

Example:
./dbman.ini.create

ii.

Start the database manager as described below. Database Manager should be started every time the system is rebooted.

As <Ovrimos user> change your current directory to the <Ovrimos root dir> and run bin/dbman. In this case, the dbman tries to locate a dbman.ini file in the current working directory and load the global parameters from it.

Example:
cd ovrimos
bin/dbman

Alternatively, run dbman supplying the dbman.ini as an argument.

Example:
<Ovrimos root dir>/bin/dbman <Ovrimos root dir>/dbman.ini

Installation is now complete.

Reference:

• Database Manager (refer to Chapter 4) is a daemon process called dbman which remains running until explicitly killed. It has an HTML based interface  for the database management (create, delete, start, stop, edit parameters, view the log files, etc.).
• The directories created and files copied during installation are described in Appendix A
• dbman.ini contains configuration data for Ovrimos and its contents are described in Appendix A

  
2.1.1 FreeBSD Installation

FreeBSD users may have to rebuild their system kernel in order to install System V IPC.

Since the default FreeBSD kernel lacks System V IPC support, FreeBSD users may have to rebuild their system kernel, enabling both SYSVSEM and SYSVSHM. In short:

• go to /sys/i386/conf
• copy GENERIC to e.g. MYKERNEL
• enable option SYSVSEM
• enable option SYSVSHM (one of the two may be there already)
• run /usr/sbin/config/MYKERNEL
• go to ../../compile/MYKERNEL
• run make depend
• run make
• run make install

Next time the FreeBSD is started, both SYSVSEM and SYSVSHMEM will be available.

To complete installation, follow the instructions in Section 2.1

   
2.2 Windows NT / Windows 2000 Installation

You can either install Ovrimos from the CD or you can download the installation files from http://www.ovrimos.com. To install Ovrimos you should have administrator privileges.

• Look for nt/x86/Setup.exe
• Run Setup.exe
• Follow the on-screen instructions

  
2.3 Post-installation tasks

   
2.3.1 Populating testbase (optional)

After performing a first-time installation, only the empty database testbase exists, for demonstration purposes.

To populate testbase follow these steps:

1.

start testbase from Database Manager as described in chapter 4.

2.

change your working directory to where the directory holding the demos reside.
This will be either the CD's demos directory, or, if you have downloaded Ovrimos from the web site, the directory where you have unpacked the demos.

3.

depending on the operating system, type the corresponding line

• Unix
  <Ovrimos root dir>/bin/sqlapp4 <host-computer>|localhost 3000 admin pegasus insert.sql
  
• Windows NT
  <Ovrimos root dir>/bin/sqlapp4 <host-computer>|localhost 3000 admin pegasus insertw.sql

Reference: sqlapp4 is a command line SQL client application and is explained in Chapter 9

2.3.2 Familiarizing yourself with the basics of working with Ovrimos

To gain an understanding of the Ovrimos components available to you as well as a familiarity with the basics of working with Ovrimos, it is recommended that you read section 3.1.

2.3.3 Accessing Database Manager

Follow the instructions given in Chapter 4 which explains how to access Database Manager and what tasks it allows you to perform.

    
2.3.4 Ovrimos registration and licensing

A serial number identifies you as a registered Ovrimos user. A separate license number determines the number of concurrent connections you have purchased.

Registering is a way to acquire a serial number.

The privileges you acquire through registration when you try out Ovrimos on an evaluation basis differ from the ones you get when you have purchased licenses in the number of concurrent connections and in the period of time you are allowed to use them.

To be able to use the concurrent connections you have either purchased or acquired through registering (on Ovrimos Web site), you should edit the serial number and/or the license as explained in section 4.12.

  
2.4 Upgrade Installation

An upgrade installation upgrades your older version to the current Ovrimos version.

Before upgrading Ovrimos installation make sure that:

• All databases are down.
• Database Manager is not running.
  See Sections 4.7 and 4.2.

On Unix systems, install the version you want to upgrade to, following the instructions in Section 2.1

On Windows NT, install the version you want to upgrade to, following the instructions in Section 2.2. More specifically, when upgrading from version 2.6 to 2.6c you are asked by the program to select one of three options. The only option which is relevant to this case is the option Repair. The option Remove uninstalls Ovrimos.

  
2.5 Uninstalling Ovrimos

Uninstalling doesn't remove the existing databases (except testbase).

Before uninstalling Ovrimos make sure that all databases are down.

2.5.1 Unix

In case you have had system files modified during installation do the following:

• Change your working directory to <Ovrimos root dir>
• Run the uninstall script as root

Otherwise stop Database Manager by running:
<Ovrimos root dir>/bin/.dbmandown

In both cases, remove (recursively) everything in the <Ovrimos root dir>.

2.5.2 Windows NT / Windows 2000

1.

Click Start, and then point to Settings.

2.

Click Control Panel.

3.

Double-click the Add/Remove Programs icon.

4.

Remove Ovrimos SQL Server.