Fortinet white logo
Fortinet white logo

EMS Administration Guide

Upgrading from an earlier FortiClient EMS 7.4 version

Upgrading from an earlier FortiClient EMS 7.4 version

Caution

FortiClient EMS 7.4.5 only supports upgrade from earlier 7.4 versions (see FortiClient and EMS Upgrade Path). If your current EMS version is 7.2 or earlier, see Migrating EMS 7.2 to 7.4.5.

  • EMS 7.4.5 only supports FortiClient 7.4 and 7.2. You must first upgrade older FortiClient versions to 7.4 or 7.2 before upgrading EMS to 7.4.5.
  • Internet access is required for the upgrade process. Do not attempt the upgrade if there are network restrictions. We recommend temporarily allowing all Internet access during the upgrade window.
To upgrade your standalone EMS with a local DB or remote DB without docker from an earlier 7.4 version to 7.4.5 or to upgrade your EMS VM from 7.4.3 or earlier to 7.4.5:
  1. Back up the EMS database. Consider performing a full server backup if possible.

  2. Download the forticlientems_7.4.5.2111.M.arm64.bin or forticlientems_7.4.5.2111.M.amd64.bin file from the Fortinet Support site.
  3. Check the current size of /opt/forticlientems :
    du -hs /opt/forticlientems
  4. Ensure that /tmp has enough free space to hold /opt/forticlientems. Otherwise, the upgrade will fail.
    df -h /tmp
  5. Run sudo -i to log in to the shell with root privileges.
  6. Change permissions and add execute permissions to the installation file:
    chmod +x forticlientems_7.4.5.2111.M.XXX64.bin
  7. Run the following command to install EMS:
    ./forticlientems_7.4.5.2111.M.XXX64.bin -- --allowed_hosts '*' --enable_remote_https

    Run the installer to and from any directory other than /tmp. Running the installer to or from /tmp causes issues.

To upgrade your EMS VM from 7.4.4+ to 7.4.5:
  1. Back up the EMS database. Consider taking a VM snapshot if possible.

  2. Download the forticlientems_7.4.5.2111.M.arm64.bin or forticlientems_7.4.5.2111.M.amd64.bin file from the Fortinet Support site.
  3. Run the following command in the emscli to upgrade EMS:

    • To upgrade EMS by executing the installation file from the remote machine:

      execute upgrade ems --remote.file <file_path> --remote.ip <IP address or FQDN> --remote.user <username> --remote.password <password>
      Note

      Replace <file_path> with the actual path of the .bin file, such as /home/ems/Downloads/forticlientems_7.4.5.2111.M.XXX64.bin.

      Replace the values of remote.ip, remote.user, and remote.password with the IP address or FQDN, username, and password of the remote machine.

    • To upgrade EMS by executing the installation file from the local host, copy the installation file from the remote machine to the local host (using execute scp) and then upgrade EMS using the following command:

      execute upgrade ems --local.file forticlientems_7.4.5.2111.M.XXX64.bin

Upgrading from an earlier FortiClient EMS 7.4 version

Upgrading from an earlier FortiClient EMS 7.4 version

Caution

FortiClient EMS 7.4.5 only supports upgrade from earlier 7.4 versions (see FortiClient and EMS Upgrade Path). If your current EMS version is 7.2 or earlier, see Migrating EMS 7.2 to 7.4.5.

  • EMS 7.4.5 only supports FortiClient 7.4 and 7.2. You must first upgrade older FortiClient versions to 7.4 or 7.2 before upgrading EMS to 7.4.5.
  • Internet access is required for the upgrade process. Do not attempt the upgrade if there are network restrictions. We recommend temporarily allowing all Internet access during the upgrade window.
To upgrade your standalone EMS with a local DB or remote DB without docker from an earlier 7.4 version to 7.4.5 or to upgrade your EMS VM from 7.4.3 or earlier to 7.4.5:
  1. Back up the EMS database. Consider performing a full server backup if possible.

  2. Download the forticlientems_7.4.5.2111.M.arm64.bin or forticlientems_7.4.5.2111.M.amd64.bin file from the Fortinet Support site.
  3. Check the current size of /opt/forticlientems :
    du -hs /opt/forticlientems
  4. Ensure that /tmp has enough free space to hold /opt/forticlientems. Otherwise, the upgrade will fail.
    df -h /tmp
  5. Run sudo -i to log in to the shell with root privileges.
  6. Change permissions and add execute permissions to the installation file:
    chmod +x forticlientems_7.4.5.2111.M.XXX64.bin
  7. Run the following command to install EMS:
    ./forticlientems_7.4.5.2111.M.XXX64.bin -- --allowed_hosts '*' --enable_remote_https

    Run the installer to and from any directory other than /tmp. Running the installer to or from /tmp causes issues.

To upgrade your EMS VM from 7.4.4+ to 7.4.5:
  1. Back up the EMS database. Consider taking a VM snapshot if possible.

  2. Download the forticlientems_7.4.5.2111.M.arm64.bin or forticlientems_7.4.5.2111.M.amd64.bin file from the Fortinet Support site.
  3. Run the following command in the emscli to upgrade EMS:

    • To upgrade EMS by executing the installation file from the remote machine:

      execute upgrade ems --remote.file <file_path> --remote.ip <IP address or FQDN> --remote.user <username> --remote.password <password>
      Note

      Replace <file_path> with the actual path of the .bin file, such as /home/ems/Downloads/forticlientems_7.4.5.2111.M.XXX64.bin.

      Replace the values of remote.ip, remote.user, and remote.password with the IP address or FQDN, username, and password of the remote machine.

    • To upgrade EMS by executing the installation file from the local host, copy the installation file from the remote machine to the local host (using execute scp) and then upgrade EMS using the following command:

      execute upgrade ems --local.file forticlientems_7.4.5.2111.M.XXX64.bin