IBM Cloud Docs
Installing the IBM Power Virtual Server CLI plug-in

Installing the IBM Power Virtual Server CLI plug-in


IBM Power Virtual Server in IBM data center

IBM Power Virtual Server Private Cloud in Client location


To install, update, or view the IBM Power Virtual Server CLI plug-in, complete the following steps:

  1. Install the IBM Cloud® CLI.

  2. Install or update the power-iaas plug-in.

    To install:

    ibmcloud plugin install power-iaas
    

    To update:

    ibmcloud plugin update
    

    To view your installed plug-ins and versions:

    ibmcloud plugin list
    
  3. Log in to the IBM Cloud.

    The power-iaas command-line plug-in uses the region that ibmcloud login targets to determine the IBM Power Virtual Server endpoint. For example, to use the IBM Power Virtual Server endpoint https://cloud.ibm.com you must use the ibmcloud login -a https://cloud.ibm.com command to target the us-east region. If you have a federated account, use the following command:

    ibmcloud login -a https://cloud.ibm.com -sso
    
  4. Run one of the following commands to list all the services under your account:

    • For IBM Power Virtual Server in IBM data center, run the ibmcloud pi ws ls command. The Cloud Resource Name (CRN) under ID contains your Tenant ID and Cloud Instance ID. The following example shows a typical CRN:
    crn:v1:staging:public:power-iaas:us-east:a/abcdefghijklmnopqrstuvwxyzabcdef:121d5ee5-b87d-4a0e-86b8-aaff422135478::
    
    • For IBM Power Virtual Server Private Cloud in Client location, run the ibmcloud pi ws ls -p command.
  5. Target your service by entering ibmcloud pi ws tg <CRN> command:

    • Following is an example of the output for IBM Power Virtual Server in IBM data center:
    ibmcloud pi ws tg crn:v1:staging:public:power-iaas:us-east:a/abcdefghijklmnopqrstuvwxyzabcdef:121d5ee5-b87d-4a0e-86b8-aaff422135478::
    
    • Following is an example of the output for IBM Power Virtual Server Private Cloud in Client location:
    ibmcloud pi ws tg crn:v1:staging:public:power-iaas:satloc_dal_clp3foc20dd82387pe83:a/c7e6bd2517ad44eabbd61fcc25cf68d5:dc815dc0-e0ba-4576-b286-a3aeedaa9e60::
    

The IBM Power Virtual Server CLI plug-in requires a valid IAM token authorization before each use. Use the ibmcloud login command to renew authorization if your token expires.