Adding customizations to the application

To customize Maximo® Manage, create a customization archive that contains your changes, add the contents of the archive to a compressed file, and add the updated files to the application when you deploy it.

Before you begin

Before you can add customizations to the application, you must create one or more archive files that contain your changes. Review the customization guidelines for details about the structure to use for the archive and the types of files that you can add. Then, complete the following tasks to create an archive:
  1. Create a directory that has a structure that matches the /SMP/maximo folder structure that is used for Maximo Manage.
  2. Add files that contain your customizations to the archive.
  3. When the archive is complete, add the archive to a compressed file.
  4. Put the compressed file in a location that is accessible to Maximo Manage.
If you use SSL and have a certificate that is not public, ensure that you provide the certificate details before you deploy the application.

About this task

You can add a single archive, or you can add multiple archive files in the form of a list. Because customization archive files are processed in sequential order, if you add multiple files, ensure that they are specified in the order that you want to process them.

Adding customizations by using the Maximo Application Suite user interface

You can add a single customization archive through the Maximo Application Suite user interface when you configure Maximo Manage.

Procedure

  1. Log in to Maximo Application Suite as a system administrator.
  2. From the catalog, on the Applications tab, select the Manage tile.
  3. On the application details page, click Actions and select Update configuration.
  4. In the Customization row on the Update Manage configuration window, click the Edit icon.
  5. In the Customization section of the configuration window, specify the URL for the customization archive file.
    The following URL protocols are supported: HTTP, HTTPS, FTP, and FTPS.
  6. Optional: If you applied password security to the file, in the Credentials field, specify the user ID and password in the following format:
    user=your user name
    password=your password
  7. After you complete all configurations, select one of the following options:
    • If you are configuring a new deployment, click Activate.
    • If you are updating a deployment, click Apply changes.

Adding customizations manually to the custom resource

To add multiple customization archives to Maximo Manage, manually configure the custom resource for the Maximo Manage workspace.

About this task

If you use both the customization and the customizationList properties, the archive that you add to the customization property is processed last. When you specify a customization list, ensure that list the files in the order that you want to process them.

Procedure

  1. In the OpenShift® Container Platform console, in the Administration section, select Custom Resource Definitions.
  2. In the CustomResourcesDefinitions window, select the ManageWorkspace custom resource definition record.
  3. In the CustomResourceDefinition details window, on the Instances tab, select the instance that you want to update.
  4. On the YAML tab for the instance, in the spec.settings section, specify values for the secret name for the archive credentials, the archive name, and the archive URL for each customization archive that you want to add, as shown in the following example:
    
      settings:
        customizationList:
          - customizationArchiveCredentials:
              secretName: customization-secret-name
            customizationArchiveName: archive2
            customizationArchiveUrl: >-
              https://url/path_to_customization_archive/CustomArchive.zip
          - customizationArchiveCredentials:
              secretName: customization-secret-name
            customizationArchiveName: archive1
            customizationArchiveUrl: >-
              https://url/path_to_customization_archive/CustomArchive.zip
  5. Save the custom resource.