Pulumi installation and upgrade

This topic describes how to install and upgrade the Connect Pulumi provider.

Prerequisites

This section provides a condensed list of the tools required for working with Connect Pulumi projects.

  • Pulumi CLI version 3.207.0. For details, see the Pulumi website.

  • The Connect Pulumi Provider Plugin.

  • A running Connect server instance and the URL of your Connect server.

  • An access token for authentication. For details, see Manage access tokens.

Install the plugin

This section describes how to install the Connect Pulumi provider plugin.

Note: Ensure that Connect is installed at /opt/MicroFocusConnect or that the MFCONNECT_HOME environment variable is set to the actual installation folder.

The default path value for MFCONNECT_HOME is /opt/MicroFocusConnect. If Connect was not installed as a service on the Pulumi machine using the install_service.sh script, then you must manually set MFCONNECT_HOME to the actual installation folder to connect to a remote instance.

To install the plugin:

  1. Run chmod to make the plugin binary executable.
    chmod +x <absolutePathToPluginDir>/pulumi-resource-mfcpulumiprovider

    For example, chmod +x /opt/MicroFocusConnect/PulumiProvider/plugin/pulumi-resource-mfcpulumiprovider

  2. Run the following command to Install the plugin:
    pulumi plugin install resource mfcpulumiprovider <version> --file <absolutePathToPluginDir>

    For example, pulumi plugin install resource mfcpulumiprovider 26.2.0 --file /opt/MicroFocusConnect/PulumiProvider/plugin

    Note: The plugin version must match the version required by the Connect server. The version string must follow the pattern x.x.x (for example, 26.2.0) and must be the same as the installed version of Connect.

Upgrade the plugin

This section describes how to upgrade the Connect Pulumi provider plugin.

The plugin version must match the version required by the Connect server. The version string must follow the pattern xx.x.x, for example, 26.2.0, and match the installed version of Connect.

To upgrade the plugin:

  1. Remove the existing plugin to avoid conflicts. Run: pulumi plugin rm resource mfcpulumiprovider -y

  2. Make the new plugin binary executable. Run
    chmod +x <absolutePathToPluginDir>/pulumi-resource-mfcpulumiprovider

    For example, chmod +x /opt/MicroFocusConnect/PulumiProvider/plugin/pulumi-resource-mfcpulumiprovider

  3. Install the plugin. Run
    pulumi plugin install resource mfcpulumiprovider <version> --file <absolutePathToPluginDir>.

    For example, pulumi plugin install resource mfcpulumiprovider 26.2.0 --file /opt/MicroFocusConnect/PulumiProvider/plugin.

Note: For Python users, After each upgrade, you must replace the old Python SDK with the newly generated one. For details, see Generate the Python SDK.

See also