Installation - Release Notes

1.0 Release Notes/Known Issues/Limitations
   1.1 Incorrect launchpad executable name
   1.2 Installation should be performed with Developer's user ID
   1.3 Do not install in "run as administrator" mode under Windows Vista
   1.4 CDT required for installing into an existing Rational Software Architect installation
   1.5 Accessiblity
   1.6 Updates to the managing licenses section of the Installation Guide for enablement of floating licenses
      1.6.1 Managing licenses
      1.6.2 Licenses
      1.6.3 Authorized User License
      1.6.4 Floating License
      1.6.5 Viewing license information for installed packages
      1.6.6 License enablement
      1.6.7 Importing a product activation kit
      1.6.8 Enabling floating licenses
      1.6.9 Purchasing licenses
   1.7 Under certain conditions Citrix Presentation Server is supported by Rational Developer for System z v7.1.1
   1.8 TXSeries V6.2 support

1.0 Release Notes/Known Issues/Limitations

1.1 Incorrect launchpad executable name

The name of the launchpad executable documented in the Installation Guide is RDzInstallLaunchpad.exe, but the actual name of the executable is RDzLaunchpad.exe.

1.2 Installation should be performed with Developer's user ID

The installation of the Rational Developer for System z product should be done using the user ID on that machine that the developer will be running the product under. Otherwise certain functions such as remote syntax check may not work properly. During the install, the user ID must have admin authority. It is not necessarily for the user to have admin authority when running the product.

1.3 Do not install in "run as administrator" mode under Windows Vista

For Vista users, do not run the RDzLaunchpad.exe in "run as administrator" mode.

1.4 CDT required for installing into an existing Rational Software Architect installation

For installing into an existing Rational Software Architect installation, the C/C++ Development Tools (CDT) feature is required to be installed.

1.5 Accessiblity

The Installation Wizard does not work with screen readers. For those users requiring the use of a screen reader, the Installation Wizard can be run in console mode using the following command from the root directory of installation CD 1: rdz71installwizard.exe -accessibility

1.6 Updates to the managing licenses section of the Installation Guide for enablement of floating licenses

1.6.1 Managing licenses

You can manage the licenses for your installed IBM Rational Software Development Platform products and customized packages by using the Manage Licenses wizard and associated Preferences pages. The Manage Licenses wizard displays license type and license expiration information for each of your installed packages.

You can upgrade trial versions of an offering to licensed versions by importing product activation kits. You can also enable IBM Rational Common Licensing for offerings with trial or permanent licenses to obtain floating license keys from a Rational license server.

1.6.2 Licenses

As a purchaser of IBM Rational software products, you can choose from two types of product licenses: an Authorized User license, and a Floating license. The best choice for your organization depends upon how many people use the product, how often they require access, and how you prefer to purchase your software.

1.6.3 Authorized User License

An IBM Rational Authorized User license permits a single, specific individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the Rational software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

1.6.4 Floating License

An IBM Rational Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of floating licenses you purchase. For example, if you purchase one floating license for a Rational software product, then any user in your organization may use the product at any given time. Another person who wants to access the product must wait until the current user logs off.

To use floating licenses, you must obtain floating license keys and install them on a Rational License Server. The server responds to end-user requests for access to the license keys; it will grant access to the number of concurrent users that matches the number of licenses the organization purchased.

1.6.5 Viewing license information for installed packages

You can review license information for your installed packages, including license types and expiration dates, from IBM Installation Manager.

To view license information:

  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
The package vendor, current license types, and expiration dates are displayed for each installed package.

1.6.6 License enablement

If you are installing a Rational software product for the first time or want to extend a license to continue using the product, you have options on how to enable licensing for your product.

Licenses for Rational Software Development Platform offerings are enabled in two ways:

1.6.7 Importing a product activation kit

Product activation kits contain the permanent license key for your trial Rational product. You purchase, download to your local machine, and then import the activation kit to enable the license for your product. You import the activation kit to your product by using IBM Installation Manager.

You must purchase and download the activation kit to an accessible workstation.

To import an activation kit and enable the new license key:

  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
  3. On the Install Packages page, select a package and click Import product enablement kit.
  4. Click Next. Details for the selected package are displayed, including the current license kind and the version range the license applies to.
  5. Browse to the path of the download location for the kit; then select the appropriate Java archive (JAR) file and click Open.
  6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
  7. Click Finish.
The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.

1.6.8 Enabling floating licenses

You can obtain floating license keys, install Rational License Server, and enable Rational Common Licensing for your product. Rational Common Licensing provides the following benefits:

If your team environment supports Rational Common Licensing, you can enable floating licenses for your product and configure a connection to obtain access to floating license keys.

For details on license server, license key, and Rational Common Licensing administration, see the License Management Guide.

You must obtain the license server connection information from your administrator.

To enable floating licenses as the license type for specified packages and configure license server connections:

  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
  3. On the Install Packages page, select a version of a package, click Configure license servers, and click Next.
  4. On the License Servers page, select the Enable Rational Common Licensing check box.
  5. Configure one or more license server connections.
    1. Click the Add button.
    2. In the Add Server window, in the Name field, type the host name of the license server.
    3. (Optional) In the Port field, type a value for environments where a firewall is used. Do not assign a value to this port unless your administrator instructs you to do so.
    4. Click OK.
    5. If your system administrator has given you the host names of additional license servers, repeat the steps to add each server. For a redundant servers configuration, in which three servers are used, type each host name in this format: "hostname1", "hostname2", "hostname3". For each port number, type accordingly: "host1port#", "host2port#", "host3port#".
  6. Click Next.
  7. (Optional) Configure the license usage order for your custom packages. The order of licenses in the list determines the order in which your product attempts to obtain license keys for specific licenses.
  8. Click Finish.

The Manage Licenses wizard indicates whether the floating licenses configuration is successful.

When you open the enabled product next, a connection is created to the license server to obtain a license key from the pool of available floating license keys.

1.6.9 Purchasing licenses

You can purchase new licenses if your current product license is about to expire or if you want to acquire additional product licenses for team members.

To purchase licenses and enable your product, complete the following steps:

  1. Determine the type of license you want to purchase.
  2. Go to ibm.com® or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.
  3. Depending on the type of license you purchase, use the Proof of Entitlement you receive and do one of the following to enable your product: Optionally, you can also go to Passport Advantage to download the activation kit for your product. After importing the activation kit, you have the option of switching from a floating to a permanent license type if you use your PC offline for long periods.

When you want to import the activation kit or enable floating license support for your product, use the Manage Licenses wizard in IBM Installation Manager.

1.7 Under certain conditions Citrix Presentation Server is supported by Rational Developer for System z v7.1.1

Rational Developer for System z is now supported when running on Citrix Presentation Server 4.0, provided that the server is running an operating system supported by the SDP Architecture Management product family.

1.8 TXSeries V6.2 support

Rational Developer for System z v7.1.1 supports TXSeries Version 6.2. For more information about TXSeries V6.2, see http://www.ibm.com/software/htp/cics/txseries/.

(C) Copyright IBM Corporation 2007. All Rights Reserved.