Skip to end of banner
Go to start of banner

IBM Rational Software Architect Designer

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Current »

1. System Requirements

 Supported Platforms

1.1 Supported Platforms

  • Supported Operating Systems
    - Windows 7 (Enterprise, Professional, Ultimate)
    - Windows 8 (Enterprise, Professional, Standard)
    - Windows 8.1 (Enterprise, Professional, Standard)
    - Windows 10 (Enterprise, Pro)
    - Windows Server 2012 , R2 (Datacenter, Essentials, Foundation, Standard)
    - Windows Server 2016 (Datacenter, Essentials, Standard)

  • Hardware Requirements
    - Disk Space :
    3.5GB minimum for installing and additional disk space for development resources
    7.0 GB required when installing from a download
    Minimum disk space can be reduced if optional features and run times are not installed
    - Memory :
    Minimum: 2GB RAM,
    Recommended: 4GB RAM
    Large Workspace/Multiple WAS: 6GB RAM
    - Display Desktop 1024 x 768; 1280 X 1024 recommended All supported
    - Processor :
    Minimum : 32-bit (x86) dual core
    Recommended: 64-bit (x64) quad core or better
    Large Workspace/Multiple WAS: 64-bit (x64) processor, i5, i7 or better (or AMD equivalent)

  • Supported Browsers
    - Apple Safari 8.0
    - Google Chrome 58, 59, 60
    - Microsoft Internet Explorer 8.0, 9.0, 10, 11
    - Mozilla Firefox 10.0
    - Mozilla Firefox ESR 10, 17, 24, 31, 45

  • Minimum browser requirement on 64-bit Rational Software Architect v8.5

  • Not supported on 64-bit Rational Software Architect v8.5

  • RSA 9.5 support IE 11 in Emulation 10 mode.

 Click here to expand...

1.2

  • Application Servers :

    • Apache Tomcat V3.2.4 or above

    • WebSphere Application Server v8.5.5 , V9.0

    • WebSphere Application Server Liberty Core v8.5.5 , V9.0

  • Compilers and Languages :

    • Microsoft Visual Studio 2012, 2013

    • Microsoft Visual Studio .NET 2008, 2010

  • Databases :

    • Apache Derby 10.0, 10.1, 10.2, 10.3

    • Apache Derby 10.5 JDBC 10.5.3

    • DB2 Advanced Enterprise Server Edition 9.7, 10.5

    • DB2 Enterprise Server Edition 9.5, 9.7, 10.1, 10.5

    • DB2 Express Edition 9.7, 10.5

    • DB2 Workgroup Server Edition 9.5, 9.7, 10.5

    • DB2 for i5/OS 6.1, 7.1, 7.2

    • DB2 for z/OS 11.1

    • DB2 for z/OS Value Unit Edition 10.1

    • DB2 pureScale Feature for Enterprise Server Edition 9.8

    • Database Enterprise Developer Edition 10.5

    • Informix Dynamic Server Enterprise Edition 12.1

    • Informix Ultimate Edition 11.5, 11.7

    • Microsoft SQL Server 2008, 2008 R2

  • Development Tools :

    • IBM UrbanCode Deploy 6.1

    • Rational Application Developer for WebSphere Software 9.7

    • Rational Build Forge 8.0.0.1

    • Rational Build Forge Enterprise Edition 7.1.2

    • Rational Build Forge Enterprise Plus Edition 7.1.2

    • Rational Build Forge Standard Edition 7.1.2

    • Rational Rose Enterprise 7

    • Rational System Architect 11.3.1, 11.4

    • WebSphere Application Server Developer Tools for Eclipse 8.5

    • WebSphere Application Server for Developers - Tools Edition for Eclipse 8.5.1, 8.5.5

    • WebSphere Business Modeler 7

    • WebSphere Integration Developer 7

  • Eclipse Runtime Environment : Eclipse v4.7.3

  • IBM Installation Manager v1.8.8

  • IBM Runtime Environment, Java Technology Edition v8.0.5.20

  • Rational License Key Server v8.1.5

  • JDBC Drivers : Generic JDBC Driver 1.0

  • Portal Servers : WebSphere Portal Server 8.5, 9.0

  • Product Specific or Mixed Content :

    • Rational Asset Manager Enterprise Edition 7.5.1.2, 7.5.2

    • Rational Asset Manager Standard Edition 7.5.1.2, 7.5.2

    • Rational ClearCase 9.0.0.2, 9.0.1.3

    • Rational Tau 4.3

    • Rational Team Concert 5.0.2, 6.0.2, 6.0.3, 6.0.6

    • WebSphere Application Server for Developers - Tools Edition for Eclipse 8.5.1

  • Reporting and Analysis : BIRT Report Designer 4.6.0

  • Requirements Management : Rational DOORS Next Generation 5.0, 6.0

  • Transaction Servers and Gateways : CICS Transaction Gateway Desktop Edition 9.1

