Configuring the image stitching service in Maximo Civil Infrastructure 8.6

Starting in Maximo® Civil Infrastructure 8.6, the image stitching service is available. As an administrator, you create a persistent volume claim record for the stitching image service in Maximo Manage. You edit the custom resource definition to include the persistent volume claim for the stitching service in the Red Hat® OpenShift® Container Platform console. You also configure the system properties that are related to the stitching image service.

Before you begin

The integration between Maximo Civil Infrastructure and Maximo Visual Inspection must be configured. For more information, see Integrating Maximo Civil Infrastructure with IBM Maximo Visual Inspection

If you are using Maximo Civil Infrastructure 9.0 and later, see Configuring the image stitching service in Maximo Civil Infrastructure 9.0

About this task

The following table describes the system properties that are used for the Defect detection application:
Table 1. System properties for the Defect detection application
Property Description
civil.maximo.apikey The API key that is used to authenticate the connection between the Defect detection application and the stitching process.
imagestitching.dataInputPath The directory that is used to store temporary images that are processed by the stitching service.
mci.imagestitching.apiurl The API URL that connects the stitching process to the Defect detection application.

Procedure

  1. In Maximo Application Suite, configure a persistent volume claim for the image stitching service to specify the directory that stores photos. Copy and paste the Mount path value and the PVC name value for the image stitching service into a text editor.
    For more information, see Adding persistent storage parameters to deployments.
  2. In the Red Hat OpenShift Container Platform console, edit the custom resource definition to add a custom property for the image stitching service that was created in Maximo Application Suite to store the photos:
    1. In the Red Hat OpenShift Container Platform console, from the side navigation menu, click Administration > Custom Resource Definitions.
    2. On the CustomResourcesDefinitions page, select the ManageWorkspace custom resource definition.
    3. On the Instances tab, select the relevant deployment instance that you want to update.
    4. On the YAML tab, search for the components section and add the following property to the script:
      Add the imagestitchingpvcname custom property and specify the PVC name of the persistent volume claim that was configured for the image stitching service in Maximo Application Suite.
      components:
  base:
     version: latest
  civil:
     version: latest
     imagestitchingpvcname: PVC name
    5. Click Save.
  3. In Maximo Manage, in the System Properties application, in the Global Properties section, open and set the global values for the following properties:
    Select Global Value
    civil.maximo.apikey Enter the API key that was created in Maximo Manage. For more information about creating API keys, see API Keys application.
    Note: For security reasons, ensure that you refresh the API key every 90 days.
    imagestitching.dataInputPath Enter the mount path that was created as persistent storage for the image stitching service.
    mci.imagestitching.apiurl Enter the URL for the image stitching service.

    To get the URL and the port value for the stitching service:

    • In the Red Hat OpenShift Container Platform console, from the side navigation menu, click Networking > Services and open the stitching instance that was created for persistent storage.
    • On the Service details page of the relevant instance, in the Service routing section, copy the following values into a text editor:
      • The Hostname URL value.
      • In the Service port mapping section, copy the Port value.
    http://Hostname url:Port/maximo/stiching
  4. After the global values are specified, save and refresh the properties.
    1. From the Common Actions menu, click Save Property.
    2. In the Global Properties table, select the checkbox for the property that you set.
    3. From the Common Actions menu, click Live Refresh.
    4. In the Live Refresh dialog, click OK.
    The new value for the property takes effect immediately.