How to install Interaction History

  1. Install Chocolatey. Chocolatey is the package manager used in Interaction History, and is mandatory to install Interaction History.
    1. Access the URL https://chocolatey.org/install#individual.
    2. Follow the steps to install Chocolatey.
  2. Install Chocolatey dependencies.
    1. Open a Windows command line with the option Run as administrator.
    2. Install the Chocolatey dependencies. Run the following command to install Chocolatey dependencies:

      choco upgrade chocolatey-core.extension

  3. Check the PowerShell version. The installation only runs if you have PowerShell version 5.1 or higher.
    1. Open the Windows PowerShell as an administrator.
    2. Check the PowerShell version. Execute the following command:

      Get-Host | Select-Object Version

      The command returns the version of PowerShell you are using. For example:

      Version

      -------

      5.1.19041.1320

  4. Start the installation.
    1. Log in to Windows using a Windows account with administrative privileges.
    2. Get the Interaction History installation package. For example, get the following files for update 8.7.2000:
      • Altitude_8.7_1_to_2000.Windows.Interaction History.zip
    3. Extract the zip file.
    4. Create a folder that will act as the local repository for future versions of Interaction History. For example, create the folder C:\InteractionHistoryInstall.
    5. Extract the file InteractionHistory.zip to the folder C:\InteractionHistoryInstall.
  5. Install Interaction History.

Tip

To simplify other installations of Interaction History, for example, when upgrading to a newer version, you can enter the following commands into a .bat file and run the .bat file when needed.
  1. Open PowerShell with the option Run as administrator.
  2. Run the choco upgrade command with the following parameters:
    • --source: Enter the path to the folder where the .nupkg files are located. For example, C:\InteractionHistoryInstall\.
    • instanceAddress: Enter the IP address or host name, and port, of the Altitude uCI Server. For example, localhost:1500.
    • integrationServerBaseUri: Enter the HTTPS URL to the base URI of the Integration Server. For example, https://ccserver.mycompany.com/uagentweb8.
    • userSystem: Enter the user name with administrative privileges and the advanced user right Log on as a service. If empty, Interaction History uses LocalSystem.
    • userPassword: Enter the password of the user with administrative privileges and the advanced user right Log on as a service. If empty, Interaction History uses LocalSystem.
    • targetDir: Enter the folder where you want to install Interaction History. For example, C:\InteractionHistoryApp.
    • httpPort: Enter the HTTP port to access Interaction History. For example, 3021.

    choco upgrade altitude.interactionhistory.install --source='C:\InteractionHistoryInstall\;chocolatey' -y --params="/instanceAddress=localhost:1500 /integrationServerBaseUri=http://10.10.1.1/uAgentWeb8/ /userSystem= /targetDir='C:\InteractionHistoryApp' /httpPort=3021"

  1. Configure a CORS policy in the Integration Server configuration file.
    1. Open the configuration file. By default, the file Web.config is located at C:\Program Files\Altitude\Altitude uCI 8\Altitude Integration Server\Web\.
    2. Locate the key restApi.
    3. Add or edit the key allowAnyOrigin, and set the value to true.

      <restApi>

        <authenticationTokenProvider>

        </authenticationTokenProvider>

        <corsPolicy>

          <allowAnyOrigin>true</allowAnyOrigin>

        </corsPolicy>

      </restApi>

    4. Save and close the configuration file.