Skip to Content

Milestone 3: Installing or upgrading Compuware web products on Linux

This milestone guides you through the process for installing or upgrading Compuware web products (Compuware Enterprise Services, Abend-AID Fault Analytics, Application Audit, iStrobe, ISPW Web, ThruPut Manager Web, Topaz for Java Performance, and Topaz for Total Test) on Linux.

  RolesImage.jpg

Roles involved with this milestone:

  • A Linux system administrator to install Compuware Web Products.
  • A single user to install or upgrade CES and all web products into CES. This allows CES and those installed web products to run with a single set of permissions.
    If multiple users have already installed web products into an installed version of CES, then the permissions must be modified in the install directory of CES to grant read & write permissions to all users.
    To change the permissions for the CES install directory, execute the following command: chmod -R 755 /<path to CES>
  • For example, if CES is installed in /opt/cpwr/ces, then you would execute this command: chmod -R 755 /opt/cpwr/ces

Planning

Before beginning the installation, you should verify the following:

  • Java is installed
  • Space requirements are adequate
  • Database is created
  • Permissions are correct
  • Ports are opened

systemd

  • systemd is an "init system" and is the supported system on newer Enterprise Linux distributions.
  • CES supports SUSE and RHEL which, in versions 12+ and 7.2+ respectively, use systemd.
  • This service can be managed as mentioned above (like any other systemd service).
  • This service can be uninstalled by removing the script and running "systemctl daemon-reload" again.

