Installing OHS

The following steps are to be completed by a system administrator on the server where the collection system is installed. If the collection system is hosted by Itron, then the Itron Managed Services team will complete these steps. If the collection system is on-premises at the customer's site, then the customer system administrator or Itron delivery personnel will complete these steps.

  1. Request the following information from the Itron Managed Services team (cnods@itron-hosting.com) for the given tenant and record the values:

    • ClientDetails.zip file and password

    • Tenant ID

    • Tenant Service Bus NamespaceUri

    • SasTokenConfigId

    • SasTokenKey

  2. Request the creation (or verification) of a local administrator user with permissions to edit the file system. This user will run OHS to establish domain credentials between OHS and the on-premises collection engine and must be able to login and access the collection system machine.

  3. Verify Microsoft .NET Framework 4.6.1 is installed on the OHS destination machine.

    Tip: For more information about verifying .NET Framework versions, see How to: Determine which .NET Framework versions are installed.

  4. Verify ports 7001, 7002, and 7003 are open on the OHS destination machine to receive WCF messages from a service on the same machine.

    Important! These ports are customizable, but using ports other than the default 7001, 7002, and 7003 requires working with the Itron Managed Services team to ensure the Itron Analytics database is configured properly.

  5. Verify ports 5671 and 5672 are open to TCP traffic on the OHS destination machine to communicate with the IHC service.

  6. Download the latest OHS installer for your collection system.

    1. Navigate to portal.itrontotal.com and sign in using your credentials.

    2. Verify you are on the tenant you want to configure.

    3. Complete the Creating and Configuring a New OHS Instance procedure from the OHS Help. Verify the following applications are added to the tenant (or add them if necessary).

      • For the data source, select the appropriate collection system.

      • For the outcome, select Itron Analytics (and Distributed Intelligence, if applicable).

  7. Create the folder where you will drop files for processing.

    1. Create a folder in a directory and record the file path. The default expected path and name is c:\HybridConnectorFileTransfers, but it can be customized.

    2. Configure the folder as a shared folder.

    3. Allow the domain user to have read/write access to the folder.

  8. Complete the Installing OHS on Your Local Host procedure from the OHS Help.

    • For the file location, select the folder where you will drop files for processing.

  9. (Fixed Network only) Modify the Platform.IHC.OHS.exe.config file for your Fixed Network installtion.

    1. Using a text editor, open the downloaded Platform.IHC.OHS.exe.config that came in the installer zip folder.

      1. Replace all instances of {FIXEDNETWORK MACHINE} with the name of the local machine.

      2. Replace all instances of {TENANT NAME} with the tenant short name provided by the Itron Managed Services team. For example, DDP. See step 1 of Installing OHS.

      3. Replace {NCE USER} with the username of the domain user. See step 2 of Installing OHS.

      4. In <add key="Password" value="" />, type the password of the domain user as the value. See step 2 of Installing OHS.

      5. Replace {CERT Thumbprint} with the certificate thumbprint for the local machine.

    2. Save the file.

    3. Navigate to the OHS installation folder path. The default path is C:\Program Files\Platform.IHC.

    4. Replace the default Platform.IHC.OHS.exe.config file with the modified file from the installer zip folder.

  10. Complete the Validating Successful Installation procedure from the OHS Help.

  11. Navigate to the folder where you will drop files for processing and verify that it contains a folder architecture with \<tenantID>\file-uploads\<FileType> Files.

    This folder architecture was created by settings in the JSON file when the Itron On-Premises Hybrid Service was started.

OHS is now ready to be used. For more information, see Uploading files using OHS. If OHS requires troubleshooting, see Troubleshooting OHS.