2. Installation

 Access your Passport Advantage Account for Software Downloads

2.1 Access your Passport Advantage Account for Software Downloads

To access your Passport Advantage Account

  1. Go to: Software and services

  2. Select “Customer Sign In”.
    If you already have an IBM ID, Log in and proceed to step 3
    If you do not have an IBM ID:
    - Complete the New Customer required information section
    - Click “Register” and then “Continue”
    - Log in by using your IBM ID and password

  3. If you have self-nominated to register as a member of the account, proceed to step 4
    If you have not self-nominated to register yourself as a member of the account:
    - Enter your Site ID. Refer to IBM Definition Terms below for information about the Site ID and Site
    Contact
    - Select “Yes” only if you are the Primary Site Contact.
    - Select “No” if you are not the Primary Site Contact
    a) If you are the Primary Site Contact, the nomination is sent to the IBM eCustomer Care Team for
    approval
    b) If you are not the Primary Site Contact, the nomination is sent to the Primary Site Contact for
    approval
    - After the nomination is approved, you receive an email notification.
    - Log in to your account : Software and services

  4. Select "Support and Downloads"

  5. Proceed with the step-by-step process to continue

  6. For assistance contact the IBM eCustomer Care Team

 Access your IBM Rational Software License Keys

2.2 Access your IBM Rational Software License Keys

  1. Go to : IBM Rational for Licensing

  2. If you already have an IBM ID, Log in and proceed to step 3
    If you do not have an IBM ID:
    a. Complete the New Customer required information section
    b. Click “Register” and then “Continue”.
    c. Log in by using your IBM ID and password.

  3. If you are the Primary Site Contact or the Site Technical Contact for the Passport Advantage account, you are automatically assigned as a default member of the Rational License Key Center Account. You’ll receive a Welcome email from rationallicensekeys@subscribenet.com.
    Follow the instruction in the email to access your account for the first time.
    - If you cannot locate your Welcome email, proceed to the Rational License Key Center, select
    forgot your password” to have instructions be sent to you to reset your password.

  4. If you are not a member of the Rational License Key Center Account, contact your Primary Site Contact to request access.

  5. If you have the Site number and the Sales Order number for the license purchase, click “Don’t have a password” on the log in page. Complete the Join Account form.
    a. If you leave the Sales Order Number field blank and click submit, an email is sent to the administrator of your License Key Center account asking the administrator to approve your membership. After your membership is approved you will have access to the account.

  6. After you log in, click “Get Keys” and proceed with the license registration process

 Installation IBM Installation Manager

2.3 Installation IBM Installation Manager

IBM Installation Manager is a single installation program that uses remote or local software repositories to install, modify, or update certain IBM products. Use this program to install, update, modify, roll back, and uninstall packages on your computer.

  • Before you install Installation Manager on your target machines, you must consider what mode you will use to deploy packages. The mode that you choose determines how you install the software. There are three modes: administrator, non-administrator, and group. The primary difference between these modes is which users can launch Installation Manager.
    - Administrator mode: Installation Manager can only be installed once per machine. This mode is required for packages that require administrator or root privileges to be deployed. Also, the user who launches Installation Manager must be a member of the “Administrators” group on Windows or have root privileges on UNIX, Linux, IBM i, IBM z/OS®, and OS X operating systems.
    - Non-administrator mode: Installation Manager can be installed once per user. This mode is useful when users have their own copy of an application. Those copies are managed separately by the respective user accounts. However, in this mode, packages that require administrator access cannot be installed.
    - Group mode: Use this mode when you use multiple user accounts to manage the installed applications. In group mode, a group of users share packages. This mode is only available on Linux, UNIX, IBM z/OS, and OS X platforms. It is not available on Windows or IBM i. Packages must be enabled for group mode. Check the documentation for your package to determine whether the package is enabled for group mode.

  • Downloading Installation Manager

    To download the installation files, go to the Installation Manager download links technical document and click the applicable download document link. The download document contains details about downloading the installation files.

  • Installing IBM Installation Manager :

