LATEST VERSION: 1.3.4 - RELEASE NOTES
File Integrity Monitoring Add-on for PCF v1.3.4

Upgrading the FIM Add-on for PCF

Page last updated:

This topic describes how to upgrade the File Integrity Monitoring Add-on for PCF (FIM Add-on).

For example, read this topic to learn how to upgrade from FIM Add-on v1.2.17 to v1.2.23.

IMPORTANT: If you are deploying any product tiles that use Xenial stemcells, you must upgrade the FIM Add-on for PCF to v1.2.22 or later.

Prerequisites

Verify that you have the correct component versions for the version of FIM Add-on that you are upgrading to. See the Features Snapshot or the download page on Pivotal Network.

Upgrade FIM Add-on

To upgrade the FIM Add-on to a later version, do the following:

  1. Download the FIM add-on software binary from the Pivotal Network to your local machine.

  2. SSH into the Ops Manager VM. For how to do this, see SSH into Ops Manager.

  3. To retrieve the current runtime config file for editing, run the following command:

    bosh -e BOSH-ENVIRONMENT runtime-config --name fim > /tmp/fim.yml
    

    For example:

    $ bosh -e my-env runtime-config --name fim > /tmp/fim.yml
  4. To copy the software binary to your Ops Manager VM, run the following command:

    scp -i PATH-TO-PRIVATE-KEY fim-VERSION.tgz ubuntu@YOUR-OPS-MANAGER-VM-IP:
    

    For example:

    $ cp -i ~/.ssh/my-key.pem ~/Downloads/fim-1.2.23.tgz ubuntu@192.168.0.2: 
  5. Upload the latest FIM release, run the following command:

    bosh -e BOSH-ENVIRONMENT upload-release PATH-TO-NEW-FIM-RELEASE
    

    For example:

    bosh -e my-env upload-release ~/fim-1.2.23.tgz
  6. Edit the FIM runtime config to set the new release version.

    For example, edit the version number in /tmp/fim.yml as follows:

    releases:
    - name: fim
      version: 1.2.23
    
  7. Verify that your FIM runtime config includes an addon element for both Trusty and Xenial stemcells.

    Your runtime config must contain the following section:

    - name: fim-trusty
      include:
        stemcell:
        - os: ubuntu-trusty
    
    - name: fim-xenial
      include:
        stemcell:
        - os: ubuntu-xenial
    

    For more information about adding this section, see Updating FIM Add-on for PCF to Run with Xenial Stemcells.

  8. To update the runtime config, run the following command:

    bosh -e BOSH-ENVIRONMENT update-runtime-config --name=fim /tmp/fim.yml
    

    For example:

    bosh -e my-env update-runtime-config --name fim /tmp/fim.yml 
  9. (Optional) Verify that your runtime configuration changes match what you specified in the manifest file.

    bosh -e BOSH-ENVIRONMENT runtime-config --name fim
    

    For example:

    $ bosh -e my-env runtime-config --name fim

    This command returns your updated FIM runtime config. For example:

    Acting as user 'admin' on 'micro'
    releases:
    - name: fim
      version: 1.2.23
    addons:
      name: fim
        jobs:
        - name: fim
          release: fim
    ...
    
  10. Navigate to the Installation Dashboard in Ops Manager.

  11. If you are using Ops Manager v2.3 or later, click Review Pending Changes. For more information about this Ops Manager page, see Reviewing Pending Product Changes.

  12. Click Apply Changes.

Create a pull request or raise an issue on the source for this page in GitHub