Power Virtual Server: Configuring IBM Power Virtual Server (PowerVS) APIs

You must have already created an API key, as described in https://cloud.ibm.com/docs/account?topic=account-serviceidapikeys&interface=ui.

To configure or review the settings for PowerVS APIs, complete these steps:

1. Click the navigation menu icon () in the portal header and click the Settings icon ().
2. In the Settings page, click the Power Virtual Server.
3. Click Configuration at the top of the page.
4. Click Add API Key.
5. Move the slider to enable the entry.
6. Enter a name of your choice for the Power Systems Virtual Server Service entry .
7. Enter your Cloud Resource Name (CRN) for Power Systems Virtual Server Service. (Refer to https://cloud.ibm.com/docs/key-protect?topic=key-protect-retrieve-instance-ID&interface=ui to learn how to retrieve the CRN.) The first part of your CRN contains your Tenant ID and the second part contains your 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::
8. Enter the API Key that you created.
9. Select the region for the API Key from the drop-down list.
10. Click Test Connection to test the connection.
11. Add additional entries as needed. Note that it may take up to 30 minutes to update the data in the Inventory app.
12. If needed, click Remove to remove an entry.

Important note for cloned Power Virtual Server VMs

The Linux Power Virtual Server VMs must have a unique machine-id. This machine-id is used for inventory document creation in the database, one inventory document per VM.

However, in the case of cloned VM's, there is a high probability that cloned VM's will have the same machine-id as the VM from which they were cloned. This results in the inventory document in the database being overwritten by another document with the same machine-id document name, and missing partition information in CMC inventory.

Use the cat /etc/machine-id command to display the machine-id's. This command must return a unique machine-id for each VM.

If this command indicates that the machine-id's are not unique, you must regenerate the machine-id on any VM with a duplicate. You must do this before you configure the Power Virtual Server VM for CMC.

1. Remove the machine-id files from the two file locations:
   rm /var/lib/dbus/machine-id /etc/machine-id
2. Run the systemd-machine-id-setup command to generate a different unique machine-id:
   systemd-machine-id-setup
3. Confirm that the machine-id's are unique:
   cat /etc/machine-id