This release enforces floating licenses using FLEXlm. The install process no longer requires a password.
The license server must be run on one of the NT machines in the network. It is best to first install Apex NT on the machine that will be used as the license server. This allows subsequent installations to correctly specify the license server machine so that the install process can verify that a license is available.
Configuration of the license server and obtaining of licenses is described in Configuring the License Server.
Exit from ALL running programs on your machine. This is important as some of the running programs may be using DLLs installed by a previous release of Apex Ada NT. This will prevent these DLLs from being removed and hence prevent complete uninstall of previous versions of Apex Ada NT or successful installation of new versions. Ensure that the following executables are not running:
It is recommended that you either uninstall the previous release (by choosing Uninstall from the Rational Apex Ada program group) or remove the existing environment variables before installing Apex Ada NT.
If you have not uninstalled the previous release, the following points need to be noted:
Insert the CD-ROM into the CD-ROM drive and execute setup. For example, if your CD-ROM drive is drive e, execute the following command:
e:setup
Transfer the file Apex_Nt_<version>.exe from the directory public/apex/releases/win/apex_nt.<version>-self_extract on Rational's ftp server to your local disk in binary format. version will be the version number of this release (for example, 1.0.2, 1.0.4). You can use the following commands to do this:
% ftp ftp.rational.com
ftp> cd public/apex/releases/win/apex_nt.<version>-
self_extract
Following are the steps to install Apex Ada NT:
Execute Apex_Nt_<version>.exe or setup.exe. This is a self extracting executable which will extract the required files and guide you through the rest of the installation process.
When you execute the .exe file, the Rational Apex Ada Setup screen appears.
Figure 1 Rational Apex Ada Setup screenThe next dialog that appears is the User Information dialog in which you have to enter the user name and company name.
Figure 2 User Information dialogAfter entering the user information, the Choose Install Components dialog appears. You can select either:
To install all components that includes both the base subsystems and the executables click on the Install all components (base subsystems, executables etc.) button.
Figure 3 Choose Install Components (Install all components) dialogClick on the Use existing Installation button to select one of the following:
After selecting the Install Components, the Choose Destination Directories dialog appears. In this dialog select the Destination directories in which the installation components can be copied. This dialog is custom made depending on the selection made in the Install All Components dialog. Refer to "Choosing Install Components" for details.
Figure 5 Choose Destination Directories dialog Destination Directories to Install All ComponentsIf you had selected Install All Components in the Choose Install Components (Install all components) dialog, do the following:
Deselect the Use same base directory for all components checkbox to change the directory for all components (executables and base subsystems).
If you had selected Use Existing Installation in the Choose Install Components (Use existing Installation) dialog, do the following:
Deselect the Use same base directory for all components checkbox to change the directory for the following:
Once the destination directories are selected, the License Server Information dialog appears. Use this dialog displayed in Figure 6 to configure the license server details.
Make sure that NetBEUI protocol and either the SNMP service or the NW link (IPX/SPX) is installed on your license server machine. This is required in order to obtain a unique host id for the license server.
The NetBEUI protocol can be installed by double clicking on the Network icon from the Control panel and selecting the Protocols tab. If the NetBEUI protocol is already installed, it will be present in the list of protocols displayed. If it is not displayed, it can be added by clicking on the Add... button, selecting NetBEUI protocol from the list of network protocols displayed, and clicking OK.
Figure 6 License Server Information dialogIf you select "Yes", the machine will be configured as the license server. In this case, later in the installation, you will be prompted for the required license information in the Get License Information dialog (which can also be invoked by double clicking on the Get License Information icon in the Rational Apex Ada folder). See Get License Information for details.
If you select "No", enter the License Server Name and/or License File Name.
After entering the License Server Information the Choose Folder and Environment Group dialog appears. This dialog appears only if you have administrative privileges. Select Installation for All Users or Personal in Figure 7.
All Users sets the system environment and Personal Installation sets the user environment.
Figure 7 Choose Folder and Environment GroupAfter you have selected the Folder and Environment Group, the Set Apex Environment dialog appears. Select one of the following:
Set environment to execute Apex commands from any command shell
Don't Set environment to execute Apex commands only from the Apex shell.
Figure 8 Set Apex Environment dialogThe Select Rational Apex Folder dialog appears next. Enter a new or select an existing folder name to add icons to the Program Folder. The list of Existing Folders displayed here depends on the selection made in the Choosing Folder and Environment Group dialog.
Figure 9 Rational Apex Folder dialogYou can now select Apex Full (for Configuration management and Version Control) or Apex Lite.
If you select Apex Lite, then shadowing capabilities are not available.
If you select Apex Full and the shadow server is already installed, you will be prompted that the Apex Shadowing registry entries exists and setup will overwrite them. Continue with or Cancel the installation.
If you choose to overwrite the Apex Shadowing registry entries, the location of the shadow server changes to the location specified by the new release.
Figure 10 Choose Apex Full/Lite dialog
After selecting Apex Full/Lite, the Select the layered products dialog appears. Select Rational Rose and/or Claw GUI Builder, if required. Setup can configure the user environments based on the selection made.
Figure 11 Select Layered Products dialogIf you check the Rational Rose checkbox, enter the destination directory in the Rose Environment Variable dialog that appears next.
Now that all the details have been entered/selected, the Setup Information dialog appears as in Figure 12. Check if all the details are correct and click on Finish for Setup to complete the installation process.
Figure 12 Setup Information dialogOnce the installation process is complete, you will prompted to enter the license configuration details.
Enter the Company Name, Sales order number and Number of Licenses in Figure 13. This information is stored in the licensing.information file in the %APEX_CONFIG_DIRECTORY% directory. This file also stores the hostname of the license server and an unique host identification number.
Figure 13 Get License Information dialogSend this licensing.information file to Rational in order to obtain licenses for your installation. Rational will supply you with one or more "feature" lines which depends on the licenses you have purchased.
Feature LinesThese feature lines can be added to a file of your choice and stored on the license server machine or you can enter the feature lines in the Add License Information dialog.
Ensure that Get License Information is executed prior to Add License Information.
Run Add License Information by double clicking on its icon in the Rational Apex Ada folder.
Figure 14 Add License Information dialogRefer to "Feature Lines" for details.
The licensing information will be added to the license.dat file in the %APEX_CONFIG_DIRECTORY% directory.
The license server can be accessed by double clicking on the FLEXlm License Manager icon from the Rational Apex Ada folder. This brings up the FLEXlm License Manager dialog.
Figure 15 FLEXlm License ManagerThis variable points to the Apex license server host name. For example, if the license server machine name is lic_server, this variable should have the value @lic_server. The variable is automatically updated during the install process. It can be modified by the user if he/she wishes to change the license server machine.
Checks the license server state by checking whether an Apex Ada license is available. This can be run from the shell to verify that a license is available on this machine.
BORROW_LICENSE.EXEThis tool can be used to borrow a license from the available pool of floating licenses for a specified time. The borrowed license becomes available on the client machine for the duration specified, even when the client machine is disconnected from the network. This is specially useful for laptops which may be disconnected from the network and carried around. If you wish to run Apex NT while disconnected from the network you must borrow a license before disconnecting. The borrowed license is automatically returned to the pool of floating license after the specified time has expired. This command can be run from a shell or by selecting the Tools:Borrow License... menu item from the Apex GUI. The command line syntax is
apex borrow_license <no of days>
The following sections give you details on new/reuse installations and environment variables.
The setup procedure has been enhanced to optionally allow new installations to use existing Apex installations from other machines on the network instead of re-installing all components locally. New installations need to run setup to update the registry entries and the environment variables. The setup script will ask whether you want to do a full install or use some components from an existing Apex installation (same version) elsewhere on the network. Installing locally gives faster access but will require disk space on the local machine.
After the installation is complete, the new environment becomes available only when you have selected the Set Environment button in the Set Apex Environment dialog. However shells started before the installation is complete will not have the new environment.
For late-breaking information on bug fixes, updates, and new releases, or to discuss Apex Ada NT issues with Rational and/or other Apex Ada NT users, please subscribe to the Apex Ada NT Forum, a Rational-hosted email list for the discussion of Apex Ada NT. The list membership is private and will not be sold or used for any other purpose.
The Rational newsgroups and mailing lists have moved to the Discussion Forums on the Rational Developer Network.
[Next] [Prev] [TOC] [Index]