Installation Manager is installed only once for each user ID on the computer.

To Install IBM Installation Manager :
1. On the Setup disk, change to the InstallerImage_platform subdirectory.
2. Run one of the following commands:
To install as an Admin:install
To install as a non-Admin: userinst
3. On the first page of the Install Packages wizard, click Check for Other Versions and Extensions to
install the latest available version. If a newer version is available, it is automatically selected for
installation. Click Next.
4. On the Licenses page, read the license agreements for IBM Installation Manager. If you agree to
the terms of all the license agreements, Click I accept the terms in the license agreements and
then Click Next.
5. On the location page, in the Installation Manager Directory field, type the path type the path for
the directory where you want to install Installation Manager or accept the default path and then
Click Next.
6. On the Summary page, review your choices before starting the installation process. If you want to
change your selections, Click Back to return to the previous pages. When you are satisfied with
your selections, Click Install.

  • Starting IBM Installation Manager : can start it in one of these ways
    Windows
    Click Start > All Programs > IBM Installation Manager > IBM Installation Manager

 Installing Rational Software Architect Designer with IBM Passport Advantage website

2.4 Installing Rational Software Architect Designer with IBM Passport Advantage website

Before your begin running as administrator on windows

  1. Log on to IBM Passport Advantage website by using an entitled IBM ID.

  2. When you locate the IBM Rational Software Architect Designer V9.5 Multiplatform Multilingual Assembly (Core), click Install using IBM Installation Manager.

  3. Select the platform for IBM Installation Manager, and then Click Download Now. The Download Director applet starts and downloads the installation files for Installation Manager.

  4. When the download completes:
    For Windows: In Download Director, Click Launch. If you close Download Director without clicking Launch, open Windows Explorer and browse to the location where you downloaded the .exe file and run it.
    The Installation program starts, extracts the installation files for IBM Installation Manager, and starts Installation Manager in administrator mode.

  5. When prompted, enter your IBM ID user name and password.

  6. Installation Manager shows all the software that you are entitled to.

 Installing Rational Software Architect Designer with the Installation Manager GUI.

2.5 Installing Rational Software Architect Designer with the Installation Manager GUI

  1. Depending on your operating system and your user ID, complete one of the following steps:
    - If you are installing with administrator or root privileges:
    For Windows and Linux : Start the Launchpad application: : Run RSA_SETUP\launchpad.exe.
    - If you are not installing with administrator or root privileges:
    a) Change to the directory where you extracted the disk images.
    b) Run the following command for your operating system:
    For Windows: Run RSA_SETUP\InstallerImage_win32_win32_x86\userinst.exe.
    IBM Installation Manager starts.

  2. On the first page of the Install Packages wizard, ensure that you select IBM Rational Software Architect Designer. If you do not already have IBM Installation Manager, Version 1.6.3.1, or later installed, then it is also selected.

  3. You can optionally select to install any of the following supporting software:
    - IBM WebSphere® Application Server Liberty for Developers
    - IBM WebSphere Software Development Kit Java™ Technology Edition for Liberty
    - IBM WebSphere Application Server for Developers
    - IBM WebSphere Application Server Test Environment
    - IBM Rational Desktop Connection Toolkit for Cloud Environments
    If you choose to not install any of these software items at this time, you can install them later.

  4. You can install updates at the same time that you install the base product package. To search for updates to the packages, click Check for Other Versions and Extensions. Installation Manager searches for updates at the predefined IBM update repository for the product package. It also searches any repository locations that you set.

  5. To learn more about the packages that you can install, click the package name. A description of the package is displayed in the Details pane. If additional information about the package is available, a More info link is included at the end of the description text. Click the link to display the additional information in a browser.

  6. Click Next.

  7. On the Licenses page, read and accept the license agreements for the selected packages.
    - On the left-hand side of the License page, click each package version to display its license
    agreement.
    - If you agree to the terms of all of the license agreements, click I accept the terms of the license
    agreements. Click Next to continue.

  8. If Installation Manager is not already installed, then specify the Shared Resources directory and the Installation Manager directory.
    - Type the path for the Shared Resources Directory, or accept the default path.
    The Shared Resources Directory contains resources that can be shared by one or more package
    groups.

Use your disk with the most available space for to help ensure adequate space for the shared resources of future packages. You cannot change the shared resources directory location unless you uninstall all packages.

