Starting Abiquo for the First Time



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 almost all major web browsers. Check Abiquo Infrastructure Guide#User Interface for further details.

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




Change your user details

The system administrator should log in first and change the passwords and user details.

To change your user password and user details:

  1. Click on the username icon at the bottom left of the screen
  2. Select Edit user
  3. Change the Password, enter an Email, a Phone number and an SSH public key, and change other details as required.
    General information
    Advanced

Note that you cannot change many of the details of the main cloud administrator account, and you cannot change its role and privileges. However, you can replace the main cloud administrator account  with another equivalent cloud administrator account. You can also edit this user account and other user accounts in Users View.

 


Enable 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:

  1. Click on the user initials or user icon in the lower left corner of the screen, and from the menu, select Two-factor authentication.
  2. Select the authentication method and click Enable
  3. 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

  4. 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
 Click here to show/hide the screenshots

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 Abiquo

To add a license to the platform:

  1. Go to Configuration → Licenses
  2. Click the + Add button at the bottom of the screen
  3. 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. 

 Click here to show/hide the screenshot

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




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. 

 Click here to show/hide the screenshot

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


Copyright © 2006-2022, Abiquo Holdings SL. All rights reserved