Updating Platform9 VMware vSphere Gateway Credentials

If you specified incorrect credentials to your Platform9 VMware vSphere Gateway Appliance, and need to fix them, following tutorial describes how to do that.

Step 1 - Log into Platform9 VMware vSphere Gateway Appliance

Username: root
Password: pf9vmware

Step 2 - Run the Platform9 update_credentials CLI Utility

The Platform9 gateway virtual appliance ships with a CLI utility update_credentials which allows you to re-authenticate your gateway appliance with vCenter.

IMPORTANT NOTE: If the username or password contains special characters, please enclose the text in single quotes ('passw@$rd'), so that the values are interpreted correctly. Currently single-quotes (') and double-qoutes (") cannot be handled in the password, please change the password in such cases.

update_credentials -i <vcenter ip address or hostname> -u <vcenter username> [-p <vcenter password>]
# If password option is not specified while invoking the command
# you will be prompted to provide it later as password protected field
<p>

Once the authentication succeeds, you should see the gateway appliance appear in the Platform9 user interface as awaiting authorization.

Validate Credentials Only

In case you only want to test a particular set of credentials for permissions validity, before using them, you can use the ValidateOnly option:

update_credentials -i <vcenter ip address or hostname> -u <vcenter username> [-p <vcenter password>] -V
# If password option is not specified while invoking the command
# you will be prompted to provide it later as password protected field
<p>

In this case, the configuration files are not updated, but a brief report of the credentials permissions report is displayed.


November 16, 2015