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.
The software is delivered in a single PAK archive containing the following files:
- SERVER - The LightWave Server process
- SWORKER - The LightWave Server Worker process
- SUTILITY - The LightWave Server Utility process
- ICUDATA - Character set translation data.
- SCPnnnnn - The console installation package, where nnnnn is a version number
- ZSTARTUP - Sample SERVER process startup macro
Overview of Installation
The process is performed from a TACL prompt. These are the steps:
Download the release package
- Install the release package
- Create a filesystem
Obtain a product license
- Install the product license
- Start the Server process
Step 1. 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.
Step 2. Install the Release Package
Unpak the release package PAK archive file into an empty subvolume.
where <pakfile> is the name of the release package PAK archive file you transferred earlier.
Step 3. Create a Filesystem
LightWave Server stores its operational data in a filesystem consisting of a collection of files. A filesystem is created using the SUTILITY application as follows:
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. If you specify '*' for filesystem-subvolume, the current subvolume is assumed.
The filesystem contains a list of users allowed to access the LightWave Server Console user interface. Upon initial creation, the user list contains a single user, 'admin', with a default password, 'password'. It is recommended that you change the default password immediately. Record the password in a safe place. However, you can reset the password at any time using SUTILITY.
where <new-password> is the new password. If the filesystem is not located in the current subvolume, you must append the --filesystem <filesystem-subvolume> command-line option.
Step 4. 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.
Step 5. 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.
Step 6. 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).