Island Software Installation and License Administration Guide

Island Software Installation and License Administration Guide

 

Contents

A. About the IOFFICE environment variable

B. System Requirements

C. Installing from the Island Productivity Series 6.0 CD

D. About temporary passwords

E. How to request a permanent password

F. Installing Passwords with AddPassword

G. About the Island license management utilities

H. iladmin: the Island license administration script

I. Using the FLEXlm utilities directly

J. Island license file description

K. Starting the Island license manager at boot time

L. How to start Island applications

M. Troubleshooting end-user licensing problems

N. How to contact Island Software Support and Licensing

 

 

A. About the IOFFICE environment variable

In this document, $IOFFICE denotes the absolute path of the Island Office 6.0 installation directory.

Older versions of Island products (pre-5.0) required users to set the IOFFICE environment variable.  Setting IOFFICE is now optional as long as the applications are invoked via the startup scripts in $IOFFICE/bin.  If you are upgrading, check your environment to make sure the IOFFICE variable is not set to an old Island installation directory.  You can check your IOFFICE setting with the following command:
 
        % echo $IOFFICE
 
Here is an example of how you can set IOFFICE if the Island Software products are installed in /usr/local/ioffice6. 

   

 

B. System Requirements

 
Swap Space: 40 MB minimum
 
Disk Space:

Following are approximate product sizes after installation.

 

Product      Version  Solaris 2     Sun 4   HPUX 10   AIX 4.1

-------      -------  ---------     -----   -------   -------

IslandWrite      6.0    11.5 MB    7.8 MB    8.5 MB    6.6 MB

IslandTable      1.1     5.2 MB    4.3 MB    4.9 MB    2.7 MB

IslandEquation   1.1     3.9 MB    2.9 MB    3.3 MB    1.4 MB

IslandDraw       4.1     6.2 MB    5.4 MB    6.0 MB    3.7 MB

IslandPaint      4.1     7.5 MB    6.1 MB    6.7 MB    4.3 MB

IslandPresents   1.2    21.7 MB   19.9 MB   21.0 MB   16.5 MB

IslandChart      1.1     6.7 MB    5.8 MB    6.3 MB    4.3 MB

IslandCalc       3.1     6.1 MB    4.9 MB    5.2 MB    2.9 MB

IslandSound      1.1     2.9 MB    2.0 MB    2.7 MB     N/A

IslandInTEXT     2.0    28.4 MB   24.7 MB   30.3 MB   23.1 MB

IslandBuild      1.0    24.3 MB   25.8 MB   26.6 MB   22.2 MB

 

Total                  138.4 MB  123.6 MB  135.5 MB  101.7 MB
Note: Total includes 14 MB for base files, which are extracted once in every Island installation.
 
 

 

C. Installing from the Island Productivity Series 6.0 CD

1) Login as superuser on the machine where you wish to install    the Island applications.
 
        % su root
        Password:

Note: All Island products except for IslandInTEXT may be successfully installed by regular users.  But, root access is usually required in order to use the mount command.

2) Insert the CD into the CD-ROM drive.

3) Create the mount point.
 
       This guide assumes a CD-ROM mount point called /cdrom
 
4) Mount the CD-ROM drive.
 
   Solaris:     Automatically mounted through Solaris Volume Manager.
                   The mount point should be: /cdrom/iof600
 

 5) Change to the CD-ROM directory. 6) Run the installation script. Note: The installation script must be run in the CD mount directory from step 6.

 
7) Follow the instructions given by the installation script. Please take note of the following:
 

 
8) Unmount the /cdrom directory.
 
        # cd /
        # umount /cdrom
 
   Note: Trying to unmount /cdrom while in the /cdrom directory will result in a "device busy" error.
 



 

D. About temporary passwords

Island Productivity Series 6.0 CDs are shipped with a temporary password.  The temporary passwords give users immediate access to the entire suite of Island products, regardless of which products were actually purchased.  In the case of product evaluations, the temporary password expiration date is determined by the salesperson.  Temporary passwords are meant to cover the time period required to process your request for a permanent password.  After Island Licensing receives your request, you will be issued a permanent password only for products which have been purchased.  If you want to purchase licenses for additional products, you must contact an Island Software Salesperson or an Island Software Reseller.
 
 

 

E. How to request a permanent password

To receive a permanent password, complete a copy of the form below and send it via email to license@islandsoft.com, or FAX it to (916) 454 3792.  Note: If you are reading this in hardcopy, an electronic version of this document is located in $IOFFICE/README.
 
Contact Name:
Company Name:
Company Address:
City/State:
Country/Postal Code:
Phone/Fax:
E-Mail Address:
 
