Omnis Studio 3.0.1
INSTALL.TXT
Date: January 2001
 
This document describes the installation and serialization of Omnis Studio under Windows 95/98, Windows NT, Windows 2000, PowerMacintosh, and Linux.

Contents:-
1. Installing Omnis Studio.
2. Serializing Omnis Studio.
3. Evaluating Omnis Studio. 
4. Installation Support.


1. Installing Omnis Studio.
===========================

The Omnis Studio CD contains a Win95-98, WinNT-2000, Linux, and PMac folder containing the Setup and Installer programs to install Omnis Studio version 3.0. In addition, the Manuals folder contains the complete documentation set for Omnis Studio in PDF format and includes the Acrobat Readers. The Plug-ins folder contains additional products that plug into Omnis Studio.

1.1 Installing Omnis Studio under Windows 95 or Windows 98.
-----------------------------------------------------------

To install Omnis Studio under Windows 95 or 98, open the Win95-98 folder and run the Setup.exe program by double-clicking on it, following the instructions provided. If you are new to Omnis Studio you should select the NEW USERS option in Setup to install the development version of Omnis Studio automatically. 

Experienced users can choose the Experienced Users option in Setup, or they can install the Development or Runtime version of Studio using the installers contained in the INSTALL folder. Please note that you should install Omnis Studio 3.0 into a new folder, not over the top of your existing Omnis folder. 

1.2 Installing Omnis Studio under Windows NT or Windows 2000.
-------------------------------------------------------------

To install Omnis Studio under Windows NT or 2000, open the WinNT-2000 folder and run the Setup.exe program by double-clicking on it, following the instructions provided. If you are new to Omnis Studio you should select the NEW USERS option in Setup to install the development version of Omnis Studio automatically. 

Experienced users can choose the Experienced Users option in Setup, or they can install the Development, Runtime, or Server version of Studio using the installers contained in the INSTALL folder. Please note that you should install Omnis Studio 3.0 into a new folder, not over the top of your existing Omnis folder. 

1.3 Installing Omnis Studio for PowerMacintosh.
-----------------------------------------------

To install Omnis Studio for PowerMacintosh, open the PMac folder and run the NewUserInstall program by double-clicking on it, following the instructions provided. Please note that you should install Omnis Studio 3.0 into a new folder, not over the top of your existing Omnis folder. 

1.4 Installing Omnis Studio under Linux.
----------------------------------------

1.4.1 New User installation.

To install Omnis Studio for Linux, open the Linux folder, then the appropriate language folder (e.g. English), and run the Setup program, following the instructions provided. Please note that you should install Omnis Studio 3.0 into a new folder, not over the top of your existing Omnis folder. 

1.4.2 Experienced user installation using the .rpm files. 

The INSTALL folder inside the Linux folder contains an rpm installer file for the Development, Runtime, and Server versions of Omnis Studio for Linux called omnis.rpm, omnisrt.rpm, omserver.rpm, respectively. You can install one of these directly from the CD or copy the rpm file to your local machine and install from there. The Linux folder also has the Webclient folder containing the omweb.rpm installer file.
 
At the command line, you can run an .rpm by typing: 
rpm -i <complete path to the .rpm file>
Alternatively, you can use a graphical rpm manager to install the .rpm file. You can also install Omnis Studio for Linux from .taz file(s) also supplied on the CD, as described below. 

1.4.3 Experienced user installation using the .taz files. 

The Development, Runtime, and Server versions of Omnis Studio for Linux are stored in the files called omnis.taz, omnisrt.taz, and omserver.taz respectively. The installation process is the same for each file, as follows. Copy the appropriate .taz file to the directory in which you wish to install Omnis. At the command line type:
tar -xzvf <name of .taz file> 
Next you need to append the Omnis Studio home directory to the environment variable LD_LIBRARY_PATH. You also need to create a script to execute Omnis Studio. This is completed by executing the omset file using the command:
./omset
A file called omnisI386 has been created in the Omnis Studio home directory. It is now possible to run Omnis Studio for Linux (either Development, Runtime, or Server) by executing the file omnisI386 using the command.
./omnisI386

1.4.4 Adding Omnis to the Gnome Desktop. 

An Image of the Omnis Studio Icon (studio.png) is present in the Omnis Studio home directory, this can be used on a Desktop Toolbar button to launch Omnis Studio. The following describes how you can add the Omnis program to the Gnome desktop (note this may not be true for other desktop environments).
1. Right-Click on Gnome taskbar and select 'Add New Launcher' from the menu.
2. When the 'Create launcher applet' dialog opens, enter:
'Omnis Studio' as the name
'Omnis Studio' as the comment
[Installation Path]/omnisI386 as the command
3. Click the 'Icon' button and select [Installation Path]/studio.png
4. Click OK
5. Click the new applet icon from the Gnome taskbar to launch Omnis.

1.4.5 Installing Omnis Web Client under Linux. 

Copy the omweb.taz file to your Netscape home folder. At the command line type: 
tar -xzvf omweb.taz 
This will create an omnis folder at the same level as the plugins folder on your system and place files in both of these folders. The script also creates some symbolic links that are required to enable the use of the web client. 


2. Serializing Omnis Studio.
============================

When you first run Omnis Studio, you are prompted for your Name, Company name, and Serial number. Please enter your details, including the serial number that you purchased from the Omnis store or that came with your Omnis Studio CD. 


3. Evaluating Omnis Studio.
===========================

If you are evaluating Omnis, you should leave the Name, Company name, and Serial number fields blank and click on OK. This creates an evaluation version of Omnis which gives you access to the full Omnis development environment and GUI tools, but it has the following minor technical limitations.

-a maximum of 150 records can be inserted into a table in a data file. 
-reports are limited to 2 pages. 
-you cannot access any remote server databases using the Omnis DAMs; you can however use OmnisSQL to access an Omnis datafile.
-the serial number dialog appears each time you start Omnis: to continue evaluating Omnis, leave the fields blank and click OK each time you run Omnis.
  
Note that it is only the Development version of Omnis Studio that will work without a serial number, as described above. To evaluate the Runtime and Server versions of Omnis Studio, you need to contact your local sales representative to obtain the appropriate serial numbers. 


4. Installation Support.
========================
If you are having problems installing Omnis, we provide email only installation support during the first 30 days. Please email us at: 

US: us_install_support@omnis.net
Rest of the World: install_support@omnis.net


[END OF FILE]