These instructions apply to new installations. See Updating LightWave Client 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:
- CONSOLE- The LightWave Client Console process.
- CLIENT - The LightWave Client CLIENT process.
- CUTILITY - The LightWave Client Utility process.
- ICUDATA - Character set translation data.
- CCPnnnnn - The console installation package (where nnnnn is a version number)
- CAROOT - A bundle of root certificate authority certificates
- RWORDS - A list of C and COBOL reserved words that are installed for use by the DDL generator.
- ZLOGOPTS - Sample logging options file
- ZSTARTPW - Sample CLIENT process Pathway configuration startup macro
- ZSTARTUP - Sample CONSOLE 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 Console 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 Client stores its operational data in a filesystem consisting of a collection of files. A filesystem is created using the CUTILITY 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 Client 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 CUTILITY.
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 Client. 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 Client 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 Client installation subvolume
- the file LICLWC in the LightWave Client installation subvolume
- the file $SYSTEM.NUWAVE.LICLWC
The LightWave Client CLIENT 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 Console Process
The LightWave Client Console process supports the user interface for the product. Refer to Starting the Console Process for further instructions.
Once the Console 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 Console process. Login to the LightWave Client Console application using the username 'admin' and the password 'password' (or the new password you specified when you created the filesystem).