Fortinet black logo

Preparing to Upgrade FortiSOAR

Copy Link
Copy Doc ID 0b62b19d-1178-11ed-9eba-fa163e15d75b:687859
Download PDF

Preparing to Upgrade FortiSOAR

We recommend performing the following tasks to prepare for a successful FortiSOAR upgrade:

To prepare for upgrading FortiSOAR (summary):

  • Take a VM snapshot of your current system. Only after you have taken a VM snapshot of your system should you attempt to upgrade FortiSOAR. In case of any failures, these VM snapshots will allow you to revert to the latest working state. Follow the steps mentioned in the documentation of your platform for taking a snapshot and reverting to the current snapshot.
  • Ensure that the playbook appliance has 'Create' and 'Read' permissions on the Widgets module. Playbook appliance is used to install the widgets required by the war room, and if the permissions to the Widgets are not assigned; the required war room widgets will fail to install.
  • Take a backup of your FortiSOAR Built-in connectors' (SSH, IMAP, Database, Utilities, etc.) configuration, since the configuration of your FortiSOAR Built-in connectors might be reset, if there are changes to the configuration parameters across versions.
  • Ensure that the ssh session does not timeout by entering into the screen mode. For more information on how to handle session timeouts, see the Handle session timeouts while running the FortiSOAR upgrade article present in the Fortinet Knowledge Base.
  • Ensure that repo.fortisoar.fortinet.com is reachable from your VM. If you are connecting using a proxy, then ensure that proxy details set are correct using the csadm network list-proxy command and also ensure that repo.fortisoar.fortinet.com is allowed in your proxy. For more information on csadm CLI, see the FortiSOAR Admin CLI chapter in the "Administration Guide."
    Note: In release 7.2.0 update.cybersponse.com has been renamed to https://repo.fortisoar.fortinet.com/. Both these repositories will be available for a while to allow users who are on a release prior to FortiSOAR release 7.2.0 to access connectors and widgets. However, in time, only https://repo.fortisoar.fortinet.com/ will be available.
  • Ensure that you have reviewed the Special Notices chapter in the "Release Notes", so that you are aware of operational and breaking changes made in version 7.2.2.

Preparing to Upgrade FortiSOAR

We recommend performing the following tasks to prepare for a successful FortiSOAR upgrade:

To prepare for upgrading FortiSOAR (summary):

  • Take a VM snapshot of your current system. Only after you have taken a VM snapshot of your system should you attempt to upgrade FortiSOAR. In case of any failures, these VM snapshots will allow you to revert to the latest working state. Follow the steps mentioned in the documentation of your platform for taking a snapshot and reverting to the current snapshot.
  • Ensure that the playbook appliance has 'Create' and 'Read' permissions on the Widgets module. Playbook appliance is used to install the widgets required by the war room, and if the permissions to the Widgets are not assigned; the required war room widgets will fail to install.
  • Take a backup of your FortiSOAR Built-in connectors' (SSH, IMAP, Database, Utilities, etc.) configuration, since the configuration of your FortiSOAR Built-in connectors might be reset, if there are changes to the configuration parameters across versions.
  • Ensure that the ssh session does not timeout by entering into the screen mode. For more information on how to handle session timeouts, see the Handle session timeouts while running the FortiSOAR upgrade article present in the Fortinet Knowledge Base.
  • Ensure that repo.fortisoar.fortinet.com is reachable from your VM. If you are connecting using a proxy, then ensure that proxy details set are correct using the csadm network list-proxy command and also ensure that repo.fortisoar.fortinet.com is allowed in your proxy. For more information on csadm CLI, see the FortiSOAR Admin CLI chapter in the "Administration Guide."
    Note: In release 7.2.0 update.cybersponse.com has been renamed to https://repo.fortisoar.fortinet.com/. Both these repositories will be available for a while to allow users who are on a release prior to FortiSOAR release 7.2.0 to access connectors and widgets. However, in time, only https://repo.fortisoar.fortinet.com/ will be available.
  • Ensure that you have reviewed the Special Notices chapter in the "Release Notes", so that you are aware of operational and breaking changes made in version 7.2.2.