======================================================================= Netscape LiveWire Public Beta (IRIX 5.3.6.2) ======================================================================= Netscape LiveWire is subject to the terms detailed in the license agreement accompanying it. ******************************************************** IMPORTANT! This is beta software. Do not install it on a production server and be sure to make backups of any HTML documents you use. ******************************************************** CONTENTS ======== - Installation Instructions - Documentation Information - Database Installation and Configuration Information * Supported databases: Informix, Oracle - How to create the sample (video) database Installation ============ If you do not already have a Netscape Enterprise or FastTrack server (version 2.0), you must download and install it FIRST. NOTE: There is no Site Manager or Navigator Gold for IRIX in this release. However, you can use the LiveWire compiler and server extension. Instructions ------------ 1. Stop your Netscape server before you install LiveWire. 2. Follow the instructions below to install LiveWire. 3. After you install LiveWire, restart your Netscape server. In the server administration tool, click the On/Off switch twice. 3a. Enable LiveWire in your server administration tool as follows: - Click the "Programs" button in the top navigaton bar. - Click "LiveWire" in the left frame - When you see the prompt "Activate the LiveWire application environment?" choose "Yes". - Choose OK - Choose Save and Apply 4. If you are in the Developer Partners Prorgram, and you want to create database applications, install database software (see instructions below). LiveWire Installation Instructions ================================== 1. From the FTP site, download the file livewire_sgi200.tar.Z 1a. Uncompress this file by entering the command uncompress livewire_sgi200.tar.Z Un-tar this file by entering the command tar xvf livewire_sgi200.tar This will create installation files, including the installation script. 2. Enter the command setup This will run the LiveWire installation script. You will be prompted to enter the server directory. Enter your server's root directory (i.e. the directory where your server is installed). 3. Restart your Netscape server. 4. Now you can run Navigator and load http:///appmgr to run the application manager. Note ---- If you want to be able to run the LiveWire compiler from any directory, add /livewire/bin to your PATH environment variable. Documentation ============= Documentation is provided online in HTML format in the livewire/doc directory. Use your Navigator to load the index.html file that provides links to all the documentation, including release notes. Informix Database Installation ============================== You only need to install the database software if you want to create database applications. There are two parts that you must install: the server and the client. You must install the client on the machine running LiveWire. You may install the server on the same machine or a different machine. If you are a member of the Netscape Developer Partners program, you can download Informix software for use with LiveWire at the Netscape developer site, http://developer.netscape.com/private. Instructions ------------ Note: The first four steps below will normally require assistance from your system administrator. About 40MB of disk space space is required to install Informix. In addition, the following script assumes your system is configured for at least 8MB of shared memory. This may be reduced, but a change is required from the defaults provided below (please see Informix System Administration Manual). 1. Your kernel should be configured for the recommended parameters. Check your system configuration file (/var/sysgen/stune) shmmax = 16777216 semmni = 4096 semmns = 4096 semmnu = 4096 semume = 64 shmmni = 100 sshmseg = 100 If not, have your system administrator regenerate the IRIX kernel and reboot the machine. 2. Add the following entry to /etc/services: online 1535/tcp # Informix Online 7.10 If an other entry uses the number 1535, change the number used by online to an unused number. 3. Create an informix group (/etc/group). The suggested group id is 2002, which is what the tar file uses. If you do not use this group id, you will have to change some file ownerships. 4. Create a user informix (/etc/passwd) with group informix. The suggested userid is 2002. Make the C shell the default shell for this user. This operation should also include the creation of the informix home directory (such as /usr/informix). 5. Login as user "root" and execute the following steps: (a) Set the INFORMIXDIR environment variable to the Informix home directory: C shell: setenv INFORMIXDIR /usr/informix Bourne shell: INFORMIXDIR=/usr/informix;export INFORMIXDIR (b) Go to the informix home directory cd $INFORMIXDIR (c) zcat online_irix53.tar.Z | tar xvf - (e) rm online_irix53.tar.Z (f) execute installonline (./intallonline) use the serial number: AAB#J434402 and the key : KISGJC 6. Login as user "informix" execute the following steps: (a) Create or modify .cshrc to include: setenv INFORMIXDIR /usr/informix (as explained above) setenv INFORMIXSERVER on_test (or a name of your choice) set path=($path $INFORMIXDIR/bin) (b) Make sure these values are set in your environment: source .cshrc (c) Run the following commands : mkdir dbs touch dbs/rootdbs chmod 664 dbs/rootdbs (d) cd to the INFORMIXDIR/etc directory, copy onconfig.std to onconfig and modify the onconfig file as follows: ROOTPATH: full path of the dbs/rootdbs file, e.g. /usr/informix/dbs/rootdbs ROOTSIZE: space for databases in KB (at least 20000) MSGPATH : fullpath of a file in INFORMIXDIR that will contain server messages, e.g. /usr/informix/online.log DBSERVERNAME: value of INFORMIXSERVER (e.g. on_test) (e) Modify the sqlhosts file to add an entry with the values: onsoctcp online where INFORMIXSERVER is the value chosen above and is the name of your machine. You can obtain this by typing "uname -n" at the IRIX prompt, e.g. uname -n bigserver on_test onsoctcp bigserver online (f) Then enter the command: oninit -iy This will bring up the Informix Online Server and initialize disk space. To bring down the Informix Online Server enter: onmode - ky Then type the following to confirm that the status is online : onstat - To start up the Informix Online Server subsequently type: oninit Please consult the Informix documentation for further tuning of the Informix Online Server. Creating the Sample Database ---------------------------- Before you can run the video sample application, you must create the database used by the application. The scripts and files neccessary for this are installed to the livewire/samples/video directory when you install LiveWire. To run the script: * For Informix, enter the command create_ifmx_db.csh This will create a database called lwdemo * For Sybase, enter the command create_sybs_db.csh For example, create_sybs_db.csh sa sa1234 This will create tables in the master (default) database.