Installation Guide

Overview

This guide provides information and instructions for downloading and installing Sablime on UNIX* or Linux*. The guide is intended for first-time installations. If you already have Sablime and are upgrading to the current version, see the Upgrade Guide.

There are three types of installations covered by this document:

The three types follow the same process except where specifically noted.

Technical Notes The Sablime software and the installation process are intended for use with the Korn shell (ksh).
The installation process and Sablime itself use perl (version 5.004_01 or later). The installation process uses gunzip to uncompress the downloaded file. These, as well as tar, sed, strings, and uname must be in the installer’s $PATH.
Note for Linux users: The shell variables $SHELL and $EXECSHELL must both be set to the location of ksh (normally /bin/ksh) and exported. $PWD must also be exported: pdksh, which is usually what /bin/ksh points to, does not export $PWD by default.

Download

Download the appropriate file (sab83_architecture.gz) from the Sablime v8.3 download page. Also download the installation script sablime_install.

If you did not download it there directly, move or copy the file(s) to your UNIX or Linux Sablime host machine.

Install

Log into the Sablime host as the user ID that will own the Sablime binaries and databases. You should not install Sablime as the “root” user.

Create a directory to be the location of the Sablime binaries. We’ll refer to this as SABHOME:

$mkdir SABHOME # for example: mkdir /usr/sablime/bin

Move the downloaded files into SABHOME:

$mv sab83_architecture.gz sablime_install SABHOME

Run the installation script:

$cd SABHOME
$./sablime_install -newbin $PWD

or

$cd SABHOME
$./sablime_install -newbin -master=DIR $PWD

The second version is for NFS clients only (that is, clients sharing the databases of the primary installation via NFS, but not sharing its binaries). DIR should be the path to the binaries of the primary installation. Note that the NFS clients must have DIR mounted, even though we will be installing a separate copy of the binaries into SABHOME.

sablime_install can be restarted if it is interrupted. It will announce it is ready to restart, and verify the installation location with you before proceeding to complete the interrupted installation.

At this point, the full set of Sablime files have been placed onto your machine. You can view the full set of Sablime documenation, or review the Sablime Administrator or User Training materials without needing to complete the installation (yet).

If you have a web server that can access the files on this machine, or if you have a browser that can browse local files, you can point the browser to SABHOME/web/docs/documentation.html to find an index of the available Sablime documentation. You could also copy that directory's contents to another machine if necessary to make it browsable.

License

To get an evaluation license for Sablime, run the admin_license script to generate the request file. Update the file as instructed and email it to the business office at software@alcatel-lucent.com.:

$ksh SABHOME/admin_license

(edit the file)

$cat request.txt | mail software@alcatel-lucent.com

If you’ve purchased a license or requested an evaluation license, the business office will email you the license file. Save the contents to a file named .usrid in SABHOME (note that the file name starts with a “.”).

The physical installation of the software is now complete.

Next Steps

Net_products File Format

The net_products file tells Sablime where to find the databases and executables for products that are not accessible on the local machine. The file should be placed in the config subdirectory of the directory containing the local Sablime binaries (SABHOME).

The following is a sample net_products file, with callouts describing the (semi-colon separated) fields. The file may have multiple lines.

Net Products file format graphic

*  UNIX is a registered trademark of The Open Group.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
NFS and Solaris are trademarks or registered trademarks of Oracle and/or its affiliates in the United States and other countries.

Sablime is a registered trademark of Alcatel-Lucent Inc.
Contents copyright © 2010-2015 Alcatel-Lucent. Permission to photocopy in support of a licensed installation of Sablime is hereby granted.