- In the Installation Manager Directory field, type the path for the directory where you want to
install Installation Manager or accept the default path. Click Next.

9. On the Location page:
- The software is installed into one or more package groups, depending on the items that you
chose to install. Each package group has an installation directory for the software in the package
group. You can accept the default locations or specify the installation location. To specify the
installation location, click the package group and then type the path for the installation directory
for the package group. (If you are installing on Linux, ensure that you do not include any spaces
in the directory path.) The name for the package group is created automatically. Depending on
the software that you selected to install, the following package groups are created:

Package group name

Products in the package group (if selected for installation)

IBM Software Delivery Platform

  • Rational Software Architect Designer

  • IBM Rational Desktop Connection Toolkit for Cloud Environments

  • IBM WebSphere Application Server Test Environment

WebSphere Application Server

IBM WebSphere Application Server for Developers

WebSphere Liberty

  • IBM WebSphere Application Server Liberty for Developers

  • IBM WebSphere Software Development Kit Java Technology Edition for Liberty

- If you operating system is 64-bit, then select 64-bit or 32-bit to install the product in the
corresponding bit mode. Click Next.

10. On the Features page under Languages, select the languages for the package group. The
corresponding national language translations for the user interface and documentation for the
product package will be installed.

11. On the next Features page, select the package features that you want to install.
a) Optional: To see the dependency relationships between features, select Show Dependencies.
b) Optional: Click a feature to view its brief description under Details.
c) Select or clear features in the packages. Installation Manager automatically enforces any
dependencies with other features and displays updated download size and disk space
requirements for the installation.
d) When you are finished selecting features, Click Next to continue.

12. On the help system configuration page, select one of the following options and then Click Next:
- Access help from the Web
- Download help and access content locally
- Access help from a server on your intranet

13. If you are installing WebSphere Application Server Test Environment extension: The
Configuration of the WebSphere Application Server page opens. Perform the following steps:
- In the left column under the version of WebSphere Application Server Test Environment extension,
Click Configuring the WebSphere Application Server.
- Either leave the default selection Create a profile to create a profile for the application server test
environment or clear it if you want to create the profile later. You can create a profile using the
workbench: Click Window > Preference > Server > WebSphere Application Server.

If you are the root user and are installing for a non-root user, then do not create a profile at this time, and then request that the non-root user create the profile later in the workbench.

- If you selected to create a profile in the previous step, then do the following things:
a) Type a profile name and profile path in the corresponding fields or accept the default entries.

If you are installing as a non-Admin user on Windows, then you might see a message that the profile path exceeded the maximum length of 80 characters. If this error occurs, type a shorter profile path. For example, type user.home/IBM/profiles/was70profile1 instead of user.home/IBM/SDP/runtimes/base_v70/profiles/was70profile1.

b) By default, the option Enable administrative security on the profile is selected. Clear this
selection if you do not want to enable security on the profile. Otherwise, type a user ID and
password in the corresponding fields.
- Click Next.

If you are also installing WebSphere Application Server or WebSphere Application Server Liberty at the same time, then create a developer profile after the installation completes

14. On the Summary page, review your choices before installing the product package. If you want to change the choices that you made on previous pages, click Back, and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.

15. When the installation process is complete, a message confirms the success of the process.
- Click View log file to open the installation log file for the current session in a new window.
You must close the Installation Log window to continue.
- In the Install Package wizard, select whether you want the product to start when you exit.
- Click Finish to start the selected package.
The Install Package wizard closes and you are returned to the Start page of Installation Manager.

16. Close Installation Manager.

 Updating installed product packages

2.6 Updating installed product packages

Internet access is required unless your repository preferences points to a local update site. Each installed package has the location embedded for its default IBM update repository. For Installation Manager to search the IBM update repository locations for the installed packages, the preference Search service repositories during installation and updates on the Repositories preference page must be selected.

  • Close all programs that were installed using Installation Manager before updating.

  • During the update process, Installation Manager might prompt you for the location of the repository for the base version of the package. If you installed the product from CDs or other media, they must be available when you use the update feature.

