Software Installation Instructions

These instructions are for IRIS software installation and assume a working knowledge of IRIX and Silicon Graphics workstation setup procedures.

Motion Platform Assembly Instructions

Begin the installation procedure by setting up the hardware, according to these instructions:

Install the Software

  1. Load the tape into a drive.

  2. Login to the workstation as root, (providing a password as required).

irix 101# su
Password: ********

  1. Change to the /usr/local/ directory.

irix 102# cd /usr/local

  1. Install the software, using the tar command.

irix 103# tar xv

  1. Verify the installation.

irix 104# ls -l

    You should see, at least, the following directories with file permissions set to drwxr-xr-x:

    Note: All Cyberware software is placed onto the tape for convenience, and you may not be entitled to licenses for some of the software. Please consult the sales quotation to see what software you are entitled to.

  1. Verify that the Cyberware SCSI Interface is recognized by the IRIS. This SCSI device should have been installed according to the Platform Assembly Instructions and the IRIX External SCSI Device installation instructions.

irix 105# hinv

    You will see lines similar to the ones below if the devices are recognized:

Scanner: unit 4 on SCSI controller 1
Scanner: unit 5 on SCSI controller 1
Scanner: unit 6 on SCSI controller 1
Scanner: unit 7 on SCSI controller 1

  1. Change the privileges for the SCSI device. You will need to know the SCSI addresses of the devices. If your IRIX has two (2) SCSI controllers, you must also know the controller number. Typically, the external SCSI bus is sc1, while the internal bus is sc0. The default settings for Cyberware equipment are sc1d4l0, sc1d5l0, sc1d6l0, and sc1d7l0.

irix 106# chmod ugo+rw /dev/scsi/sc1d?l0

    You should see that the permission for the SCSI device are now: crw-rw-rw-

irix 107# ls -l /dev/scsi/sc1d?l0

  1. If necessary, update the SCSI reference in the CyScan configuration file: /usr/local/cyscan/tcl/CyConfig-WB600?.cfg, where ? is the last digit of the platform serial number. In this file, look for the setting, set CyScsiDeviceList and edit the SCSI addresses and controllers.

Set Up an Individual User

  1. Login to the workstation as the specific user. Remain in the user's home directory for all of the steps to follow.

  2. Edit the .login (.cshrc in some cases) file to include the following environment variables (Note: Replace #### with the serial number of the system):

setenv CYSCAN_DIR /usr/local/cyscan
setenv CYSCAN_CONFIG WB####
set path = ($path $CYSCAN_DIR/bin)

setenv HEADUS_HOME /usr/local/headus
set path = ($path $HEADUS_HOME/bin)

setenv DECIMATE_HOME /usr/local/decimate
set path = ($path $DECIMATE_HOME/bin)

  1. Log out, then log in as the specific user again.

  2. Verify the operation of the software by issuing the following commands:

    1. Verify CyScan:

irix 1# cyscan

    1. Verify CyPie:

irix 2# cypie -h

    1. Verify Decimate:

irix 3# decimate -h

      Some of these programs will generate 5 rows of hexadecimal characters which will be required later in the installation process.

Receiving Licenses

  1. CyDir, Guee, CyPie, CyEdit, CyEat, CySurf and Decimate require licenses whose unlocking keys are generated the first time a user attempts to run the software. To initiate the unlocking follow the process below:

    1. Attempt to run the software as instructed above.

      This will return 5 rows of hexadecimal characters to the screen similar to the sample below:

irix 5 > cypie
cypie: License not found, or expired, for cypie v3.3

If you don't have a key yet, or wish to
extend your license, contact your vendor,
quote them this code string, and they
will give you one.

First time code string :

row 1 : ac 4f d2 5f 2c
row 2 : 53 87 7d 14 6b
row 3 : 4e 36 8d 0c 1d
row 4 : f2 82 83 8c 83
row 5 : 3f 8e 5f 0b 37

    1. Forward the 5 rows of hexadecimal characters to Cyberware Support.

    2. Login to the System as root.

irix 101# su

    1. Change to the /usr/local/headus/lib directory.

irix 102# cd /usr/local/headus/lib

    1. Open the file, .keys in the text editor of your choice.

irix 103# jot .keys

    1. Append the line you are sent into the .keys file. Ensure that no blank lines exist in the .keys file, and that the line you are sent occupies only one line.

    2. Save the file and quit the text editor.

    3. Repeat the steps above for each key that you are given. For example, place the Decimate unlocking key in the /usr/local/decimate/lib/.keys file, etc.

    4. Verify that each program now works and that the license key was accepted, as in steps 4a - 4d.

If you have problems with the installation, please contact Cyberware Support for assistance.