Installing LightWave Server

These instructions apply to new installations. See Updating LightWave Server for instructions for updating an existing installation to a new release version. Note that you may install the product more than once (in separate subvolumes) on the same NonStop system if you wish.

Before proceeding with the installation process refer to the Release Notes for important information about the current release of the software, particularly the Installation Prerequisites.

The software is delivered in a single PAK archive containing the following files:

SERVER - The LightWave Server process
SWORKER - The LightWave Server Worker process
LWSCOM - The LightWave Server Management CLI
ICUDATA - Character set translation data.
SCPnnnnn - The console installation package, where nnnnn is a version number
ZSTARTUP - Sample SERVER process startup macro
SUTILITY - The LightWave Server Utility process

SUTILITY has been deprecated and will no longer be updated. LWSCOM has replaced SUTILITY as the LightWave Server management CLI.

Overview of Installation

The process is performed from a TACL prompt. These are the steps:

Obtain a Product License

A license is required to run LightWave Server. If this is the first time you are installing the product on your NonStop system, you may obtain a free 30-day trial license at the Trial License Center. Otherwise, a license will be provided to you upon purchase of the product. Do not request a trial license until you are ready to begin using the product, as the 30-day timer starts on the day the license is issued. Note that you may install LightWave Server without a license, however the product will not function until a valid license is installed.

Download the Release Package

The software is distributed as a single PAK archive file. The software may be downloaded from our Software Download Center. Transfer the PAK file to your NonStop system using binary transfer mode.

Install the Release Package

Unpak the release package PAK archive file into an empty subvolume.

CODE

> UNPAK <pakfile> ($*.*.*), vol <installation-subvolume>, myid, listall

where <pakfile> is the name of the release package PAK archive file you transferred earlier.

Create a Filesystem

LightWave Server stores its operational data in a filesystem consisting of a collection of files. A filesystem is created using the LWSCOM application as follows:

CODE

> run LWSCOM create filesystem <filesystem-subvolume>, password <admin-user-password>

where <filesystem-subvolume> is the name of a subvolume on a TMF-audited disk. The filesystem may be created in the same subvolume as the program files (the 'installation subvolume'), or a separate subvolume. The <admin-user-password> parameter specifies the password for the default "admin" user.

Optionally Install the Console Package

The LightWave Server Console provides a browser based management interface to LightWave Server. Although the Console provides a convenient management interface, its use in some deployment scenarios may not be appropriate. When the Console is not installed, all management must be done using the LWSCOM program. In order to use the Console, install the console package as follows:

CODE

> run LWSCOM control filesystem <filesystem-subvolume>, installcon <console-package-file>

where <filesystem-subvolume> is the name of a subvolume containing an existing LightWave Server filesystem. The <console-package-file> parameter specifies the the console package file included with the release in the form SCPnnnnn.

Install the Product License

Transfer the license file you received by email to your NonStop system using text or 'ascii' file transfer mode. The license must be stored in an 'edit' file in one of the following locations:

the file LICENSE in the LightWave Server installation subvolume

the file LICLWS in the LightWave Server installation subvolume

the file $SYSTEM.NUWAVE.LICLWS

The LightWave Server SERVER process validates the license at startup and periodically while running. Any license errors will be written to the event log. Note that if the license file content is altered in any way, the license will become invalid. For more information see Product Licensing.

Start the Server Process

The LightWave Server SERVER process supports the user interface for the product. Refer to Starting LightWave Server for further instructions.

Once the SERVER process is running, open your browser to http://system-name:port-number, where system-name is your NonStop system name or IP address and port-number is the TCP/IP port number you used when starting the SERVER process. Login to the LightWave Server Console application using the username 'admin' and the password 'password' (or the new password you specified when you created the filesystem).