To update product packages :

  1. On the Start page of IBM Installation Manager, Click Update.

  2. Optional: If a required version of IBM Installation Manager is not detected on your computer, you must continue with the update of Installation Manager. Follow the instructions in the wizard to complete the update.

  3. In the Update Packages wizard, select the product package group that you want to update or click the Update All check box and Click Next. Installation Manager searches for updates in its repositories and the predefined update sites for the product.

  4. On the Update page, complete the following steps:
    - To display all updates found for the available packages, Click Show all.
    - To learn more about an update, click the update and review its description under Details.
    If additional information about the update is available, a More info link is included at the end of
    the description text. Click the link to display the information in a browser. Review this information
    before installing the update.
    - Select the updates that you want to install or click Select Recommended to restore the default
    selections. Updates that have a dependency relationship are automatically selected or cleared,
    Click Next.

  5. On the Licenses page, read the license agreements for the selected updates. On the left side of the License page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements and Click Next.

  6. On the Features page, select the features that you want to update and complete the following steps: - To learn more about a feature, click the feature and review the brief description under Details.
    - If you want to see the dependency relationships between features, select Show Dependencies.
    When you click a feature, any features that depend on it and any features that are its dependents
    are shown in the Dependencies window. As you select or exclude features in the packages,
    Installation Manager automatically enforces any dependencies with other features and displays
    updated download size and disk space requirements for the installation. Click Next

  7. On the Summary page, review your choices before installing the updates.
    - If you want to change the choices you made on previous pages, Click Back, and make your
    changes.
    - When you are satisfied, Click Update to download and install the updates. A progress indicator
    shows the percentage of the installation completed.

  8. Optional: When the update process completes, a message that confirms the success of the process is displayed near the top of the page. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.

  9. Click Finish to close the wizard.

3. Licensing

 Obtain License Keys for IBM Rational Products

3.1 Obtain License Keys for IBM Rational Products

Most IBM Rational products require license keys in order to run. Others give the option of using license keys as a way of controlling usage within an enterprise.
The IBM Rational License Key Center is a web service that allows for the generation and management of Rational license keys.

As this website is hosted by Flexera your IBM User ID and password cannot be used to log in. You will need to create a separate member id and password.

  • Accessing the IBM Rational License Key Center
    1. Only the Passport Advantage account Primary Contact and Site Technical Contact are
    automatically assigned as default members of the Rational License Key Center account.
    2. A Welcome email is generated from NO-REPLY-IBMRational-license-eys@flexnetoperations.com.
    2.1 If you are a Primary and / or Site Technical Contact,
    follow the instructions in the email to access the account for the first time.
    2.2 If you cannot locate your Welcome email, proceed to the IBM Support Licensing webpage and
    perform the following action: Log into the Rational License Key Center
    On the Log in page Click the "Forgot your password?" link to resend the Welcome email that
    contains instructions about how to create your password.
    2.3 If you are not the Primary Contact or Site Technical Contact,
    you must request to be added as a member of a Rational License Key Center account.
    - Contact your Primary or Site Technical Contact to request access. Either Primary or Site
    Technical
    - Contact can manually add you to the account.

IBM Business Controls prevents the Technical Support Team from providing account numbers or account access to individuals without prior authorization from the Primary Contact on the account. This policy is to protect customer information. If you don't know your account number, your customer number, your Primary Contact, or your Site Technical Contact, then seek out the person in your organization that works with IBM Rational Support. That person either is the Site Technical Contact or should be able to tell you who is. If all else fails and you need help from IBM in locating your account number or Primary Site Contact, contact the IBM eCustomer Care Team  in your geo.

  • You can also add yourself as a member of your company's License Key Center account: 
    1. Starting from the IBM Support Licensing page, navigate to the IBM Rational License Key Center,
    On the License Key Center login page, Click the "Don't have a password?" link.

    2. Enter your contact information and the IBM Site Number. Also, enter the Sales order number if you
    have it. The Primary Site Technical Contact has this information in the IBM Proof of Entitlement
    (PoE) certificate.


    3. Submitting without a Sales order number will invoke an authorization process for your account.
    The email response from the Licensing Key Center might not be immediate.
    4. When entering the Sales order number along with the Site number, authorization is not required.
    You receive a Welcome email right away.
    5. After account creation, you receive a Welcome email from
    NO-REPLY-IBMRational-license-keys@flexnetoperations.com.
    6. Log in to the License Key Center.
    The first time logging in to the License Key Center requires that you change the password.

 Generate license keys for Rational Products from Rational License Key Center (RLCK)

3.2 Generate license keys for Rational Products from Rational License Key Center (RLCK)

To Generate license keys for Rational Products to activate your application.

  1. Login to IBM Rational License Key Center Website

  2. Select the license account (In case if multiple license account access is provided)

  3. Click on Get Keys in the left navigation pane under section My License Keys

  4. Select the desired product from the Product line list

  5. Select the type of license key that you need to generate from the list displayed

