Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 3.99 KB

set-up-cli.md

File metadata and controls

121 lines (83 loc) · 3.99 KB
copyright lastupdated keywords subcollection
years
2017, 2019
2019-04-03
install CLI plug-in, install CLI plugin, update CLI plug-in, update CLI plugin, uninstall CLI plug-in, uninstall CLI plugin, Key Protect CLI plug-in, Key Protect CLI plugin, KMS plug-in, KMS plugin
key-protect

{:shortdesc: .shortdesc} {:codeblock: .codeblock} {:screen: .screen} {:new_window: target="_blank"} {:pre: .pre} {:tip: .tip} {:note: .note} {:important: .important}

Setting up the CLI

{: #set-up-cli}

You can use the {{site.data.keyword.keymanagementservicelong_notm}} CLI plug-in to help you create, import, and manage encryption keys.

To find out more about using the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in, check out the {{site.data.keyword.keymanagementserviceshort}} CLI reference doc. {: tip}

Installing the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in

{: #install-cli}

Before you can set up the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in, install the {{site.data.keyword.cloud_notm}} CLI External link icon{: new_window}.

To install the CLIs:

  1. Install the {{site.data.keyword.cloud_notm}} CLI External link icon{: new_window}.

    After you install the CLI, you can run ibmcloud commands to interact with your cloud services.

  2. Log in to {{site.data.keyword.cloud_notm}}.

    ibmcloud login

    {: pre}

    If the login fails, run the ibmcloud login --sso command to try again. The --sso parameter is required when you log in with a federated ID. If this option is used, go to the link listed in the CLI output to generate a one-time passcode. {: note}

  3. To start managing encryption keys, install the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in.

    ibmcloud plugin install key-protect -r 'IBM Cloud'

    {: pre}

  4. Optional: Verify that the plug-in was installed successfully.

    ibmcloud plugin list

    {: pre}

Updating the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in

{: #update-cli}

You might want to update CLI periodically to use new features.

To update the CLI:

  1. Log in to {{site.data.keyword.cloud_notm}} with the {{site.data.keyword.cloud_notm}} CLI External link icon{: new_window}.

    ibmcloud login

    {: pre}

    If the login fails, run the ibmcloud login --sso command to try again. The --sso parameter is required when you log in with a federated ID. If this option is used, go to the link listed in the CLI output to generate a one-time passcode. {: note}

  2. Install the update from the plug-in repository.

    ibmcloud plugin update key-protect -r 'IBM Cloud'

    {: pre}

  3. Optional: Verify that the plug-in was updated successfully.

    ibmcloud plugin list

    {: pre}

Uninstalling the {{site.data.keyword.keymanagementserviceshort}} CLI plug-in

{: #uninstall-cli}

  1. Log in to {{site.data.keyword.cloud_notm}} with the {{site.data.keyword.cloud_notm}} CLI External link icon{: new_window}.

    ibmcloud login

    {: pre}

    If the login fails, run the ibmcloud login --sso command to try again. The --sso parameter is required when you log in with a federated ID. If this option is used, go to the link listed in the CLI output to generate a one-time passcode. {: note}

  2. Install the update from the plug-in repository.

    ibmcloud plugin uninstall key-protect

    {: pre}

  3. Optional: Verify that the plug-in was uninstalled successfully.

    ibmcloud plugin list

    {: pre}