Reseller Name/Location:
(if applicable)
 
Island Product(s):
Version:
Platform:
Product Serial Number(s):
Number of Licenses (RTUs):
Type of License: Network (Floating):     Node (Fixed):
Language (default is English):
Unique Host ID:
 
 

To find the unique Host ID, execute the following command:
 
        % $IOFFICE/bin/lmhostid
 
IMPORTANT NOTE: Send your current Island license file with your password request(s) when you are:
 

 
Please indicate what action you are taking: transferring, adding or upgrading Island products.  The license file is typically called netlicense.dat, located in the $IOFFICE/licenses directory.

 



 

F. How to install passwords with AddPassword

To generate a license file, you must use a supplied temporary password (or key), or obtain a permanent password from Island's licensing department.  Passwords may be entered during installation or afterwards with the AddPassword script located in the $IOFFICE/bin.

AddPassword asks you to enter some information it needs in order to generate your license file, typically called netlicense.dat. AddPassword must be run once for each password issued.  Each time AddPassword is run, it appends new information from the password to the specified license file.  Note that existing product FEATURE lines in the netlicense.dat file will be replaced by any matching products encrypted in the password.
 
AddPassword can be invoked via iladmin (Island License Administration script) menu, or directly:
 
        # $IOFFICE/bin/AddPassword
 
Note: We suggest using AddPassword via the iladmin script.
 
1) Make a backup of your existing netlicense.dat file.

If new license information is being added to an existing license file, we recommend that you make a backup copy of the netlicense.dat just in case something goes wrong during password entry.
2) At this point, AddPassword will specify the file it will add licenses  to.
  Note: AddPassword cannot add to license files containing INCREMENT lines.  In this case, create a new license file, then merge the DAEMON and FEATURE lines into the target license file.
 
3) Product Serial Number:  As of IPS 6.0, the Product Serial Number has been elminated. You can either just  enter 'none' at this prompt, or if you have a Support number, you can input that.
 
4) License type (net/node):  Enter 'net' if you requested a network or floating license.  5) HostName:  Enter the hostname of the license host.  If you are running  AddPassword on the license host, then you can accept the default.
 
6) Unique ID:  Enter the hostid of the license host.  The hostid is determined via the $IOFFICE/bin/lmhostid command.
 
7) Island Password:  Enter the password

 

 

G. About the Island license management utilities

Island Software uses FLEXlm v2.4 for licensing its products.  Many other commercial products on UNIX also use FLEXlm.
 
Following is a list of the FLEXlm utilities provided with the Island distribution located in the $IOFFICE/bin directory:
 
        lmgrd  - the license manager daemon
        lmdown - used to shut down the license manager and vendor daemon
        lmstat - used to query the license manager for current status and license usage.
        lmhostid - returns the unique ID of the current host

Island Productivity Series 6.0 comes with a license administration script called iladmin, which simplifies the use of the FLEXlm license utilities.
 



 

H. iladmin: the Island license administration script

iladmin is a wrapper script for the FLEXlm license utilities.  iladmin allows essential license administration tasks to be performed easily without requiring extensive knowledge of the FLEXlm utilities and their operation.

iladmin is located in the $IOFFICE/bin.  This script can be started with an argument to have it perform a specific function, or in an interactive menu-driven mode.
 
     # iladmin help
     Usage: iladmin [start|stop|status|users|lic|log|id|debug|help]
 
     Options:
          start  - start the license manager
          stop   - stop the license manager
          status - query the license manager for status
          users  - query the license manager for current users
          lic    - view the license file
          log    - view the license manager log file
          id     - report the unique ID for the current host
          pw     - add password to license file via AddPassword
          debug  - print iladmin variable settings
          help   - print this help listing
 
To run iladmin in interactive mode just invoke the command with no arguments, and the following menu will appear.
 
     # iladmin
 
     Island License Administration Menu
 
       (1) Start license manager
       (2) Shut down license manager
       (3) Get license manager status
       (4) Get current license users
       (5) View license file
       (6) View license manager log file
       (7) Get unique id of local host
       (8) Add password to license file
       (9) View license administration guide
       (q) Quit
 
  The menu options are self-explanatory, but here are some tips to help you use this script more effectively.
 

Following are descriptions of the iladmin options:
 
1) Start license manager  
2) Shut down license manager 3) Get license manager status 4) Get current license users 5) View license file 6) View license manager log file 7) Get the FLEXlm hostid  8) Add password to license file Note: Before invoking AddPassword, iladmin unsets the LM_LICENSE_FILE environment variable to avoid conflicts with other FLEXlm license files used by other vendors' products.

9) View license administration guide

 

 

I. Using the FLEXlm utilities directly