6. Check (Select) the respective check box and Next

7. License Key generation process:
7.1 Floating license keys

- Disk Serial Number is 8 characters
- Ethernet Address is 12 characters
- Special Character should be removed or avoided in the host id section
7.2 Node Locked/Authorized user license keys
7.3 Activation kits
- Select the desired product from the Product line list for which Activation kits needs to be
generated
- Select the version of the product for which Activation kit is required

Activation kits are version dependent

8. Click Generate

9. Once the license key is generated then Click on Download Keys

10. Transfer the license key to the system where it needs to be imported to the License Key Server.

 Installing Authorized user license keys by using Installation Manager

3.3 Installing Authorized user license keys by using Installation Manager

To install both permanent and Fixed Term License (FTL) authorized user license keys on client computers.

An authorized user license key is created for a specific client and does not require a license server. Authorized user license keys enable portability, especially for use scenarios that include isolated computers or notebooks.

  • Installing permanent or Fixed Term License (FTL) keys
    Use the Manage Licenses wizard in the IBM Installation Manager to install your permanent license keys.
    The Manage Licenses wizard imports the new license key and agreement from the product enablement kit.
    Permanent authorized user license keys are included in the product activation kit that you purchase. You download the product activation kit from the IBM Rational License Key Center. The product activation kit file contains license keys and the license agreement for a specific product.
    Get the name of the license server from your administrator.
    Then, use the Manage Licenses wizard in the Installation Manager to specify the license server.

  • Importing permanent authorized user keys
    In IBM Installation Manager, use the Manage Licenses wizard to import the license key file for your client after you download the activation kit. For details on importing a product activation kit, see Help in the Installation Manager.

 Installing authorized user license keys with License Key Administrator(LKAD)

3.4 Installing Authorized user License keys with License Key Administrator(LKAD)

Must have local administrative privileges for the computer to import the license key into LKAD.

The LKAD wizard starts at the end of product installation. If LKAD does not start, open LKAD from the Start menu under the Rational folder.

To enter license information in LKAD:

  1. Click License Keys > Enter a License in LKAD.

  2. Select the type of license.

  3. In the next window, enter the following information:
    - Product
    - Expiration Date
    - License Key
    - Quantity (if you are installing a floating license key)

  4. Click Finish.
    LKAD adds this information to the license key file *.dat in install_path\IBM Rational\Common.

  Installing Rational License Key Server on Windows

3.5 Installing Rational License Key Server on Windows

  • For IPv6, the IPv6 stack must be enabled on Windows before you install the Rational License Key Server. At the same time, on Windows XP and Windows Server 2003 operating systems, the IPv4 based license server can be contacted by IPv4 FlexEnabled clients only if the IPv6 stack has been uninstalled before you install the license server.

  • You cannot upgrade from an earlier release of Rational License Key Server. If you have Rational License Server 7.1 or earlier installed, you must uninstall the license server before you install Rational License Key Server 8.x. You cannot upgrade license servers versions 7.1 or earlier to version 8.x.

  • Rational License Key Server version 8.x cannot be on the same computer as IBM Rational Common License version 7.1 or earlier and IBM Rational License Server TL 2.0.

  • You must have Windows administrator privileges on the local computer. The Windows server must have a C:\ drive. The default TCP/IP port number is 27000.

 To Install the license server and license key files on Windows.:

  1. Log in as a user with administrator rights on the local computer where the Rational License Key Server will be installed.

  2. Extract the installation files for Rational License Key Server. The extracted files are the repository for Rational License Key Server. The installation files include Installation Manager.
    You do not need to download Installation Manager separately.

  3. Go to the //RLKSSERVER_SETUP/disk1 directory.

  4. Double-click launchpad.exe. The IBM Rational License Key Server splash screen opens.

  5. Click Readme to read the release information.

  6. Click Install or Update IBM Rational License Key Server to open the Installation Manager interface.
    If Installation Manager is not installed or the installed version of Installation Manager is an earlier version than the Installation Manager version included with Rational License Key Server, you must install Installation Manager before you install Rational License Key Server:
    6.1 Installation Manager opens to the Install Packages window. Only Installation Manager is listed.
    Rational License Key Server is not listed.
    6.2 To install Installation Manager, follow the instructions in the Install wizard.
    6.3 When the installation of Installation Manager finishes, Click Restart Installation Manager.

  7. Click Install to install Rational License Key Server.

  8. Select Rational License Key Server and Click Next.

  9. After the prerequisites are validated, Click Next. To validate prerequisites again, Click Recheck Status in the lower right corner.

  10. Accept the license agreement and Click Next.

  11. For both the Shared Resources directory and Installation Manager directory locations, either accept the default value or enter a different directory location and Click Next.

