Upgrade to the Latest CR Release

This section describes how to upgrade to the Layer7 API Developer Portal release 3.5 CR17 from release 3.5 or higher. Before you apply an upgrade patch, we recommend that you back up your existing Layer7 API Developer Portal. For more information, see Back Up and Restore API Portals.
apidp35
This section describes how to upgrade to the Layer7 API Developer Portal release 3.5 CR17 from release 3.5 or higher. Before you apply an upgrade patch, we recommend that you back up your existing Layer7 API Developer Portal. For more information, see Back Up and Restore API Portals.
You do not need to disable replication on master and slave API Portals before applying a Layer7 API Developer Portal cumulative release. Run the upgrade script on all the master and slave API Portals. For more information, see Upgrading replicated API Portal.
Layer7 API Developer Portal upgrade patches are available from the Layer7 API Developer Portal Solutions and Patches page.
Install the Upgrade Pack on Layer7 API Developer Portal
To install the upgrade pack:
  1. Open a root shell on the Layer7 API Developer Portal.
  2. Copy the
    upgrade-v3.5.CR17.sh
    and
    v3.5.CR17.tgz
    files to the
    /opt/Deployments/lrs
    directory.
  3. Navigate to the
    /opt/Deployments/lrs
    directory.
  4. Run the following command and follow the on-screen instructions:
    sh upgrade-v3.5.CR17.sh <dbUsername> <dbPassword> <dbHost>
    If no arguments are provided, then
    lrs
    is assumed for both
    <dbUsername>
    and
    <dbPassword>
    and
    localhost
    is assumed for
    <dbHost>
    .
    During script run, you are prompted for the Portal administrator username and password for cmspatch installation.
If Layer7 API Developer Portal is localized, also perform the following step:
  • Re-localize your Portal by running the following:
    <portal_fqdn>/staging/internal/localise-site/en,fr,ja?default=en
    where
    <portal_fqdn>
    should be replaced with your Portal's fully qualified domain name, and
    fr
    and
    ja
    with your Portal's current locales.
Install Layer7 API Developer Portal Integration Components on Layer7 API Gateway
For clustered Gateways, run the following steps on all nodes in the cluster.
  1. Copy the following files from the upgrade content pack to the
    /opt/SecureSpan
    directory:
    setup-3.5.CR17.sh
    and
    base-3.5.CR17-package.tgz
    .
  2. Open a privileged shell from the Layer7 API Gateway configuration menu.
  3. Navigate to the
    /opt/SecureSpan
    directory and run the following command:
    sh setup-3.5CR17.sh
Upgrade the Internal Services on the Policy Manager
For clustered Gateways, run the following steps on all nodes in the cluster.
  1. Start the Policy Manager and connect to the API Gateway.
  2. Disable or delete the API Portal Integration and API Data Lens internal services (typically located in the
    /API Portal Integration
    folder).
      Only delete a service if it is no longer required.
  3. Right-click
    API Portal Integration
    and click
    Publish Internal Service
    .
  4. Select
    API Portal Integration Service
    from the
    Select service to publish
    drop-down list.
  5. Click
    Finish
    .
  6. Repeat Steps 3-5 for the API Data Lens Service, if Data Lens APIs are used or are going to be used on the Portal.