# IBM zPDT Product Activation

## ITC 1090 dongle/Code Authentication Procedure

With the availability of zPDT Version GA 10.6 (driver level 55.16 or later) & GA 11 (driver level 57.16 or later) the authentication process has changed.

## Processing Notes

- ### The z1090 software must be installed on your Linux machine. The installation can be done without using the token.

- You will need a working token to run the z1090 software.

- You do not need to stop zPDT and you can have multiple Gen2 tokens installed.

- Switch to Linux root mode. You can have zPDT still active and multiple tokens connected.

- You can verify that the new Gen2 hardware token licenses have been installed / updated, by issuing the query_license command and observe the license expiration date.

- As in the past, you can also verify by starting zPDT (with the normal awsstart command) and then issuing a token command from a Linux window.

zPDT version GA 11 (driver 57.16 or later) & 10 ( driver 55.16 or later)

The z1090 software must be installed on your Linux machine. The installation can be done without using the token. You will need a working token to run the z1090 software.

## Create the Request File

1. Connect your token to a USB port (on your 1090 machine). If you are using more than one token on your system, you will be asked to select the token you would like to work with. Note: You may have a zPDT system/instance running when you do this request.

2. Open a Gnome or Xfce terminal/command (text mode) window

3. The request_license program must be run in root mode. Use the “ su - “

command to change to root mode. Provide the root password when prompted.

4. Change to the /usr/z1090/bin directory: “cd /usr/z1090/bin “

5. Execute the request_license. This should produce a small binary file, with a system-assigned file name, such as <linux host name>_<hash>.zip which is placed in /root. Prefix the name of the program with “./” to tell Linux to execute it from the current directory.

NOTE: If multiple Gen2 tokens are present, it will ask you to select the one you want to work with.

6. Attach the request file to an email and send it to: support@itconline.com

Put together, the sequence would look like this in the Gnome or Xfce terminal window:

su -

<root password>

cd /usr/z1090/bin

./request_license

exit exit

< to exit root mode >

< to close the terminal window >

ITC will process your request file and you will receive an ITC e-mail.

## Update your z1090 Token

With your z1090 token connected to a USB port on your 1090 machine. If you are using more than one token on your system, you do not have to remove any tokens while updating a specific license. Note: Your zPDT system/instance can be running when you do this update.

1. Transfer the update file to your zPDT machine.

2. Open a Gnome or Xfce terminal/command (text mode) window

3. The update_license must be run in root mode. Use the “ su - “ command to

change to root mode. Provide the root password when prompted.

4. Change to the /usr/z1090/bin directory: “cd /usr/z1090/bin “

5. Execute the update_license program with the filename and full path to the update file. Prefix the name of the program with “./” to tell Linux to execute it from the current directory.

#### “./update_license /home/ibmsys1/<linux host name>_<hash>_update.zip”

6. You should see multiple “Success” messages indicating the token has been updated.

7. To verify the decryption licenses have been applied, use the

query_license command: “./query_license“

8. Leave root mode: “exit”

su -

<root password>

cd /usr/z1090/bin

./update_license /home/ibmsys1/<linux host name>_<hash>_update.zip

./query_license

exit

exit

< to exit root mode >

< to close the terminal window >

Your token is now ready to use.

Put together, the sequence would look like this in the Gnome or Xfce terminal window:

Procedures last updated 202 4 January 11