You cannot change the location of the Shared Resources directory after Installation Manager is installed.

Default values:
- Shared Resources directory: C:\Program Files\IBM\IMShared
- Installation Manager directory: C:\Program Files\IBM\Installation Manager\eclipse

12. Accept the default installation directory for the license server or enter a different installation
directory.
Default installation directory: C:\Program Files\IBM\RationalRLKS

13. Select more languages to install and Click Next.

14. Review the features to install and Click Next.

15. Click Install.

16. Click Finish.

The license keys and start the server.
The license server will not start until license keys are installed.

 Starting the Windows license server

3.6 Starting the Windows license server

After you import or enter the license key, start the IBM Rational License Key Server.

  • The license server will not start until your license keys are installed.

  • The Rational License Key Server is automatically set as a Windows service. The default start type is automatic. The license server starts automatically each time you start the computer. If you prefer to manually start the license server, change the start type. See Changing the default startup type to manual.

  • To Starting the Windows license server
    1. For Windows 2003 or 2008:
    - Click Start Settings Control Panel Administrative Tools Services 
    FLEXlm License Manager.
    - On the General tab under Service Status, Click Start.
    2. For Windows 7:
    - Click Start > Control Panel > System and Security > Administrative Tools > Services.
    - Right-Click the FLEXlm License Manager service and Click Start.

  • Changing the default startup type to manual
    1. Click Start Settings Control Panel Administrative Tools Services 
    FLEXlm License Manager.
    2. On the General tab under Startup type, select manual.

4. Managing Licenses

 Using IBM Installation Manager to manage licenses

4.1 Using IBM Installation Manager to manage licenses

Through the Manage Licenses wizard, the application provides an interface to IBM Rational Common Licensing (powered by FlexNet software).

  • To access the Manage Licenses wizard on a client or server:
    Click Start > Programs > IBM Installation Manager > IBM Installation Manager.
    After Installation Manager opens, Click File > Open > Manage Licenses

  • Configuring clients to use single or multiple license servers by using Installation Manager
    To enter the license server host names on a client:

    1. In Installation Manager, Click File > Open > Manage License.

    2. Select a version of a package, and then select Configure Floating license support.

    3. Click Next.

    4. Click Enable Floating license enforcement.

    5. Specify one or more license server connections.
      5.1 Click Add.
      5.2 Type the host name of the license server.
      - Optional: Type a value in Port for environments where a firewall is used. Do not assign a
      value to this port unless your administrator instructs you to assign a value.
      - Optional: You can click Test Connection to confirm that the connection information is
      correct and that the server is available.
      5.3 Click OK.
      5.4 If your system administrator has provided you the host names of additional license servers,
      repeat steps a through to add each server.

    6. Click Next.

    7. Optional: Configure the license request order for your shell shared or custom packages. The order of licenses in the list determines the order that your software attempts to obtain license keys.

    8. Click Finish.

  • Configuring clients to use redundant license servers by using Installation Manager
    To specify the redundant license servers on a client:

    1. In the Installation Manager, Click File > Open > Manage License.

    2. Select a version of a package and select Configure Floating license support.

    3. Click Next.

    4. Accept license agreement terms and Click Next.

    5. Select Enable floating license enforcement option and Click Add.

    6. In the Add Server wizard, select Redundant Server to configure the license server connections. For a redundant servers configuration, where three servers are used, type each host name with a port number. The port number for all the servers must be same. 
      For example: For a redundant servers configuration, where three servers are used, type each host name in the following format: 
      hostname1, hostname2, hostname3, where hostname is the name of the server.
      For each port number, type: host1port#, host2port#, host3port#, where # is the port number.

    7. Click Next and Click Finish.

  • Assigning a port value on a client to support a firewall
    Do not assign a value to this port unless your administrator instructs you to assign a value.
    The following procedure assumes that the license administrator has provided you the Rational vendor port value.

    To assign a port value on a client:
    1. In Installation Manager, Click File > Open > Manage Licenses.
    2. Select a version of a package, and then select Configure Floating license support.
    3. For each server you have specified in the table, Click Edit.
    4. Type the required value in Port. Do not assign a value to this port unless your administrator
    instructs you to assign a value.
    5. Click OK.
    6. Click Next > Finish.

  • Changing the floating license key usage order by using Installation Manager
    For example, you might want to have a shared component in a package search for a specific license key first.

    To change the default order for using license keys:
    1. In Installation Manager, Click File > Open > Manage Licenses.
    2. Select a version of a package, and then select Configure license servers.
    3. Click Next > Next.
    4. On the License Usage Order page, add a shell-shared package to the list, if necessary.
    - Click Add.
    - Type the package name and version number.
    - Click OK.
    5. Select a package name and then click Up or Down to set the check-out order of the floating
    license keys. The package name at the top of the list requests a floating license key for
    components first. If a license key is not available, then a license key is requested for the next
    package in the list.
    6. Click Finish.

  • Changing the order of license usage for clients by using Installation Manager
    You can use the Manage Licenses wizard in the IBM Installation Manager to change the license usage order. Use the License usage order page of the Manage Licenses wizard on the clients to change the license usage order.
    To change the order for web clients, use the License usage order page of the Manage Licenses wizard on the web servers. You might want to customize the license usage order in some cases.
    For example, change the order to have a product search for a specific license key first.

    To change the license usage order:
    1. In the Installation Manager, Click File > Open > Manage Licenses.
    2. Select a version of a package, and then select Configure license servers.
    3. Click Next > Next.
    4. Change the order of licenses in License usage order by clicking Up and Down.
    5. Click Finish.

  • Removing a license server from the server search order
    Your system administrator tells you that one of the IBM Rational® license servers must go offline. You can remove the server from the server search order without deleting the information from the IBM Installation Manager.
    To remove a server from the server search order:
    1. In the Installation Manager, Click Manage Licenses.
    2. Select a version of a package, and then select the Configure Floating license support button.
    3. For each server you want to remove from the table, Click Remove.
    4. Click Next, and then Click Finish. ving a license server from the server search orde

 Uninstall the Product

