First login
After Abiquo is installed, by default you can access the platform through the web interface.The Abiquo client is compatible with the latest versions of major web browsers. For more details, see Abiquo infrastructure guide#User Interface.
Enter this URL in your browser:
https://<server-domain-name>/ui
Then enter the User "admin" and the Password supplied by Customer Support.
If you have installed the platform from an OVA file, the default logins are:
Users & Organizations:
Enterprise: Abiquo
Cloud Administrator (Complete access to all functionality)
Username: admin
Password: xabiquo
Enterprise User (Virtual applications only)
Username: user
Password: xabiquo
Edit your user account details
After you log in, you may need to edit your user account to update your details:
Click the User icon in the lower left-hand corner of the screen
From the menu, select Edit user
Change your Password
To receive VM passwords, login authentication codes, and email notifications, enter your E-mail address and Phone number
Go to Advanced and add your Public key for remote access to VMs
If you are using a single sign on, you may need to ask your system administrator to update your details.
Since 6.2.2, if you edit your user account, you require to type the password to change the email (as well as we want to change your own password).
Use two factor authentication
Your platform may offer or require two-factor authentication (2fa) to improve user login security with an additional authentication code.
For platform configuration instructions, see Configure two factor authentication .
Before you begin:
To use Google Authenticator to obtain the codes, install the Google Authenticator app on your cell phone.
To use email authentication to obtain the codes, check that you have a valid email address in your user account on the platform.
To enable two-factor authentication for your user account, do these steps:
Click on the user initials or user icon in the lower left corner of the screen, and from the menu, select Two-factor authentication.
Select the authentication method and click Enable
Copy the Backup codes from the configuration window to a secure place. You can use these codes to log in to the platform if the authentication cycle fails
The platform will display Backup codes ONCE only
Authenticate according to your selected method
For Google Authenticator, use the Google Authenticator app on your cell phone to scan the QR code.
Google will supply a verification code in the app. During login, the platform will request the Authentication code from the app.For email, during login, every time you enter your user name and password to log in, a code will be sent to the E-mail address registered in your user account.
Enter the Authentication code in the Login dialog
Enabling two factor authentication
Two-factor authentication with Google Authenticator with backup codes and QR code
Login with two-factor authentication
The main menu
To access different sections of the platform, use the main menu buttons on the left of the screen.
To display the names of the sections, move the mouse over the main menu section.
Obtain a trial license
To obtain a trial license, please send an email to license at abiquo dot com
Please include the following license registration details:
Name
Surname
Email for license registration
Phone
Company
Add a license
To add a license to the platform:
Go to Configuration → Licenses
Click the + Add button at the bottom of the screen
On the Add license popup, paste the license in the License key field and click Save
The platform will display your license details in the Configuration tab, including the enabled plugins, support for scaling groups, available cores, and expiration date for each license.
To delete a license, select it and click the trash delete button.
Error messages and logs in the UI
At some point you may see a warning "toast" message in the bottom right-hand corner of your screen. This message will pop up and stay on the screen until it is clicked, or for a few seconds only.
To review the messages that have appeared in the UI during the current session, click the user icon at the bottom left of the screen and select Logs. A popup will open with details of recent error messages. You can copy error message text from this popup. Further details of any events in the platform can be found in Events view
Refresh the display in the UI
By default in Abiquo, the data on the screen will automatically refresh every 10 minutes. There is a separate refresh interval of 5 seconds for when you deploy VMs. You can configure the default refresh intervals in Configuration view.
As you are working in Abiquo, to manually update the screen to display the latest data from the API, click the Refresh button in the top right-hand corner of the screen.
Help using Abiquo
To open the help page for a pop-up in Abiquo, click the wiki links help '?' button in the top-left corner of a pop-up.
To open the Abiquo tutorials available for your user role, click the user icon at the bottom left of the screen and from the menu, select Tutorials.
To open the cloud platform documentation, click the Documentation icon. Or click on the help icon in the top left corner of any dialog box.
Troubleshooting first login
When you connect to the Abiquo server, make sure you are using the correct protocol for your server (HTTPS). The Abiquo client will download to your browser. If you cannot log in and there is no problem with your user account, there may be a problem with the connection to the Abiquo server. Check the UI configuration of the API in the client-config-custom.json file ("config.endpoint":"http://<serverIPaddress>/api",). See Configure Abiquo UI. There could also be a problem with the connection to the Abiquo database. Check that MySQL is running and check the jdbc connection details.
Support
To display the Abiquo Support contact information, click on the user icon at the bottom left of the screen and select Support
The default message is:
Designated Support Contacts can raise support tickets here.
If you are not a Designated Support Contact, please contact your organization's support personnel to obtain support for this product.
The word "here" is linked to support.abiquo.com.
Configuration
To configure the display of the help button and the URLs of the help pages, see Configuration View#Wiki Links Tab
To configure the URL for the Documentation link, see Configuration View#Dashboard.
To customize the Support message, edit the message text in the UI language files. See Abiquo UI client language configuration#CustomizeAboutandSupportMessages