Specifications

152 IBM System z Personal Development Tool: Volume 3 Additional Topics
򐂰 In this case, zPDT looks in the local UIM database for a serial number. If one is present, it
is used. If the local UIM database does not exist (or if the uimreset command was used),
the serial number of the local token is placed in the local UIM database and then used by
zPDT.
Using zPDT on the license/UIM server
Suppose we want to run zPDT on the same machine that is running the license and UIM
servers. In this case we use the clientconfig command to specify License ContactServer as
localhost and UIM ContactServer as localhost. This has the following effects:
򐂰 The presence of the UIMContactServer stanza means that a UIM server must be available
on the indicated system (which is localhost in this example). Before starting zPDT on this
system the user must issue a uimserverstart command.
Some thought should be given to the Linux userid that issues the uimserverstart
command. The same userid should always be used for this command because the UIM
server database is created in the home directory of this Linux userid.
򐂰 No special setup is needed for the license server. Any zPDT system (meaning the SafeNet
server that is installed with zPDT) can act as a license server.
Switch tokens
In this case, token 12345 has been used with a newly-installed zPDT system. When zPDT is
first started, this serial number is written in the local UIM database. If a different token is used
on a subsequent startup, the zPDT startup fails. A uimreset -l command is needed to
remove serial 12345 from the UIM database; after that, a new token may be used.
However, if the serial number in the local UIM database was assigned by a UIM server (or if
the RANDOM parameter was used with the clientconfig command) then any local tokens
may be used; the operational serial number will be taken from the local UIM database.
The key point is that zPDT recognizes the difference between a UIMserver-assigned serial
number (which can be used with any token) and a locally installed serial number (taken from
a local token). A locally-installed serial number must match the token being used (unless the
RANDOM option is set).
14.4.1 Display hostname assignments
You can display the zPDT serial number assignments by pointing your browser to your UIM
server (http://uimserveraddress:9451). (Port 9451 is the default UIM port, as described
previously). The display is similar to what is shown in Table 14-1.
Table 14-1 Processor serial numbers on zPDT UIM server [e-mail]
14.4.2 Clones
If you are cloning
9
zPDT systems, be certain to remove the contents of the /usr/z1090/uim/
directory before creating the clone. When zPDT is started on the clone it will create the files
based on the licenses available for the clone.
Serial Host UUID Year Day
2099 d2x2.pok.ibm.com E6D96D01-493E-11CB-AD29-B8F42F7F8461 2012 009
9
That is, if you have completely installed a zPDT system (including your customized System z operating systems,
your particular LAN details, and so forth) and you intend to send complete copies of the installation (including
Linux, zPDT, System z volumes) to other locations.