4.2 Uninstall the Product

IBM® Installation Manager to uninstall your Product Master. Using the IBM Installation Manager uninstall option removes the entire offering.

The IBM Installation Manager uninstall option attempts to clean up the installation directory and any files created by the user after the product was installed, with the possible exception of a log file. For the clean up of the installation directory to take place, ensure that no shell or application is using the installation directory as its current directory or is locking it in any other way.

If you are planning to reinstall this runtime environment and use the same database instance that it uses, make sure that you create a backup image of the database as a precaution.

  • Manual Uninstall Product
    To Manual Uninstall Product:
    1. Start IBM Installation Manager and Click Uninstall.
    2. Select IBM InfoSphere Master Data Management and Click Next.
    3. Review the summary information and Click Uninstall.
    4. Click Finish.

  • Uninstalling the Product Silently
    Use this procedure to uninstall Product Master in silent mode.
    A properties file is generated when you are running an interactive uninstall. To use a silent uninstall, you must edit this file or create your own file.

Although code examples might show with line breaks in the following content,
the text between the following must be entered in the response file as one line without breaks:
<offering ....... />

To Uninstalling the product silently:
Replace the install tag in your response file with the uninstall tag.
For example:

<uninstall modify='false'>
<offering id='com.ibm.mdm.collaborative' 
	version='11.3.0.FP00IF000_20130502-1800' 
	profile='IBM InfoSphere Master Data Management' 
	features='com.ibm.im.mdm.db.feature,
	com.ibm.im.mdm.wl.feature'/>
</uninstall>
  Uninstall IBM® Installation Manager.

4.2 Uninstall IBM® Installation Manager.

Before you can uninstall IBM Installation Manager, you must uninstall all of the packages, including products that were installed by IBM Installation Manager.
You must close Installation Manager before attempting to uninstall the program.
You must log on to the computer by using the same user account that you used to install Installation Manager.

To Uninstall Installation Manager form Windows following steps:

  1. Click Start > Control Panel.

  2. In the Control Panel window, Click Add or Remove Program

  3. In the Add or Remove Programs window, select IBM Installation Manager and Click Remove.

  4. In the Add or Remove Programs dialog box, Click Yes to continue with the removal.

Support Chanel:

IBM product documentation : IBM Knowledge Center

Support Insider, Support Guide, Support site upgrades : IBM Support Portal

  • No labels