This is a quick guide on how to use the FLEXlm licensing utilities shipped in the Island Software distribution.  For most cases, we recommend the use of the Island License Administration script, iladmin, to perform such license administration tasks.  For more information, see the the section "iladmin: the Island license administration script".
 
To start the license manager (lmgrd), you will need a license file. Also, make sure you are on the license host before you attempt to run lmgrd.
 

Note: The following commands must be typed on a single line. Also, make sure that root has permissions to write to the $IOFFICE/licenses directory.  Otherwise, the lmgrd output will have to be redirected elsewhere.
 
In Bourne Shell (sh):
     # $IOFFICE/bin/lmgrd -c $IOFFICE/licenses/netlicense.dat > $IOFFICE/licenses/license.log 2>&1 &
 
 
In C Shell:
     # $IOFFICE/bin/lmgrd -c $IOFFICE/licenses/netlicense.dat >& $IOFFICE/licenses/license.log &
 
The $IOFFICE/bin/license.log will contain information as to whether the license manager started correctly.  As users start and exit licensed applications, license usage information will appear in this log file.
 
In addition, you can use the following command to query the license manager for information on available licenses.
 
     # $IOFFICE/bin/lmstat -c $IOFFICE/licenses/netlicense.dat -a
 
If you need to shut down the license manager:
 
     # $IOFFICE/bin/lmdown -c $IOFFICE/licenses/netlicense.dat
 

 

J. Island license file description

  The license manager daemon, lmgrd, reads a license file when started.  Island license files are created with the AddPassword program.  For more information, See the section on 'Installing Passwords with AddPassword'.

  The license file contains information about licensed products and how many concurrent sessions to allow for each.  By default, Island applications look for a license file called netlicense.dat located in your $IOFFICE/licenses directory.  The default license file location may be overridden by setting the LM_LICENSE_FILE environment variable to the absolute path of your FLEXlm license file.  For sites running multiple FLEXlm license managers, LM_LICENSE_FILE may be set to a colon separated list of FLEXlm license files.
 
Following is a sample netlicense.dat:
 
SERVER meletios 080009C559F2 1701
DAEMON islandLIC /usr/local/ioffice6/hp/bin/bin.HP/islandLIC
FEATURE islandwrite6 islandLIC 6.000 1-jan-0 1 3C824AE4AADBAD206628 "E:"
FEATURE islandpaint4 islandLIC 4.000 1-jan-0 1 5C522A3496D8AE068D37 "E:"
FEATURE islanddraw4 islandLIC 4.000 1-jan-0 1 FC12AA14E193503D822F "E:"
 

  Island Software's FLEXlm license file is composed of SERVER, DAEMON and FEATURE lines.  Following is a description of each.

  SERVER lines describe designated license server hosts and communication ports.  The port setting may be edited if another process already uses the port specified in the license file.
 
     SERVER <hostname> <hostid> <port>
 
At start up, Island applications connect to the license manager by reading the license file's SERVER line.
 

  DAEMON lines describe vendor daemon(s) for lmgrd to invoke upon startup.  Island products utilize a vendor daemon called islandLIC, which keeps track of licenses for all Island products.  Other products licensed with FLEXlm come with their own vendor daemons.  This approach allows lmgrd to manage multiple license sets from various vendors with different FLEXlm implementations.
 
    DAEMON <vendor daemon name> <absolute path of daemon>
 

  FEATURE lines define product codes and the number of licenses to serve for each product.
 
    FEATURE <product code> <daemon name> <version> <expiration> <number of licenses> <encrypted key> <language string> [hostid]

  An expiration field of "1-jan-0" denotes a permanent license, as in the example license file above.

Note: Only FEATURE lines for node-locked licenses will contain the hostid of the designated license host.
 
 



 

K. Starting the Island license manager at boot time

If a license manager host is rebooted, the Island license manager must be restarted in order for products to come up licensed.  Starting the license manager may be done by hand after booting the machine, or done during boot time automatically.   Various UNIX platforms have different mechanisms for starting processes during the boot cycle.  Following are instructions for starting the Island license manager at boot time.  All of the steps below should be performed by the system administrator as root or superuser.
 

Solaris 2.x

For Solaris 2.x, use the islandlm boot script provided in the $IOFFICE/docs directory.
 
1) Copy the islandlm boot script to the /etc/init.d directory    (First, make sure that such a script doesn't already exist...) 2) Modify the ioffice_dir variable setting in the copied islandlm script to point to your Island Software distribution directory, e.g. 3) Make the script executable: 4) Create links in the system /etc/rc3.d directory to allow for automated starting and stopping of the license daemons upon boot and shutdown.  Note that we are creating hard links here! After setting up the islandlm script, you can test it out by using the following commands. SunOS 4.1.x

For SunOS 4.1.x, execute iladmin from your rc.boot or rc.local to start the license manager.
 
1) Edit the /etc/rc.boot or /etc/rc.local file.  Add the line to    the end of the file to insure the partition containing $IOFFICE is available.

