Passport Release 4.3.3 All Rights Reserved. Copyright (c) 1995 - 2007 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.unibasic.com Downloads: ftp.dynamic.com 1. Introduction =============== The Passport software provides licensing support for our products such as UniBasic, dL4, IQ, and DynamicXport. Passport is packaged and installed as a separate product to achieve several purposes: o Ensuring that the latest version of Passport is installed. o Making it easier to determine which version of the Passport software is being installed. o Making it easier for the same Passport software to be used with upcoming Dynamic Concepts products. o Eliminating possible redundant installations when two or more Dynamic Concepts products are installed on one system. 2. Installation =============== To install the Passport software: login as root, unpack the distribution file into a suitable working directory (e.g. /tmp) and run "ppinstall". For example: # cd /tmp # uncompress 99_passpt_4.3.3.Z # cpio -ivcdu <99_passpt_4.3.3 # ./ppinstall On some systems, such as Linux, the cpio options will need to be changed to "ivdu" ("cpio -ivdu <99_passpt_4.3.3"). The ppinstall script will move the distribution files to their appropriate places and then invoke "ppconfig" to configure the Passport for your system. If you are reinstalling the Passport software after a disk drive failure and you are using a software license, the license number may change depending on the platform type. If the license number changes, it will be necessary to obtain a replacement SSN to match the new license number. On SCO OpenServer and SCO UnixWare systems using Passport 4.2 or later, the license number should not change as long as the same operating system has been reinstalled on the same hardware (except for replacement parts). If the license number changes, terminate the Passport process and enter the old SSN using the ssnmaint utility. The Passport software will attempt to match the remaining system components with the old license number. 3. New Features =============== Changes for Release 4.3.3 =========================== o Fixed portation problems on Solaris systems. Changes for Release 4.3.2 =========================== o Fixed incorrect demo license expired errors. o Support Mac OS X on Intel (A1) platform. Changes for Release 4.3.1 =========================== o Support negative message queue id numbers that occur on Apple Mac OS X systems. Changes for Release 4.3 =========================== o Software license numbers on new Apple Mac OS X systems are now determined using system hardware information when possible. This change should eliminate "License file is invalid!" problems due to incorrectly configured backup programs. This release is compatible with existing software license numbers. On systems licensed with earlier versions of Passport, the old license method and license number will be used unless the /etc/DCI/license file is removed. Changes for Release 4.2 =========================== o Software license numbers on new SCO OpenServer 5, OpenServer 6, and UnixWare systems are now determined using system hardware information when possible. This change should eliminate "License file is invalid!" problems due to incorrectly configured backup programs. This release is compatible with existing software license numbers. On systems licensed with earlier versions of Passport, the license method and license number will not be changed. Network cards can be added to a system using the new license method without invalidating the license, but network cards must not be removed after the license is determined. The license number will not be changed if an operating system is reinstalled on the same hardware. o A "-l n" option has been added to passport to select an alternate software license number. This option is used to correct license number conflicts. The option should only be used as directed by Dynamic Concepts personnel. Changes for Release 4.1.1 =========================== o Fixed "Incorrect version of passport for this platform" error on release 5.0.4 or earlier of SCO OpenServer. Changes for Release 4.1 =========================== o Support the new ODBCdL4 server product. o Support release 8 of uniBasic. o Support release 6 of dL4. o Support SCO OpenServer 6 and change the name of platform 55 from "UnixWare 7" to "SCO OpenServer 6/UnixWare 7". Changes for Release 3.10 =========================== o Improve performance when using hard Passport devices. o Scan all ports every 20 minutes for orphaned message queues and delete any that are found. The "-c seconds" option can be used to change the period over which the scan will occur. The option "-c 0" disables orphan queue scanning. Changes for Release 3.9 =========================== o Support Mac OS X (A4) platform. Changes for Release 3.8.2 =========================== o Add configuration files for Alpha (BB) platform. Changes for Release 3.8.1 =========================== o Update HP-UX (E9) platform to HP-UX version 11. o Display "MySQL driver" option for dL4 if it is enabled. Changes for Release 3.8 =========================== o Improve interport communication in dL4 4.4.1.3 and later (dL4 5.x). Changes for Release 3.7.2 =========================== o Fixed software licensing failures on the Linux x86 (6D) platform when used with 2.4 or later kernels (RedHat 7.1 and similar distributions). o Fixed problems in the ppconfig utility when used on RedHat 7.1 or similar distributions (shell language incompatibility). o Improve SSNMAINT support for DynamicXport product options. Changes for Release 3.7.1 =========================== o Fixed software licensing failures on the Linux x86 (6D) platform when used with root file systems larger than 2 gigabytes (library incompatibility). Changes for Release 3.7 =========================== o Support added for a new product: DynamicXport. Changes for Release 3.6.2 =========================== o Fixed software licensing failures on the Linux x86 (6D) platform, particularly Red Hat systems. Changes for Release 3.6.1 =========================== o Fixed a memory leak which caused the Passport process to grow ever larger as dL4 or IQ users began new sessions. o Fixed software licensing failures on the Linux x86 (6D) platform when used with root file systems larger than 2 gigabytes. o Fixed an infinite loop in software licensing on the Linux x86 (6D) platform. Changes for Release 3.6 ========================= o New utility - makeosn. "/usr/bin/makeosn" is a utility used to produce OSNs (OEM Security Numbers) for use with protected programs in both UniBasic and dL4. Changes for Release 3.5.1 ========================= o Added support for SCO Open Server in platform 99 Changes for Release 3.5 ======================= o Fixed problem where an incorrect version number was supplied when other programs, such as UniBasic (LEVEL command), queried the passport daemon. Changes for Release 3.4 ======================= o "/etc/passport". Release 3.4 of the Passport daemon program. 3.4 adds support for the new platform numbers 0x07 (PowerPC 603 AIX) and 0x29 (Power AIX). Changes for Release 3.3 ======================= o "/etc/passport". Release 3.3 of the Passport daemon program. 3.3 adds the -V option to determine version number and establishes a fixed log file name of "/etc/DCI/passport.log" (command-line redirection is no longer supported; see note on security below). o "/usr/bin/ppconfig". This is identical to UniBasic's "ubconfig", i.e. it configures the default startup command line for the Passport daemon. o New utility - ssnmaint. "/usr/bin/ssnmaint" is a new program which was designed to be the preferred method for entering or changing the license status on all Dynamic Concepts products, current or future. In other words, ssnmaint can handle all maintenance of a system's SSN. o New utility - ppstresstest. "/usr/bin/ppstresstest" is a diagnostic program which can help identify faulty hardware Passports. o New installation program - ppinstall. 4. Miscellaneous Notes ====================== o Security: There is a possible security risk present for existing installations of the Passport software, in that it is possible that users other than root may write to "/etc/DCI/passport.cmd", the Passport daemon startup command file. To make an existing installation secure, perform the following from root: # chown root /etc/DCI /etc/DCI/passport.cmd # chmod 755 /etc/DCI # chmod 755 /etc/DCI/passport.cmd For new installs, "ppinstall" ensures that both of these files have the appropriate permissions. As a further optional step, the system administrator may wish to control modification of the system SSN by: # chown root /etc/DCI/ssn # chmod 644 /etc/DCI/ssn This would ensure that only the superuser can delete or modify the SSN.