
Change System ID - Installation Instructions


1. Extract this archive into /usr/local, such that you then have
a directory called /usr/local/ChangeSysId.


2. Establish your system's normal sys ID; enter:

  lmhostid

which should say something like this:

  lmhostid - Copyright (C) 1989-2002 Globetrotter Software, Inc.
  The FLEXlm host ID of this machine is "690abcde"

or if that doesn't work (eg. if the License Tools subsystem is not installed)
then try this instead:

  sysinfo

which will give an output thus:

  System ID:
  69  0a  bc  de  00  00  00  00  00  00  00  00  00  00  00  00  
  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  
  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  
  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  

Only the first four groups of two digits are relevant here, so once
again the code is 690abcde in this example. Alternatively, you can
use the 'printenv' command in Command Monitor (press ESC on startup
to access the maintenance menu, then choose Command Monitor).

On most SGIs (Indy, Indigo2, O2, Octane, etc.), the code will be like
this, ie. it always begins with 690, followed by five hex digits. Other
systems such as Onyx2 will give a different type of code, but this
sys ID change script setup is not designed for such systems - it will
only work on Indy, Indigo2, O2 and Octane.


3. Determine your system IP board type (what kind of CPU/system you have):

  uname -m

On an Indy or R4K Indigo2, the answer will be IP22. For R10K Indigo2,
the response is IP28. On an Octane, it should be IP30. While on O2,
the answer is IP32. If you get any other answer, then you can't use
this archive.

Determine your OS version. Enter:

  uname -a

If you are using IRIX 6.5 or later, the files relevant here are licset
and licunset. If you are using IRIX 6.2 or 6.3, then the files to use
are licset2 and licunset2. The rest of these instructions assume the
use 6.5, but changes described are identical if you're using 6.2 or 6.3,
just use the licset2 and licunset2 files instead.


4. Now load the following file into an editor:

  /usr/local/ChangeSysId/licunset

Locate the relevant section for your system based on the IPxx number and
change the dummy sys ID (690abcde) to be the same as your normal sys ID.

Next, if you want to use the supplied example license file (which
specifically uses a hostid of 6909bc6a), then proceed to step 5.
Otherwise, continue reading...

Load the following file into an editor:

  /usr/local/ChangeSysId/licset

Locate the relevant section for your system based on the IPxx number and
change the existing code (6909bc6a) to whatever code you want to use.

Remember: if you are using IRIX 6.3 on an O2, or IRIX 6.2 on an Indigo2,
then make the changes described above to the licset2 and licunset2 files
instead.

Go to step 6.


5. If you want to make use of the example license file (entirely up to
you), then move or add the contents of /usr/local/ChangeSysId/license.dat
to /var/flexlm/license.dat, eg. if the contents of current license file
are not needed, which will be the case if the file hasn't been changed
since the OS was first installed, then do this:

  /bin/cp /usr/local/ChangeSysId/license.dat /var/flexlm

or to just add the contents to the existing file enter this:

  cat /usr/local/ChangeSysId/license.dat >> /var/flexlm/license.dat

If you use the latter method, be VERY sure to type two '>' symbols intead
of one, since using just one symbol by mistake will overwite the original
license file. If you want to be safe, load both files into separate editors
and use mouse copy/paste to add the new data.


6. Add /usr/local/ChangeSysId to root's PATH defintion, ie. edit the file
/.cshrc (or equivalent). An easy way to do this is to include the
following at the end of .cshrc:

  set path = ($path /usr/local/ChangeSysId)

Save the file, and then either 'source' and 'rehash' it thus:

  source /.cshrc
  rehash

or logout and log back in again.

If you want to use the example license file, then proceed to step 8.
Otherwise, continue reading...

You can now test the setup by entering as root:

  licset

or if you are using a 6.2/6.2 system (O2, or R4K/R10K Indigo2) then enter:

  licset2

The program should report that the code has been changed as desired. You
can confirm this by entering 'lmhostid'.

If you ever want to change the code back to normal, then enter licunset
or licunset2 as appropriate, or just reboot the system.

Go to step 8.


7. If you're using the example license file, then to test the licenses, run
up License Manager and click Get Info on any of the items shown, eg. the
C Compiler. It should say the license is not valid.

Exit the License Manager and enter this:

  licset

Run up the License Manager again and click Get Info once more on an item -
this time it should say it's valid.

However, if you have other software installed that relies on your normal
sys ID (eg. Maya), then you may wish to change it back in order to use some
other piece of software, in which case enter this:

  licunset

This will change the sys ID back to the normal system setting. Remember:
use licset2 and licunset2 if your system is an O2/Indigo2 running 6.3/6.2.

That's it! All done, unless you want to automate the code change on bootup,
in which case proceed to the next section.


8. When the sys ID is altered by licset or licset2, the change is not
permanent. A power-off or reboot will clear it. Thus, if you want the system
to always use the changed ID, then setup an appropriate script in /etc/rc2.d
(for system startup) that calls /usr/local/ChangeSysID/licset. For example,
create a file called /etc/rc2.d/S25sysid which contains the following:

  cd /usr/local/ChangeSysId
  ./licset

Make sure the file is executable by root:

  chmod u+x /etc/rc2.d/S25sysid

The change will now occur automatically on startup. If you want the change
to be silent, then make the contents of the S25sysid file look like this:

  cd /usr/local/ChangeSysId
  ./licset > /dev/null

And as mentioned earlier, if your system is an O2 running 6.3, or an
Indigo2 running 6.2, then use licset2 in the S25sysid file instead.

In case you're wondering, the choice of S25sysid for the script file name
ensures that the sysid modification is one of the very first actions that
is executed when the system starts up, before anything else happens that
might depend on the host ID setting.


NOTE: The source code to the ID changing programs is in the
/usr/local/ChangeSysId/src directory. Also, the *original* files
before being renamed for this archive are stored in
/usr/local/ChangeSysId/src/orig.tar.gz, and the web page explaining
the programs is at this URL:

  file:/usr/local/ChangeSysId/src/sgi-sysid.html

Lastly, the source code for another ID-changing program is in the
file sidchange-octane-ip30.c, notes for which are in sgi-notes.txt,
but this program is not used by this archive at present. If you're
using an Octane with 6.5 and find the normal program doesn't work,
then try this one.

