Wiki

Case Status
Log In

Wiki

 
Installing OASIS on Linux
  • RSS Feed

Last modified on 7/15/2014 4:34 PM by User.

Tags:

Installing OASIS on Linux

Overview

If using Linux, we do recommend a solid understanding of Linux. Although Linux has become quite user friendly over the years, one must still understand the unix command line and other basic environment.

This document is provided as a quick reference.

BEFORE YOU BEGIN!

Know where your home directory is located - especially from the command line and from any web browser used to download software.

The screen shots show here are from an older installation of RedHat Linux. The screens may vary in look, but the functionality is identical:

Support Details

Our staff is trained to support OASIS. The support of the operating system is simply beyond our abilities - even with more popular operating systems. To be direct, the information shown here is using a version of RedHat Linux - different Linux versions will look very different based on which window manager is used and how the software is configured.

Although we try to make OASIS as open an usable on as many different operating systems as possible, it is NOT possible for us to test OASIS on all operating system configurations. For this reason, we can not guarantee a given version or configuration of Linux will be able to properly run OASIS. We will try to resolve any issues, but we can not guarantee success.

Installing a JVM

The JVM (Java) that is installed with most Linux variants is typically not capable of running OASIS. Ingen Software only support OASIS running on a Sun Micro-systems JVM available at the link below. OASIS 2.7 was designed to work with Java 1.6 or later:

  http://www.javasoft.com/ 

(Although the website changes from time to time, select the Java SE link on the right side of the screen and look for download links: Java SE Runtime Environment.)

This document shows installing a .bin file (not an rpm.bin).

Once the JVM installer is downloaded, start a command window (shell) and ensure the .bin file is in your home directory (use the ls command). Then key

  sh ./jvm_installer_name.bin

Once complete, a new directory will be created containing the JVM. Some users may wish to move this directory to /usr/local (or other common installation directory). This is not required, but what is required is knowing the path to the JVM for OASIS.

Before running the JVM, your command search path must be updated with the location of the JVM. The commands shown below may need to be adjusted for your computer - namely the directory name of the JVM you downloaded:

Running the OASIS Installer

Once the JVM has been installed and the path to the JVM has been established, key the following command (may need to change based on the actual name of the OASIS installer you download):

  sh ./install_W320C1.bin

The OASIS installer is a GUI! However, if the JVM is not setup properly or if the command path is not setup to find the JVM, and error will display.

Just follow the instructions in the installer. Please note that one computer will need to run the database service - use the Server install on the database "server". All other computers (Linux or other operating system) just need the Workstation install:

Once complete - continue to setting up the database server below.

Starting ASA on Linux

System administrators, might just add the "startdb" command to the runtime startup scripts (the file is located in the OASIS installation directory).

However all users are able to start the database using the ASA Configure tool

For our version of Linux, the short-cuts (soft links) used to start OASIS are created in the user's home directory (they may be moved to the desktop if needed). Located "ASA Configuration" in the "Database" Directory:

Once the ASA Configuration window shows, select "Start Server":

If you receive this error, there is a good chance the OASIS database is already running on the server or network somewhere else:

On success, the text "Database started." will show:

Once the database is started, the user may logout of the server and the database will continue to run. However, if the server is restarted, the user will need to login to the server and follow the steps above to restart the database.

Starting OASIS!

In our version of Linux, the startup icons for OASIS are created in the user's home directory.

Look for and double click on the icon "runOASIS". This will show the database window the first time you login.

You will need to setup a connection to the database server, but first you will need to find the server's name. To do this, type "hostname" (all one word) in a command shell and press <ENTER> - do this on the server as hostname shows the name of the computer the command is run on. (Additionally, you could use ping or ifconfig to show the server's IP address.)

The "Kind" will always be "Sybase" for Linux. Key the server name as found from hostname. The port will always be 2638 and the user/password will always be "oasis":

First, you will be asked if is Ok to create the OASIS tables (press Yes):

This should only take a couple of minutes:

Then you will see the OASIS login screen:

Just key "Demo" (no password). Next you will see the OASIS license viewer:

Press the "Add" button and select the license file sent to you by Ingen Software (the license file typically has a file extension of .lic). Never change the license to or DBID unless instructed to make the changes by someone at Ingen Software (this will invalidate the license file):

Startup will begin by downloading any updates from our servers (this may take up to 10 minutes - depending upon your Internet connection and how busy our servers are):

Press "Yes" on the next screen to activate the updates to OASIS:

After which, you may need to restart OASIS by double clicking on the runOASIS icon again. You will likely see the "OASIS Update" screen again - but it will go a lot faster as the OASIS update is now stored in your OASIS database.

Key the user of "Demo" with no password, then you will see the OASIS home application. From here, OASIS will work as it does on all operating systems!

Backups!

The database is stored in the asa folder in the OASIS installation folder (typically named OASIS27). The database will automatically make a copy of itself to a new folder in the OASIS installation folder named "oasis_backup". It is strongly recommended that a copy of the backup folder be copied to an external drive (e.g. a USB attached drive or another server).

Just think: what if all that data in OASIS suddenly went missing?!!

Although the OASIS database is very rugged and has many recovery options. However, database recovery isn't an option if there are no files to recover from!