Skip to main content

Installing and initializing the XClarity Orchestrator provider in Terraform

To use the Lenovo XClarity Orchestrator provider commands and APIs, you must install the XClarity Orchestrator provider and initialize Terraform.

Before you begin

Ensure that Terraform v0.13 is installed.

Ensure that XClarity Orchestrator v1.3 or later is installed.

Procedure

To install the XClarity Orchestrator provider for Terraform, complete one of the following procedures.

  • Linux
    1. Download and install Terraform from the Download Terraform webpage.
    2. Download the XClarity Orchestrator provider binary from the XClarity Orchestrator downloads webpage.
      Tip
      The binary file is named terraform-provider-lxco_<version>_linux_amd64, where <version> is the provider version. Do not change the file name.
    3. Create the appropriate subdirectory within the user plugins directory for the XClarity Orchestrator provider.
      $ mkdir ~/.local/share/terraform/plugins/lenovo.com/xclarity/lxco/$<version>/linux_amd64
    4. Move the XClarity Orchestrator provider binary to the subdirectory that you just created in the user plugins directory.
      $ mv terraform-provider-lxco_<version>_linux_amd64 
      ~/.local/share/terraform/plugins/lenovo.com/xclarity/lxco/<version>/linux_amd64
    5. Initialize the workspace to refresh the XClarity Orchestrator provider.
      $ terraform init
  • Windows
    1. Download and install Terraform from the Download Terraform webpage.
    2. Download the XClarity Orchestrator provider binary from the XClarity Orchestrator downloads webpage.
      Tip
      The binary file is named terraform-provider-lxco_{version}_windows_amd64.exe, where {version} is the provider version. Do not change the file name.
    3. Create the appropriate subdirectory within the user plugins directory for the XClarity Orchestrator provider.


      mkdir -p %APPDATA%\terraform.d\plugins\lenovo.com\xclarity\lxco\<version>\windows_amd64
    4. Move the XClarity Orchestrator provider binary to the subdirectory that you just created in the user plugins directory.
      move terraform-provider-lxco_<version>_windows_amd64.exe  
      %APPDATA%\terraform.d\plugins\lenovo.com\xclarity\lxco\<version>\windows_amd64
    5. Initialize the workspace to refresh the XClarity Orchestrator provider.
      terraform init