Installing

  1. Click the Compuware Web Products tab from the product image.
    Ex. <network or hard drive>:\Linux\setup.exe
  2. Click Install Compuware Web Products for Linux. The Linux FTP Information tab appears.
  3. Specify a valid Host, User ID/Password, Port number (default = 21), and finally an existing Linux path in which to upload the install.bin file from the Compuware Enterprise Services product image to the mainframe.
  4. Click Upload files to begin the upload.

  5. Be sure that the install.bin file has execute authority. Perform a chmod 755 to open up permissions if necessary. This file is located at Disk1\InstData\NoVM.

     RememberImage.jpg


      • By default, the install uses the system's TEMP location, typically the /tmp directory. To specify an alternate tmp location, you need to define the environment variable IATEMPDIR prior to running the install command.
        export IATEMPDIR=<alternateTempDir>

  6. Execute the following commands:

    JAVA_HOME=/<path to JRE>
    PATH=$JAVA_HOME/bin:$PATH
    /install.bin

    The Compuware Enterprise Services installer starts.

      NoteImage.jpg

    • You can cancel the installation at any time by typing quit.
    • You can go back in the installation panels at any time by typing back.
  7. After reading the Introduction panel, press Enter. The License Agreement panel appears.
  8. Read the Compuware Web Products license agreement, pressing Enter until you have scrolled through and read the entire agreement. When prompted, type Y and press Enter to accept the terms of the license agreement. The Oracle License Agreement panel appears.
  9. Read the Oracle Technology Network Development and Distribution License Agreement, continuing to press Enter until you have scrolled through and read the entire agreement.
  10. Again, type Y and press Enter to accept the terms of the license agreement. The Compuware Web Products panel appears.

  11. Specify the absolute directory path in which to install Compuware Enterprise Services, or press Enter to accept the default location (Default: /opt/Compuware/CES).

      RememberImage.jpg

    •If you choose an alternate installation directory instead of the default, the directory (and any parent directories) will be created with privileges of 775. To use Compuware Enterprise Services following installation, be sure that the Compuware Enterprise Services job has write permission to the CES directory created by the installation.

    •The installer requires use of up to 1.2 GB (or 1,125,000 1k blocks of pre-allocated space to install properly. You may be prompted to create free space in the specified directory in order to continue with the installation.

     ImportantImage.jpg

    If you are upgrading from a previous release, enter the existing CES installation directory.

  12. Select the Compuware web products to be installed along with Compuware Enterprise Services by entering a comma delimited numbered list corresponding to the products and press Enter.
  13. Confirm your selection. If you would like to make changes to your selection, type Back. Otherwise, press Enter.
  14. Compuware Enterprise Services stores log and configuration data in the /data directory under the installation directory specified in Step 11. Press Enter to accept the default location (<Installation_directory>/data) or specify the absolute path to another location.
  15. Specify an Instance Name for the CES Service. This is used to distinguish between different versions that can run on your system. The name entered here will be appended to ‘cpwrenterpriseservices’ as the daemon name.
    Ex. cpwrenterpriseservices_CES_18.2
  16. Specify the user ID needed to install and run the CES daemon (Default: root).

  17. Specify Y (Yes) or N (No) whether you want to modify the default port numbers. Be sure that the ports you choose are open on your network's firewall.

    Port name

    Port number (by default)

    Strobe Communication port

    24354

    Web Server port

    48226

    Web Application Stop port

    8465

    Internal Messaging port

    17667

    Derby port

    1545

  18. (Fault Analytics only) Abend-AID communication port (default: 48301) Used to transmit messages. Specify a port number between 1024 and 65535. Press Enter.
  19. (iStrobe only) Profile directory (default: <installation_directory>/data/istrobe/profiles) Used to store measurement data in profiles. Specify the absolute directory path for the Profile directory. Press Enter.
  20. (iStrobe only) Quarantine directory (default: <installation_directory>/data/istrobe/quarantine) Used to store profiles that cannot be read. Specify the absolute directory path for the Profile directory. Press Enter.
  21. (Topaz for Java Performance only) Agent communication port (default: 48128). Topaz for Java Performance requires a port for communication between the mainframe agent and server. Enter the port on which to listen for this communication, or press Enter to accept the default.
  22. (Topaz for Total Test only) MongoDB host (default: localhost) and MongoDB port (default: 27017). Total Test requires this information to configure the MongoDB database. This database is used exclusively with Topaz for Total Test.

  23. Review installation information you selected in the Pre-installation summary panel. If anything is incorrect, type Back and revise the installation settings as necessary. If the information is correct, press Enter to start the Compuware Web Products installation. The Installation Complete panel appears when the installation finishes.

    NoteImage.jpg

    Before exiting the installer, use the URL provided in the installer completion page to visit the Compuware Enterprise Services page in a browser and create a bookmark for quick access. Once the CES service is started, initialization may take several minutes. You may see a 404 page in your web browser during this time.

The Compuware Enterprise Services installation process is complete. Although the installation is complete, you must still configure Compuware Enterprise Services. Continue with Configuring Compuware Enterprise Services.

Starting Compuware Enterprise Services on Linux

Starting and stopping CES on Linux is dependent on whether or not systemd is being used.

Systemd in use

When starting CES, execute the following:

systemctl start cpwrenterpriseservices_servicename

When stopping CES, execute the following:

systemctl stop cpwrenterpriseservices_servicename

Systemd not in use

When starting CES, execute the following:

/etc/init.d/cpwrenterpriseservices_servicename start

When stopping CES, execute the following:

/etc/init.d/cpwrenterpriseservices_servicename stop

A legacy service script is created during the installation in /etc/init.d. If using systemd, a script is installed that converts the legacy script to a systemd service definition file, either on restart or with a call to "systemctl daemon-reload".

Upgrading

This guides you through the process for upgrading Compuware Enterprise Services (Compuware Enterprise Services, Abend-AID Fault Analytics, Application Audit, iStrobe, ISPW Web, ThruPut Manager Web, and Topaz for Java Performance).

As of CES 17.2.1, a CES maintenance/update file is available for upgrading CES and installed products.

Roles involved

The following individuals are involved with this milestone:

  • Systems administrator and possibly a database administrator.
  • Security administrator, if security is enabled.

Planning

Before beginning the upgrade, you should have the following:

  • For your environment, you should use the same space allocations as identified in the Planning chapter of this installation space.
  • When upgrading CES using Update Center (17.2.3 and higher), the CES data folder must be at least 1 GB to accommodate the CES maintenance file. The file will be deleted once the upgrade is complete.

  RememberImage.jpg

For 18.2.1 or later, security settings that were enabled for iStrobe in the prior release will now be used to access Compuware Enterprise Services after the upgrade. For example, if LDAP security was enabled for iStrobe 17.2.0, the LDAP ID/PW will be required to access Compuware Enterprise Services. All security will now be handled through Compuware Enterprise Services.

Adding new Web Products to an existing CES installation

Any Compuware Web products not having been previously installed with the existing CES installation can only be added through a product installation, and not through the CES maintenance/update file.

Upgrading from CES 5.x

  • Newer versions of Compuware Enterprise Services (CES) cannot be installed over CES releases 5.x and earlier. A new installation is required.
  • The following data will be lost after migrating Strobe Performance Profiles:
    • Any note or tag (created in iStrobe) associated with a particular profile will be lost.
    • Past user folder information will be lost. Synchronized profiles will go to the iStrobe folder.
    • Any user configured settings under general configuration page will be lost.
    • Any saved measurements record or measurement groups record will not be there.
    • iStrobe old SMF data will be lost. So, in the new database it needs to be loaded from the beginning.
    • Schedule settings for Profile Autodelete or SMF Data Management will be lost.
    • SMF Archive Database Configuration needs to be redone.
    • Usage statistics data will be lost.
    • Security configurations—including users, roles, and groups—must be reconfigured as they are now managed by CES.
  • A CES 5.x database upgrade path is available once the newer CES is installed.
    1. Upon opening the newly installed CES in a browser, you can navigate to the CES Administration > Database page.
    2. Enter the CES 5.x database information.
    3. Click Apply.
    4. Click OK to upgrade the database.
  • (iStrobe only) If you want to retain profiles created, you can manually migrate them as follows:
    1.  Make a backup of all profiles within the profile directory of the existing install (Default: <iStrobe install directory>/samples).
    2.  After installing, move the backed-up profiles into the profile directory specified during the install (Default: <CES install directory>/data/istrobe/profiles).
    3.  Within iStrobe, navigate to iStrobe Administration > General Configuration and click Synchronize to process the profiles into the 18.2 install.

Compuware Enterprise Services has been upgraded and is ready to use.

Upgrading from CES 16.x or 17.2.0

Use the following to perform an upgrade from a product install.

To upgrade using the Product Install

  1. If you are performing an upgrade installation of Compuware Enterprise Services on z/OS UNIX, be sure to stop the CES service before beginning the upgrade.
  2. Refer to the instructions under Installing, following steps 1 through 11 where you enter your existing CES installation directory.
  3. After a successful upgrade, start the CES service and open Compuware Enterprise Services in a browser. You will be prompted to upgrade your database.
  4. Click the Database Configuration page link. Do one of the following:
    • For all database types, click Apply to automatically upgrade the database.
    • If using a Db2 LUW, Db2 z/OS, Oracle, or SQL Server database, you may instead choose to generate DDL to upgrade your database by clicking Generate DDL. Refer to the database settings page in the online help for specific direction.
  5.  If security was previously enabled, you will be prompted to verify and apply your security settings.
  6.  Profiles, notes, tags, folders and any other configuration settings should now be found in the upgraded release.

Compuware Enterprise Services has been upgraded and is ready to use.

Upgrading from CES 17.2.1 or 17.2.2

This upgrade can be accomplished through either a product install or a maintenance file.

To upgrade using the product install

  1. If you are performing an upgrade installation of Compuware Enterprise Services on z/OS UNIX, be sure to stop the CES service before beginning the upgrade.
  2. Refer to the instructions under Installing, following steps 1 through 11 where you enter your existing CES installation directory.
  3. After a successful upgrade, start the CES service and open Compuware Enterprise Services in a browser. You will be prompted to upgrade your database.
  4.  Click the Database Configuration page link. Do one of the following:
    • For all database types, click Apply to automatically upgrade the database.
    • If using a Db2 LUW, Db2 z/OS, Oracle, or SQL Server database, you may instead choose to generate DDL to upgrade your database by clicking Generate DDL. Refer to the database settings page in the online help for specific direction.
  5. If security was previously enabled, you will be prompted to verify and apply your security settings.
  6. Profiles, notes, tags, folders and any other configuration settings should now be found in the upgraded release.

Compuware Enterprise Services has been upgraded and is ready to use.

To upgrade using the maintenance file

  1. Obtain a Compuware Enterprise Services maintenance file, from the Compuware Support Center for example, and save it to an accessible location.
  2. Open the Compuware Enterprise Services 17.2.1 or 17.2.2 page and navigate to the Compuware Enterprise Services Administration > Maintenance page.
  3. Under the Web Products section, browse to the location of the CES maintenance file and click Upload. Details of the CES maintenance file are displayed.
  4. Click Upgrade to begin the upgrade.
  5. After a successful upgrade, refresh your browser. You will then be prompted to upgrade your database.
  6. From the Database Settings page, click OK. Do one of the following:
    • For all database types, click Apply to automatically upgrade the database.
    • If using a Db2 LUW, Db2 z/OS, Oracle, or SQL Server database, you may instead choose to generate DDL to upgrade your database by clicking Generate DDL.... Refer to the database settings page in the online help for specific direction.
  7. If security was previously enabled, you will be prompted to verify and apply your security settings.
  8. Profiles, notes, tags, folders and any other configuration settings should now be found in the upgraded release.

Compuware Enterprise Services has been upgraded and is ready to use.

Upgrading from CES 17.2.3 or later

This upgrade can be accomplished by using either the Update Center within the CES application or through a product install.

To upgrade using the update center

Using the Update Center within CES will upgrade both the version of CES as well as the version of the database. If you do not want to upgrade your database at this time, then you must use the product install or temporarily switch to a different database type on the Database Settings page before performing the upgrade.

  1. Open Compuware Enterprise Services 17.2.3+ and navigate to the Update Center in Compuware Enterprise Services Administration.
    The installed products will display. Click Show Details for a complete list.
  2. Select the Updates tab.
    • Set Check for updates online to On (default) - You must have an HCI defined. The maintenance file can be downloaded from the Compuware server. This requires internet access. A secure proxy may be required.
    • Alternatively, set Check for updates online to Off - This allows you to obtain a maintenance file (e.g. from the Compuware Support Center) that can be uploaded from an accessible location.
    • To show the latest versions only of the web-based products, set the Show latest versions only switch to On.

  3. After downloading or uploading an update file, click Apply to begin the upgrade process.

    Warning

    Note

    This will also update your database if required. If you do not want to update your database with CES, then you must click Cancel, then switch to a temporary database on the CES database settings page, and restart this process.

  4. After a successful upgrade, refresh your browser.
  5. At this point, if you switched to a temporary database to preserve the version of the database being used, you will want to reestablish that connection.
    1. Navigate to the Database Settings page in CES Administration and reenter the configuration settings, being sure to reassign the database type.
    2. Do one of the following:
      • For all database types, click Apply to automatically upgrade the database.
      • If using a Db2 LUW, Db2 z/OS, Oracle, or SQL Server database, you may instead choose to generate DDL to upgrade your database by clicking Generate DDL. Refer to the database settings page in the online help for specific direction.
  6. If security was previously enabled, you will be prompted to verify and apply your security settings.
  7. Profiles, notes, tags, folders and any other configuration settings should now be found in the upgraded release.
  8. Tokens were previously using a host and a port but are now using HCI connections. Ensure that each token is now pointing to a valid HCI. As well, you should remove those invalid HCI definitions that were created during the upgrade process.

Compuware Enterprise Services has been upgraded and is ready to use.

To upgrade using the product install

  1. If you are performing an upgrade installation of Compuware Enterprise Services on z/OS UNIX, be sure to stop the CES service before beginning the upgrade.
  2. Refer to the instructions under Installing, following steps 1 through 11 where you enter your existing CES installation directory.
  3. After a successful upgrade, start the CES service and open Compuware Enterprise Services in a browser. You will be prompted to upgrade your database.
  4. Click the Database Configuration page link. Do one of the following:
    • For all database types, click Apply to automatically upgrade the database.
    • If using a Db2 LUW, Db2 z/OS, Oracle, or SQL Server database, you may instead choose to generate DDL to upgrade your database by clicking Generate DDL. Refer to the database settings page in the online help for specific direction.
  5. If security was previously enabled, you will be prompted to verify and apply your security settings.
  6. Profiles, notes, tags, folders and any other configuration settings should now be found in the upgraded release.

Compuware Enterprise Services has been upgraded and is ready to use.

Moving from a sandbox to a production environment

  • If the user uses a different database in production other than the sandbox database, then only the profiles can be synchronized. All other configuration settings or user specific settings will be lost as mentioned above.
    1. Make a backup of all files within the profile directory of the existing 05.02.0x install
      (Default: <iStrobe install directory>/samples).
    2. After installing the Compuware Web Products, move the backed-up profiles into the profile directory specified during the install (Default: <CES install directory>/data/istrobe/profiles).
    3. Within iStrobe, navigate to iStrobe Administration > General Configuration and click Synchronize to process the profiles into the install.
    4. Any note or tag (created in iStrobe) associated with a particular profile will be lost.
    5. Past user folder information will be lost. Synchronized profiles will go to the iStrobe folder.
    6. Any user configured settings under general configuration page will be lost.
    7. Any saved measurements record or measurement groups record will not be there.
    8. iStrobe old SMF data will be lost. So, in the new database it needs to be loaded from the beginning.
    9. Schedule settings for Profile Autodelete or SMF Data Management will be lost.
    10. SMF Archive Database Configuration needs to be redone.
    11. Usage statistics data will be lost.
    12. Users, roles, groups will need to be reconfigured.

  • If the user uses the same type of database both in sandbox as well as in production, then all the data can be copied from the sandbox database to the production database to restore all the configuration settings. The version number and the build number of the product must exactly match that being used in sandbox and in production.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Compuware Web Products Installation and Configuration