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.
For product versions and upgrade paths, see Upgrade Planner.
To upgrade the FIM Add-on to a later version, do the following:
Download the FIM add-on software binary from the Pivotal Network to your local machine.
SSH into the Pivotal Operations Manager VM. For how to do this, see SSH into Ops Manager.
To retrieve the current runtime config file for editing, run the following command:
bosh -e BOSH-ENVIRONMENT runtime-config --name fim > /tmp/fim.yml
$ bosh -e my-env runtime-config --name fim > /tmp/fim.yml
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:
$ cp -i ~/.ssh/my-key.pem ~/Downloads/fim-1.2.23.tgz email@example.com:
Upload the latest FIM release, run the following command:
bosh -e BOSH-ENVIRONMENT upload-release PATH-TO-NEW-FIM-RELEASE
bosh -e my-env upload-release ~/fim-1.2.23.tgz
Edit the FIM runtime config to set the new release version.
For example, edit the version number in
releases: - name: fim version: 1.2.23
Verify that your FIM runtime config includes an
addonelement 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.
To update the runtime config, run the following command:
bosh -e BOSH-ENVIRONMENT update-runtime-config --name=fim /tmp/fim.yml
bosh -e my-env update-runtime-config --name fim /tmp/fim.yml
(Optional) Verify that your runtime configuration changes match what you specified in the manifest file.
bosh -e BOSH-ENVIRONMENT runtime-config --name fim
$ 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 ...
Navigate to the Installation Dashboard in Ops Manager.
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.
Click Apply Changes.