Upgrading Lifecycle Manager

This document includes instructions for upgrading Lifecycle Manager from version 7.1x to 8.0, and from version 8.0.0 or 8.0.1 to 8.0.2.

Note: Lifecycle Manager 8.0.2 requires Akana Platform 8.4.x.

  1. Upgrade instructions matrix
  2. Upgrading Lifecycle Manager from Version 8.0 to Version 8.0.2
  3. Upgrading Lifecycle Manager from Version 7.1 to Version 8.0.0

Upgrade instructions matrix

Use the table below to determine which upgrade instructions to use.

For this upgrade scenario... Use this upgrade documentation...
7.1 to 8.0.0 Upgrading Lifecycle Manager from Version 7.1 to Version 8.0.0
8.0.0 to 8.0.1 Akana Library (https://library.akana.com/display/MAIN/Akana+Library) > Downloads > Lifecycle Manager > LM 8.0.1 > Documentation > LifecycleManager_Upgrade_Instructions_8.0.x.pdf
8.0.0 or 8.0.1 to 8.0.2 Upgrading Lifecycle Manager from Version 8.0.1 to Version 8.0.2 (below)

Upgrading Lifecycle Manager from Version 8.0.0 or 8.0.1 to Version 8.0.2

Supported Platforms: 8.4.11

If you're already on Lifecycle Manager version 8.0.0 or 8.0.1, and want to migrate to 8.0.2, you'll also need to upgrade the version of the underlying Akana Platform to version 8.4.11.

At a high level, the steps are:

  1. Step 1: Back up existing installation and complete pre-install steps
  2. Step 2: Install the Akana Platform and Lifecycle Manager, connecting to your existing database
  3. Step 3: Verify that the upgrade was successful
  4. Step 4: Complete post-install checks
Step 1: Back up existing installation and complete pre-install steps

Follow the steps below.

  1. Back up your database and the Lifecycle Manager application home directory.
  2. Record your current Lifecycle Manager application settings. You can do this by noting down the LM /admin console's Settings page values, and/or use the following database query:
    select * from installprops;
  3. Verify that there is enough free disk space on the application server:
    • volume for {platform_home} directories: 1GB
    • volume for /tmp directories: 500MB
    • volume for logs during upgrade: 125MB
  4. Verify that there is enough available space on the database tablespaces. There should be at least 15% free space in each Lifecycle Manager tablespace.
  5. App_%.log file locations when upgrading: because the LM logging configuration for the existing installation is stored in the database, the LM app logs still persist in the pre-defined location (typically in [lm_home]/logs/webapp). For this reason, when upgrading to LM 8.0.2, the LM logging location from the previous installation version must still exist, so that any DataUpgrade entries are captured. After a successful upgrade, you can alter the logging configuration to adjust the location to the OSGi standard of [platform_home]/instances/[instance_name]/log.
  6. Conditional, certificate setup: When LM is using HTTPS (or is behind a front-facing device using HTTPS), and/or when LM needs to use LDAPS, or integrates with another system using certificates (such as the Akana Platform), those certificates must be trusted by the Akana Platform JRE's default trust store ({platform_home}/jre/lib/security/cacerts). Use the JRE keytool command to trust the various certificates, per the steps in Setting up LDAP over SSL in the Lifecycle Manager System Admin Guide.
  7. When you're ready to proceed, shut down the existing server.
Step 2: Install the Akana Platform and Lifecycle Manager, connecting to your existing database

The only difference between a new install of Lifecycle Manager 8.0.2 and an upgrade scenario is that when you're configuring the Lifecycle Manager feature for the database, you'll choose to use your existing database rather than creating a new database. In the upgrade scenario, you'll point to your existing Lifecycle Manager 8.0 database in Step 5 of the installation procedure.

Install Lifecycle Manager 8.0.2 with the Akana Platform 8.4.11.

For detailed instructions, see Installing Lifecycle Manager 8.0.2.

Note: You will follow the Lifecycle Manager 8.0.2 install guide up to the point of Step 5: Install and configure the Lifecycle Manager Feature. in this step, in the Database Wizard, you'll choose to use an existing database. At this point, provide the connection information to allow the connection to your existing database. Then, continue with the steps from the Lifecycle Manager 8.0.2 install guide.

The feature list you'll install in Step 5 is identical for LM 8.0.1 and 8.0.2.

The steps are summarized below:

  1. Step 1: Gather ZIP files and download to the install folder
  2. Step 2: Unzip installation files in the correct sequence
  3. Step 3: Run Configurator to configure Lifecycle Manager container
  4. Step 4: Start the Lifecycle Manager instance
  5. Step 5: Install and configure the Akana Lifecycle Manager Application feature. In this step, rather than creating a new database, you'll point to the database for your existing LM version.
  6. Step 6: Extract javaclients.zip file and specify the URL in the configuration settings
  7. Step 7: Update the Lifecycle Manager configuration settings
  8. Step 8: Create a Lifecycle Manager Library
Step 3: Verify that the upgrade was successful
  • Review the log files for any error messages.
  • Verify the upgrade by logging on to the Lifecycle Manager admin console:
    • http://{web.server.url.host}/{contextroot}/admin/mainMenu.do
    • Verify that the Build number is 8.0.2.x.
Step 4: Complete post-install checks
  • Navigate to the LM /admin console, then verify and update any settings as appropriate.
  • Optional: If desired, execute the following command that reset window size and location settings to the system defaults. Run this command via the LM /admin console > Execute Command):
    Fully Qualified Command Class Name: ClearAllUserUIProperties
    Library:[choose each library]
    Click [Invoke]
  • Have each user upgrade the Repository Client (if it's installed) with the new version.

back to top

Upgrading Lifecycle Manager from Version 7.1 to Version 8.0.0

These upgrade instructions are for a scenario where you have Lifecycle Manager 7.1 installed and are upgrading from Lifecycle Manager 7.1 to Lifecycle Manager 8.0.0.

If you're installing Lifecycle Manager for the first time, refer to the Lifecycle Manager 8.0 Installation Guide.

If you're upgrading from a version earlier than 7.1, you'll first need to upgrade to 7.1.

If you are upgrading from 7.1, you can use any of the 7.1.x micro releases (including 7.1.6). Unlike the rule to sequentially iterate through the major or minor version releases, there's no need to do the same for the micro releases (such as 7.1.x). Each micro release includes all the incremental changes you'll need.

You can also refer to the Install and System Admin Docs for more general Lifecycle Manager information. Lifecycle Manager documentation is in either of two locations:

Upgrading from 7.1 to 8.0.0 includes the following steps:

  1. Step 1: Pre-Install Instructions
  2. Step 2: Install the upgrade
  3. Step 3: Verify that the upgrade was successful
  4. Step 4: Post-Install Instructions
Step 1: Pre-Install Instructions
  1. Back up your database and the Lifecycle Manager 7.1 application home directory.

    The LM 7.1 to 8.0 upgrade process is a migration to the LM 8.0 as a feature in the Akana Platform. You will follow the Lifecycle Manager 8.0 install guide up to the point of "Step 5: Install and configure the Lifecycle Manager Feature"; in this step, in the Database Wizard, you will choose to use an existing database. At this point, you will provide the relevant connection information to allow the connection to your existing database. You then continue with the steps from the Lifecycle Manager 8.0 install guide. For details, see Install the upgrade below.

  2. Record your current 7.1 application settings. You can do this by noting down the LM /admin console's Settings page values, and/or use the following database query:
    select * from installprops;
  3. Verify that there is enough free disk space on the application server:
    • volume for {platform_home} directories: 1GB
    • volume for /tmp directories: 500MB
    • volume for logs during upgrade: 125MB
  4. Verify that there is enough available space on the database tablespaces for a data upgrade:
    • There should be at least 15% free space in each Lifecycle Manager tablespace.
  5. Increase the number of application logs in your logging pool. Depending on the number of assets in your installation, the version 8.0 upgrade process doesn't contain any data upgrades, so there should be minimal log activity during the initial startup of the application. However, Akana typically recommends increasing the number of logs to at least 25. For details, refer to information about the Installation Admin command SetLoggingConfig in the Lifecycle Manager System Admin guide. After the upgrade, you can reset the number of logs in the pool to your steady-state operational level.
  6. App_%.log file locations when upgrading: as the LM 7.1 logging configuration is in the database, the LM app logs still persist in the pre-defined location (typically in [lm_home]/logs/webapp). Because of this, when installing Lifecycle Manager 8.0, the old LM 7.1 logging location directory must still exist, to ensure that any DataUpgrade entries are captured. After a successful upgrade, you can alter the logging configuration to adjust the location to the OSGi standard of [platform_home]/instances/[instance_name]/log.
  7. Conditional, certificate setup: When LM is using HTTPS (or is behind a front-facing device using HTTPS), and/or when LM needs to use LDAPS, or integrates with another system using certificates (such as the Akana Platform), those certificates must be trusted by the Akana Platform JRE's default trust store ({platform_home}/jre/lib/security/cacerts). Use the JRE keytool command to trust the various certificates, per the steps in Setting up LDAP over SSL in the Lifecycle Manager System Admin Guide.
Step 2: Install the upgrade

The only difference for the upgrade scenario is that when you're configuring the Lifecycle Manager feature for the database, you'll choose to use an existing database vs creating a new database. In the upgrade scenario, you'll point to your existing Lifecycle Manager 7.1 database.

The steps are summarized below:

  1. Step 1: Gather ZIP files and download to the install folder
  2. Step 2: Unzip installation files in the correct sequence
  3. Step 3: Run Configurator to configure Lifecycle Manager container
  4. Step 4: Start the Lifecycle Manager instance
  5. Step 5: Install and configure the Akana Lifecycle Manager Application feature. In this step, rather than creating a new database, you'll point to the existing LM 7.1 database.
  6. Step 6: Extract javaclients.zip file and specify the URL in the configuration settings
  7. Step 7: Update the Lifecycle Manager configuration settings
  8. Step 8: Create a Lifecycle Manager Library
Step 3: Verify that the upgrade was successful
  • Review the log files for any error messages.
  • Verify the upgrade by logging on to the Lifecycle Manager admin console:
    • http://{web.server.url.host}/contextroot/admin/mainMenu.do
    • Verify that the Build number is 8.0.0.x.
Step 4: Post-Install Instructions
  • Navigate to the LM /admin console, then verify and update any settings as appropriate.
  • Execute the following command (via the LM /admin console > Execute Command):
    Fully Qualified Command Class Name: ClearAllUserUIProperties
    Library:[choose each library]
    Click [Invoke]
  • Have each user upgrade the Repository Client (if it's installed) with the 8.0 version.

back to top