Installing SOTI XSight

Before you begin

The machine where you are installing SOTI XSight must meet the recommended system requirements and must have access to the SOTI MobiControl database (see System Requirements).
Tip: You can load balance SOTI XSight to improve reliability and performance. Run the installation on all the servers you want to include in the load balanced environment. They must all have access to the same database (see Load Balanced Deployments).
Note: To perform a clean install on a system where SOTI XSight is already installed, see Uninstalling SOTI XSight.

Procedure

To install SOTI XSight:
  1. Download the SOTI XSight installer from the Downloads section of the SOTI Technical Documentation website. Copy the installer to the server where you want to install SOTI XSight.
  2. Double-click the installer to start it.
    Important: SOTI MobiControl must be running during the installation of SOTI XSight.
    Double-click the installer executable to run it
    Note: SOTI XSight requires the PowerShell scripting environment. If you see the following error message during the installation process, install PowerShell and continue the installation (see the PowerShell requirements section in System Requirements).
    PowerShell Requirement
  3. Select Next.
  4. Read the SOTI XSight license agreement and accept the terms to continue with the installation.
    Accept the End User License Agreement

    Select Next.

  5. Review the SOTI XSight system requirements and ensure that your system is compliant (see System Requirements.)
    Review the system requirements

    Select Next.

  6. Select the SOTI XSight features you want to install.
    Note: If you do not want the Chat Service installed, deselect here. You can install the Chat Service later by re-running the installer in change/repair mode.
    Select the features

    Select Next.

  7. Select the destination folder for the SOTI XSight installation.
    Select the destination folder

    Select Next.

Enter SOTI XSight database setup information

  1. Enter information about the SOTI XSight database server.
    Note: The database connection uses the login properties you enter. The login for the database server must have dbcreator permission or higher (see SOTI XSight Database Connection).
    Enter the database setup information
    Setting Description
    Server Enter the database server where you want the SOTI XSight databases located.
    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. If you select SQL Server authentication, the SOTI XSight service gets installed under Local System.
    Username Enter an authorized username to connect to the database.
    Password Enter a valid password to connect to the database.

    Select Next.

  2. Enter an optional database name prefix.
    Provide an optional database name prefix
    Setting Description
    Deploy and Run Migration Tool Select this option to speed up the installation process when deploying servers and when SOTI XSight databases already exist. The recommended setting is enabled.
    Database Name Prefix Optional: Enter a prefix for the default database name or names to allow multiple SOTI XSight instances to use a single instance of SQL Server.

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

    Select Next.

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

    Select Next.

  4. Verify the SOTI XSight Host and Public URL settings. See SOTI XSight Host URL and Public URL.
    Verify the host and public URL information
    Setting Description
    Host URL The host URL of SOTI XSight. This 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 a new Public URL to access SOTI XSight if it differs from the host URL, as it might in load balanced environments.

    Use caution when editing this value as it can impact access to SOTI XSight.

    Select Next.

  5. Specify the SOTI XSight Chat service settings (see Location Service).
    Enter the Chat service settings
    Setting Description
    Chat Service Host Enter the hostname of the SOTI XSight Chat instance.
    Chat Service Port Enter the port of the SOTI XSight Chat instance that listens for incoming HTTPS requests.
    Select Next.
  6. Specify the file storage locations for attachments, downloads, and videos produced by the SOTI XSight instance. See SOTI XSight Media Storage Locations.
    Enter the file storage locations
    Setting Description
    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 accessible by all servers.

    Select Next.

  7. Enter the SOTI XSight Agent Service-related settings. The Agent Service communicates over SSL on port 5493. The port is not bound but must be open for the service to start and for SSL communication to commence. The Agent Service status host should be the hostname of the server. The public FQDN can also be an internal FQDN if you are using your devices on the same network as the server. Ensure all router and firewall ports are open for communication (see Agent Service).
    Enter the Agent Service information
    Select Next.
  8. Enter the SOTI XSight Location Service-related settings.
    Configure Live View settings
    Setting Description
    Location Service URL An auto-populated field. The URL where the location service is hosted. Even if location service not being installed on this machine, this is required for configuration purposes and need to be set to the URL where it is/will be installed.
    Location Service Port An auto-populated field. This port opens locally for Location Service to communicate over SSL.
    Location Service Cisco Spaces API Port An auto-populated field. This port opens locally for Location Service to listen to Cisco Spaces device updates.
    Location Service Extreme API Port An auto-populated field. This port opens locally for Location Service to listen to Extreme Networks device updates.
    Location Service Juniper API Port An auto-populated field. This port opens locally for Location Service to listen to Juniper Networks device updates.
    Encryption Certificate Subject Name A certificate used to encrypt columns in the database using SQL Server Always Encrypted. If left blank, a certificate is generated. If a specific certificate is preferred, enter the subject name here.
    Note: These are the initial configuration settings for Location Services and External Data Providers. For detailed customization options, please access the SOTI XSight Administration Utility following the installation (see Using the SOTI XSight Administration Utility).
    Note: If you have an SOTI XSight instance with multiple FQDNs configured for SOTI XSight Location Service, the installer detects it and does not allow you to change the configuration settings. These settings can be customizing in the Administration Utility following the installation (see Using the SOTI XSight Administration Utility).
    Note: On a multi-server installation, you must install the Encryption Certificate on all machines. If the Encryption Certificate subject name is left blank, the certificate is generated on the first machine where SOTI XSight is installed. The installer distributes this certificate to the other machines when the installer runs on them. If the Encryption Certificate subject name is specified, the user must ensure the certificate is available on all machines.
    Note: To specify your own certificate, you must ensure the certificate has the following properties:
    • It has a private key.
    • It has the KeyEncipherment KeyUsage attribute
    • The private key has the KeyExhange key spec.
  9. Enter information about the SOTI MobiControl instance with which you are integrating SOTI XSight. See SOTI MobiControl Integration.
    Enter the MobicControl Integration settings
    Setting Description
    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 of a local SOTI MobiControl instance.

    Use this option to force SOTI XSight to communicate with a specific SOTI MobiControl instance. Recommended in load balanced environments where SOTI XSight and SOTI MobiControl share a server, and the public host for the SOTI MobiControl instance cannot be resolved on the computer where SOTI XSight is installed.
    SOTI MobiControl Client (SOTI XSight) Information
    Setting Description
    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 configured in SOTI MobiControl 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 XSight.

    Select Next.

