Passport Maintenance Release 4.7.1 All Rights Reserved. Copyright (c) 1995 - 2012 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.dynamic.com Downloads: www.dynamic.com and 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.7.1.Z # cpio -ivcdu <99_passpt_4.7.1 # ./ppinstall On Linux systems, use the command "gzip -d filename" instead of "uncompress". It may also be necessary to change the cpio options to "ivdu" instead of "ivcdu" ("cpio -ivdu <99_passpt_4.7.1"). 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, SCO UnixWare, Linux, Mac OS X, AIX, HP-UX, and Solaris systems originally licensed with Passport 4.7.1 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, first try terminating the Passport process and entering 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.7.1 ================================ o Fixed "Too many users" errors on systems with high process turnover. Changes for Release 4.7 ================================ o Support platform 66: Red Hat Enterprise 6 64-bit x86 Linux. This new platform avoids library compatibility problems when installing on Red Hat Enterprise 6 or similar 64-bit Linux systems. o Support platform 36: Red Hat Enterprise 6 32-bit x86 Linux. This new platform avoids library compatibility problems when installing on Red Hat Enterprise 6 or similar 32-bit Linux systems. Changes for Release 4.6 ================================ o Display SQL driver option for dL4 version 10. o Include year in passport.log entries. Changes for Release 4.5.4 ================================ o SSNMAINT could not set the SSN on systems using hardware Passports. Changes for Release 4.5.3 ================================ o The check and clean up of orphaned message queues now works for port numbers greater than 2047. Changes for Release 4.5.2 ================================ o Fixed "Too many users" errors after entering a combined UniBasic and dL4 SSN. Changes for Release 4.5.1 ================================ o The "msgutil -v" command now displays additional information for debugging purposes. Changes for Release 4.5 ================================ o A new communication mechanism has been implemented for use on Apple Mac OS X (platform A1). The new mechanism avoids the OS X system limitation of 40 message queues and can support up to 4096 users. On operating systems other than Mac OS X, Passport will continue to use standard message queues. On Apple systems, this release of Passport can only be used with the following software product versions: UniBasic 9.3 or later dL4 9.2 or later ODBCdL4 1.5.1 or later IQ 4.3 or later DynamicPaper 1.4 or later Any release of dynamicXport can be used by replacing the copy of "run" in the dynamicXport server installation directory with a copy of "run" from dL4 9.2 or later. o A new utility, /etc/DCI/msgutil, has been added to be used on Mac OS X systems instead of the standard ipcs and ipcrm utilities. The new utility can be used on all platforms to list, delete, or read message queues. To list the available options, run the command "/etc/DCI/msgutil -h". The "-clear" option should only be used as directed by customer support because it deletes all message queues. o The software licensing method for Linux systems has been changed to use hardware characteristics. On systems originally licensed with Passport 4.5 or later, the license number should not change if the same operating system is reinstalled on the same hardware (disk drives can be replaced). On systems originally licensed before Passport 4.5, the current software license will continue to be valid, but the license number will change if the operating system is reinstalled or if the primary disk drive is replaced. o If the SSN license number does not match the system license number, the ssnmaint utility now displays both the SSN and actual system license number (if known). Changes for Release 4.4.2 ================================ o Fixed "Too many users" error caused by an SSN that authorized both separate and combined UniBasic and dL4 licensing. Changes for Release 4.4.1 ================================ o Port platform 07 on AIX 5.2 instead of AIX 4.3 Changes for Release 4.4 ================================ o Support combined UniBasic and dL4 licensing. o Support 64-bit x86 Linux (64) platform. Changes for Release 4.3.3.2 =========================== o Special release ported on RedHat 7.3 for use on older Linux systems. 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.