Upgrading SOTI Assist

Before you begin

Note: Ensure your system continues to meet the minimum requirements necessary for SOTI Assist. Those requirements may have changed since you installed your previous version of SOTI Assist. Read System Requirements for more information.

SOTI MobiControl should be running during the installation and your computer must have access to the SOTI MobiControl database.

About this task

SOTI Assist will automatically create the Default group and retain the incidents that exist in the system. The current SOTI MobiControl integration will remain intact. The current SLAs will migrate over to the new version with the default Working Hours definition called "24/7."

To upgrade SOTI Assist.

Procedure

  1. On https://docs.soti.net/soti-assist/downloads, download the SOTI Assist installer and copy it to the server on which you want to upgrade SOTI Assist.
  2. Read the SOTI Assist license agreement and accept the terms to continue with the installation.
    SOTI Assist installer end user license agreement screen

    Click Next.

  3. Review the SOTI Assist system requirements and ensure that your system is compliant.
    SOTI Assist installer system requirements screen

    Click Next.

  4. Select the features you want to be installed with SOTI Assist.
    Note: Include features even if they're already installed. If you deselect an installed feature, the installation wizard will uninstall that feature.
    SOTI Assist installer features screen

    Click Next.

  5. Select the destination folder where you want to install SOTI Assist.
    SOTI Assist installer installation folder screen

    Click Next.

  6. Enter information about the SOTI Assist database server.
    Note: The database connection is based on the login properties you provide. Ensure that the login is configured on the database server to include the 'dbcreator' role (or higher).
    SOTI Assist installer database screen
    Server Enter the database server.
    Connect Using Select whether to connect to the database using Windows authentication or SQL Server authentication. If you select SQL Server authentication, enter the corresponding username and password below. Selecting SQL Server authentication enables the SOTI Assist service to be installed under Local System.
    Username Enter the username used to connect to the database when SQL Server authentication is used.
    Password Enter the password used to connect to the database when SQL Server authentication is used.

    Click Next.

  7. Specify whether you want SOTI Assist to use a single database or multiple databases, and provide an optional database name prefix.
    SOTI Assist installer multi-database screen
    Deploy and run migration tool Select this option to speed up the installation process when deploying servers and when SOTI Assist databases already exist. It's recommended that you leave this option enabled.
    Deployment Method Select whether you want one database or multiple databases to be created for SOTI Assist.

    By default, one SOTI Assist database will be created. If you select the option for multiple databases, one database will be created for each SOTI Assist microservice.

    Database Name Prefix [Optional] Enter a prefix for the default database name or names. This enables you to have multiple SOTI Assist instances use a single instance of SQL Server.

    If you leave this field empty, each database will be given a default name. If you enter a value in this field, the value is prefixed to the default database name.

    Click Next.

  8. Select the network account under which you want to run the SOTI Assist service.
    SOTI Assist installer network account screen
    Host Enter the hostname of the SOTI Assist instance.
    Domain Enter the domain of the SOTI Assist instance.
    Port Enter the port of the SOTI Assist instance.
    Local System Account Select this option to run the SOTI Assist service under the Local System account. To enable this option, you must select SQL Server authentication in the SOTI Assist Database Connection panel.
    This Account Select this option to run the SOTI Assist service under the currently logged-in account. The installer will automatically grant the current user the required 'Log on as a service' right when this option is selected.
    Password Enter the password required for the above account.

    Click Next.

  9. Verify the SOTI Assist and Public URL settings.
    SOTI Assist installer host URL screen
    Host URL The host URL for SOTI Assist. It is non-editable.
    Use Host URL as Public URL Choose this option to automatically use the host URL as the Public URL.
    Public URL Enter new Public URL if the URL to access SOTI Assist differs from the host URL, as it might in load balanced environments.

    Be careful editing this value as it can impact access to SOTI Assist.

    Click Next.

  10. Specify the file storage locations for attachments, downloads, and videos produced by the SOTI Assist instance.
    SOTI Assist installer Media Storage Locations screen
    Default Storage Locations Use the default storage locations for attachments, downloads, and video recordings.
    Custom Storage Locations Enter custom locations to save attachments, downloads and video recordings.

    In load balanced environments, choose locations that are accessible by all servers.

    Click Next.

  11. Enter information about the SOTI MobiControl instance with which you are integrating SOTI Assist.
    SOTI Assist installer SOTI MobiControl integration screen
    SOTI MobiControl URL Enter the URL of the SOTI MobiControl instance.
    Local Access SOTI MobiControl URL Enable Local Access SOTI MobiControl URL and enter a URL for a local SOTI MobiControl instance.

    Use this option to force SOTI Assist to communicate with a specific SOTI MobiControl instance. Recommended in load balanced environments where SOTI Assist and SOTI MobiControl share a server and the public host for the SOTI MobiControl instance cannot be resolved on the computer where SOTI Assist is installed.

    Use this option if the public host for the SOTI MobiControl instance cannot be resolved on the computer where SOTI Assist is installed.

    SOTI MobiControl Client (SOTI Assist) Information

    Generate Automatically Select this option to generate new values for the client ID and client secret.
    Use Client ID Select this option to reuse the existing values for client ID and client secret that are configured in SOTI MobiControl, and enter the client ID value in this field.
    Client Secret Enter the existing client secret value configured in SOTI MobiControl.
    Overwrite the default SOTI MobiControl connection settings When enabled, default SOTI MobiControl connection settings are overwritten by SOTI Assist.

    Click Next.

  12. Enter information about the SOTI MobiControl database server.
    Note: The SOTI MobiControl database must be accessible to the SOTI Assist installer.
    SOTI Assist installer SOTI MobiControl database screen
    Copy Values from SOTI Assist Panel Click this button to copy the corresponding entries from the SOTI Assist Database Connection panel.
    SOTI MobiControl Database Server Enter the SOTI MobiControl database server.
    Connect Using Select whether to connect to the database using Windows authentication or SQL Server authentication. If you select SQL Server authentication, enter the corresponding username and password below.
    SOTI MobiControl Database Username Enter the username used to connect to the SOTI MobiControl database when SQL Server authentication is used.
    SOTI MobiControl Database Password Enter the password used to connect to the SOTI MobiControl database when SQL Server authentication is used.

    Click Next.

  13. Select the database being used by SOTI MobiControl.
    SOTI Assist installer second SOTI MobiControl database screen
    Instance Select the name of the active SOTI MobiControl database from the list.

    Click Next.

  14. This panel reminds you that you will need to manually restart SOTI MobiControl after you have finished installing SOTI Assist.
    SOTI Assist installer SOTI MobiControl deployment server restart screen

    Click Next.

  15. Click Install to begin the upgrade.
    SOTI Assist installer start the install screen

Results

During installation, the SOTI Assist installer automatically communicates the SOTI Assist server URL to SOTI MobiControl. If you need to change the SOTI Assist server URL, see Updating the SOTI Assist Server URL.