Database settings
  1. Enter the SOTI MobiControl database connection.
    Note: The SOTI MobiControl database must be accessible to the SOTI XSight installer.
    Enter the SOTI MobiControl Database Connection information
    Setting Description
    Copy Values from SOTI XSight Panel Select this button to copy the corresponding entries from the SOTI XSight 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 using SQL Server authentication.
    SOTI MobiControl Database Password Enter the password used to connect to the SOTI MobiControl database when using SQL Server authentication.
    See SOTI MobiControl Database Connection.

    Select Next.

  2. Select the database being used by SOTI MobiControl. See SOTI MobiControl Database Name.
    Enter the SOTI MobiControl database name
    Setting Description
    Instance Select the name of the active SOTI MobiControl database from the list.

    Select Next.

SOTI MobiControl settings
  1. Enter the SOTI MobiControl Account Credentials. These are the credentials used for the Service User account (see System Requirements for details on the SOTI MobiControl permissions required for the Service User account).
    Enter the SOTI MobiControl account name and password
  2. Choose when to restart the SOTI MobiControl deployment server and SOTI XSight services. If you have tasks currently running, you can manually restart them after the installation or you can choose to restart them automatically as part of the installation process (see SOTI MobiControl Restart and Services Status).
    Choose when to restart

    Select Next.

  3. Select Install to begin installing SOTI XSight.
    Start the SOTI XSight installation
    Select Install.
  4. Select Yes in the User Account Control popup panel.
    Select Yes in the User Account Control popup
  5. Wait for the installation process to complete and select Finish.
    Select Finish to complete the installation
Post installation steps
  1. Manually restart the SOTI XSight Management Server service.
    Manually restart the SOTI MobiControl Management Server service
  2. Manually restart SOTI MobiControl Deployment Server service.
    Manually restart the SOTI MobiControl Deployment Server service
  3. In the SOTI XSight Admin Utility, ensure all the SOTI XSight System Health services are running.
    Check the services are running in Admin Utility System Health
  4. In the SOTI XSight Admin Utility, ensure all the SOTI XSight System Status services are running.
    Check the services are running in Admin Utility System Status

Results

The installer has setup SOTI XSight and configured it to work with SOTI MobiControl.

Note: To change the SOTI XSight server URL, see Updating the SOTI XSight Server URL.
Note: Use the SOTI XSight Administration Utility to administer SOTI XSight (see Using the SOTI XSight Administration Utility).