Update VMware 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:<contact PF9 support for default password>

IMPORTANT

Platform9 strongly recommends that you change the default password.

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

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.

Bash

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

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:

Bash

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

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