Upgrading the Azure IoT Hub Connector from 4.3.0 to 4.3.1

Upgrading the Azure IoT Hub Connector > Upgrading the Azure IoT Hub Connector from 4.3.0 to 4.3.1

This topic explains how to upgrade an Azure IoT Hub Connector from version 4.3.0 to version 4.3.1.

Prerequisites

These instructions assume:

• ThingWorx Platform v.9.3 is already installed.

• Azure IoT Hub Connector v.4.3.0 is correctly installed, including appropriate versions of the Connection Services Extension and Azure IoT Hub Connector Extension.

If any of these prerequisites are not met, follow the appropriate upgrade articles for ThingWorx and Azure IoT Hub Connector before performing this upgrade..

Pre-upgrade Validation

Before you begin, ensure that your current installation is running properly by performing these steps:

1. Upload a file to the Azure Blob Storage Container in Azure using any manner you deem appropriate.

2. From ThingWorx Composer, navigate to the Thing representing your AzureBlobStorageContainerFileRepository.

3. Click the Services tab and run the BrowseFileSystem on it to verify that the file is visible from ThingWorx.

4. From that Services page, run the WriteToTextFile to verify file creation from the ThingWorx Platform.

5. From the Services page, run GetFileListingWithLinks or GetDirectFileDownloadURL to verify file download capabilities.

Best Practices for Upgrading

1. Export your Azure-related entities as a backup through the Composer Import/Export interface.

2. Perform ThingWorx Platform upgrades as necessary. (see Upgrading ThingWorx for more details)

The rest of this topic explains how to upgrade a ThingWorx Azure IoT Hub Connector from version 4.3.0 to version 4.3.1.

Downloading the Distribution Bundle

To download the distribution bundle for your operating system, follow these steps:

1. Go to the PTC Support site, Software Download page.

2. Select the Product Family, THINGWORX CONNECTION SERVICES.

3. On the download page for the ThingWorx Connection Services Product Family, the releases are numbered by the related release of ThingWorx Platform. To upgrade, expand the Release 9.x node.

4. Expand the node, ThingWorx Azure IoT Hub, and then the node, Most Recent Datecode.

5. Click HTTPS to download the distribution bundle.

6. Extract the downloaded file to an appropriate location.

Upgrading the Extensions

The extensions in the ThingWorx Azure IoT Hub Connector distribution bundle, the Azure IoT Extension and the Connection Services Extension (CSE), have been upgraded for this release.

Using ThingWorx Composer, import the new version of the Azure IoT Hub Adapter Extension, v.4.3.1, and the Connection Services Extension (CSE) version 2.3.0 into the ThingWorx Platform.

For step-by-step instructions for importing the extensions, refer to Step 3. Import the Extentions

Performing the Azure IoT Hub Connector Upgrade

Upgrading the Azure IoT Hub Connector involves installing a new instance of the Connector. Upgrading the Connector also means importing the new versions of the extensions in your ThingWorx Azure IoT Hub Connector distribution bundle into your ThingWorx Platform. Before you begin the upgrade:

• Copy the existing installation configuration to the new installation.

After importing the Azure IoT Extension v.4.3.1 into the ThingWorx Platform:

1. Re-run the permissions services, as explained in Run the Service to Grant Permissions and Visibility to the Connector. The required permissions are not automatically re-applied to any modified/updated entities and this step ensures all entities have the expected permissions after upgrade.

2. As needed, create any new security entities that you may need. For assistance, refer to Create Security Entities for the Connector.

3. Ensure that the extensions provided with the Azure IoT Hub Connector, v.4.3.1, have been imported to the ThingWorx Platform. For example, from ThingWorx Composer, browse Thing Templates and look for the AzureIotThing Thing Template, the AzureIotHubTemplate Thing Template, and the AzureBlobStorageTemplate Thing Template.

4. If you have not already done so, shut down the v.4.3.0 Azure IoT Hub Connector.

5. Start the v.4.3.1 Azure IoT Hub Connector. For assistance, refer to Start the Azure IoT Hub Connector..

6. Verify that the Azure IoT Hub Connector successfully connected to ThingWorx by confirming it appears in the ThingWorx Composer list of Connection Servers and shows "Running" at the top. To access this page follow these steps:

a. In the left navigation panel of ThingWorx Composer, click the

icon (Monitoring menu).

b. Select Connection Servers to display the page.

7. Run the Smoke Test, as explained in Running the Smoke Test.

Testing the Installation

After upgrading the Azure IoT Hub Connector, test that your current installation is running properly by performing these steps:

1. Upload a file to the Azure Blob Storage Container.

2. From ThingWorx Composer, navigate to the Thing representing your Azure Blob Storage container.

3. Click the Services tab and run the BrowseFileSystem on it to verify that the file is visible from ThingWorx.

4. From the Services page, run GetFileListingWithLinks or GetDirectFileDownloadURL to verify file download capabilities.