tivguid(8) Tivoli GUID tivguid(8)NAMEtivguid - TIVoli Global Unique IDentifier
SYNOPSIStivguid [-c] [-h] [-s [-d]] [-w { -g="string" | -n }] [-r] [-q]
AVAILABILITY
All UNIX based platforms, System i, Windows and MacOS
DESCRIPTION
The globally unique identifier (GUID) associates a client node with a
host system. When you install the Tivoli software, the tivguid program
is run to generate a GUID which is stored in the /etc/TIVGUID file on a
UNIX based system. The GUID for a client node on the server can change
if the host system machine is corrupted, if the file entry is lost, or
if a user obtaines the same node name from different host systems.
Under AIX, other tivguid related files are installed under
/usr/tivoli/guid/. These are installed with fileset 'tivoli.tivguid'.
There is a README.guid with additional information.
OPTIONS
[ -c | -C | -Create ]
Generates and stores a new GUID on the host machine. If a GUID already
exists, it will be displayed.
[ -h | -H | -Help ]
Displays the help for the tivguid commands.
[ -r | -R | -Remove ]
Removes the GUID value from system.
[ -s | -S | -Show ]
Returns the value of the current GUID.
[ -d | -D | -Decimal ]
This option should be used always with the -s option. If used, it will
show the GUID value in decimal form rather than the default hex form.
[ -w | -W | -Write ]
Writes the GUID specified in the -GUID option to the file/registry.
[ -g | -G | -Guid="string" ]
To be used only with -w option. This will set the system's GUID value
using the value provided as "string", instead of generating a new GUID.
The "string" must be a valid GUID (32 hex values) in the form
"ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff.ff" (including quotes).
[ -n | -N | -New ]
To be used only with -w option. This will create a new GUID even if one
exists.
[ -q | -Q | -Quiet ]
Avoid the messages coming on the screen. This option should be used
with any of the above options to prevent the messages displaying on the
screen.
FILES
1) /etc/TIVGUID - This file contains the GUID value.
2) The default GUID installation path on -
- AIX OS : /usr/tivoli/guid
- All other *NIX OSes : /opt/tivoli/guid
EXAMPLES
1) Create the GUID
bash-3.2# ./tivguid -c
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
BTATG0005I A GUID entry was not found. The program is generating a
new one.
Guid:18.77.4e.68.8b.43.11.df.8e.af.ba.2e.a2.dd.72.02
2) If you run 'tivguid -c' on a box where a GUID is already existing,
it will NOT create it again. Instead will display the GUID.
bash-3.2# ./tivguid -c
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
BTATG0004I A GUID already exists on this host. A new GUID will not
be created.
Guid:18.77.4e.68.8b.43.11.df.8e.af.ba.2e.a2.dd.72.02
3) Show the GUID value in hex
bash-3.2# ./tivguid -s
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
Guid:18.77.4e.68.8b.43.11.df.8e.af.ba.2e.a2.dd.72.02
4) Show the GUID value in decimal
bash-3.2# ./tivguid -s -d
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
Guid:24.119.78.104.139.67.17.223.142.175.186.46.162.221.114.2
5) Write a new GUID value
1) Using a specific GUID value
bash-3.2# ./tivguid -w
-g="7d.55.67.2d.cc.ff.ff.ff.aa.0a.0b.1e.3e.4d.d5.f6"
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
Guid:7d.55.67.2d.cc.ff.ff.ff.aa.0a.0b.1e.3e.4d.d5.f6
2) Create a random GUID value
bash-3.2# ./tivguid -w -n
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
Guid:07.3d.e3.ea.8b.49.11.df.9e.7f.ba.2e.a2.dd.72.02
6) Remove the GUID value (this will remove the /etc/TIVGUID file)
bash-3.2# ./tivguid -r
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
7) Do it quietly
bash-3.2# ./tivguid -w
-g="7d.55.67.2d.cc.ff.ff.ff.aa.0a.0b.1e.3e.4d.d5.f6" -q
No output. Now see the GUID.
bash-3.2# ./tivguid -s
Tivoli GUID utility - Version 1 , Release 3 , Level 3 .
(C) Copyright IBM Corporation 2002, 2009 All Rights Reserved.
Guid:7d.55.67.2d.cc.ff.ff.ff.aa.0a.0b.1e.3e.4d.d5.f6
SEE ALSO
See the README.guid file at the GUID installed path for more details.
COPYRIGHT
Copyright (C) 2002, 2010 IBM Corporation - All Rights Reserved.
REPORTING BUGS
Dilip Muthukurussimana <dilip.nambuthirippad@in.ibm.com>
Jul 09 2010 tivguid(8)