2) (Optional) Edit the /etc/services file to reserve the port used by the license manager.  By default, the netlicense.dat will contain 1701 as the port number which the license manager will listen on. Verify the port specification in your netlicense.dat file (in $IOFFICE/licenses) by checking the last number on the SERVER line, e.g.

                 SERVER meletios 080009C559F2 1701

         To reserve port 1701, add the following line to the end of /etc/services.

                 license 1701 /tcp
 
Note: The license manager never looks at /etc/services.  Adding this entry just insures that this port will not be given to another network process via a system call requesting a port.  If the network is running NIS (Network Information Service), then the above line must be added on the NIS master, and the services map must be propagated to the rest of the network.
 

HPUX 10.x

For HPUX 10.x, use the islandlm boot script provided in the ioffice6/docs directory.
 
1) Copy the islandlm boot script to the /sbin/init.d directory 2) Modify the ioffice_dir variable setting in the copied islandlm script to point to your Island Software distribution directory, e.g. 3) Make the islandlm script executable: 4) Copy the islandlm.defs defaults file to /etc/rc.config.d from the ioffice6/docs directory. 5) Create links in the system /sbin/rc3.d directory to allow for automated starting and stopping of the license daemons upon boot and shutdown.  Note that we are creating hard links here! After setting up the islandlm script, you can test it out by using the following commands.

AIX 4.1

For AIX 4.1 systems, add a call to the iladmin script in the /etc/inittab file to start the license manager.

  1) Edit the /etc/inittab file.  Add the following line at the end of the file.

Note: replace /path_to/ioffice6 with the path to your Island Software distribution.

  2) (Optional) Edit the /etc/services file to reserve the port used by the license manager.  By default, the netlicense.dat will contain 1701 as the port number which the license manager will listen on. Verify the port specification in your netlicense.dat file (in $IOFFICE/licenses) by checking the last number on the SERVER line, e.g.
 

Note: The license manager never looks at /etc/services.  Adding this entry just insures that this port will not be given to another network process via a system call requesting a port.  If the network is running NIS (Network Information Service), then the above line must be added on the NIS master, and the services map must be propagated to the rest of the network.

 
 


L. How to start Island applications

After your Island Software products are installed, put the $IOFFICE/bin in your path and execute one of the following startup scripts.
 
        IslandWrite
        IslandDraw
        IslandPaint
        IslandTable
        IslandEquation
        IslandPresents
        IslandSound
        IslandChart
        IslandCalc
        IslandWrite -build (for IslandBuild)
        IslandInTEXT
 
If the products have problems getting a license, output operations such as saving and printing will be disabled.  For more information, see "Troubleshooting end-user licensing problems".
 
Running IslandInTEXT:
 
1) A statusiq daemon must be running before attempting to run the InTEXT application.  The daemon must be started by root on the server to which you connect.  This also applies if you're running InTEXT on the console or a stand-alone machine.  This is the process which requires an IslandInTEXT license, and must run on each host IslandInTEXT is to be invoked on.
 
The following procedure explains how to start the statusiq daemon. Alternatively, set the daemon to automatically run on system startup.
 
2) Do not run the IslandInTEXT script in the background.  The indexing functions of this product which write to stdout and read from stdin will fail, causing InTEXT to freeze. 3) The FULL PATH must be specified the first time the IslandInTEXT script is run.  The path is used to initialize items in the intextrc file.  The initialization part of the script does not handle relative pathnames.  Subsequent invocations of the script can use a relative path to the IslandInTEXT script.
 
For more information, see the IslandInTEXT manual.
 
 
Running IslandBuild:
 
IslandBuild is an IslandWrite extension for building custom macros and forms.  IslandBuild is invoked via IslandWrite.
 



 

M. Troubleshooting end-user licensing problems

If the license manager appears to be running correctly, and the user still cannot get Island products to come up licensed, check the following common causes:
 
1) The LM_LICENSE_FILE variable  
2) The IOFFICE environment variable is set incorrectly 3) Node-locked license 4) Node-locked licenses on HPUX

N. How to contact Island Software Support and Licensing

 
  PHONE: 916-454 3742 or 800-255-4499 (toll free in the US)
  FAX: 916-454 3792
  WWW: http://www.islandsoft.com
 
Technical Support License Requests
800-255-4499 800-255-4499
help@islandsoft.com license@islandsoft.com