Provide access to an instance

After an instance is created, you must create two initial users with administrative access: one user for AI Processing and the other one for AI Data. The process differs based on whether the instance is managed by Veritone, or is a self-managed deployment. For Veritone-managed instances, the provisioned cloud resources must be fully launched and running before users can access them. For self-managed instances, the installation process must be completed.

[Tip] To make managing an aiWARE instance easier, users can create a CLI profile on their local workstation. A CLI profile saves users from having to enter the required settings and credentials each time to run commands. See Manage remote nodes in aiWARE.

System requirements

A computer that accesses an aiWARE instance must meet the following specification:

• Linux operating system running one of the following:
  • RHEL 7
  • Ubuntu 20.04
  • Ubuntu 22.04 (recommended)

Provide access to a Veritone-managed instance

To access a Veritone-managed instance of aiWARE, users will need to install the aiWARE CLI (command line interface) on their local computer, create their initial user accounts, and then access their AI Data and AI Processing interfaces.

[Note] Creating the initial aiWARE user accounts is different from inviting new users to Hub via the Add New User button. A Hub user does not have access to aiWARE unless an account is set up for them via the Admin application.

Once an instance has been created, the commands for accessing the instance are available on the Installation tab of the Instance Details panel. The commands for each instance are unique, so you must copy/paste the commands that are provided there.

Before you begin

Veritone-managed instances aren't accessible until their cloud resources are fully spun up, which takes several minutes. You can test whether the process is complete and the instance is ready to be accessed by doing the following: Steps to test accessibility

1. Select the newly created instance in the aiWARE Instances table.

   The Instance Detail panel opens.

2. Click the Overview tab and do the following:
   • Click the link for the Processing UI.
   • Click the link for the Data UI.

   If the links take you to the Veritone login page, the instance is ready to be accessed.

   If the links return a 503 error, the instance's cloud resources are still being configured.

Steps to access

1. On a local workstation that will be used to access the aiWARE instance, open a terminal window.
2. On the Installation tab of the Instance Detail panel, copy the command for Install aiWARE CLI and then run it in the terminal.
3. To create the user accounts, do the following:
   1. On the Installation tab of the Instance Detail panel, copy the command for Create Initial Users.
   2. Paste the copied command into the terminal.
   3. Modify the values for "YOUR EMAIL", "YOUR PASSWORD", and "YOUR USERNAME" for the user being created.
   4. Run the command.

      This command creates two user accounts:

      • One for AI Processing that uses the username, email and password you specified when you ran the command.
      • One for AI Data that uses sysadmin@aiware.run as the username (this is the super user account) and the password you specified when you ran the command.
4. Click the Overview tab of the Instance Detail panel and do the following:
   • Follow the link to the Processing UI and enter the username and password you configured in step 3.
   • Follow the link to the Data UI and enter the super user name sysadmin@aiware.run and the password from step 3.

Provide access to a self-managed instance

To access a self-managed instance, users need to run the command to create the initial user accounts. Users can then access their AI Data and AI Processing interfaces by following the links that are provided in Hub.

Before you begin

Installation of the aiWARE instance must be complete before you can create user accounts to provide access.

Steps

[Note] If the aiWARE instance is in a network-isolated environment, and the instance is a non-Kubernetes deployment, the user accounts must be created on the workstation that has the controller run mode installed.

[Warn] You must complete the login process within 24 hours of installing the AI Data component. The URL expires after 24 hours.

1. On the Installation tab of the Instance Detail panel, copy the command for Create Initial Users.
2. In a terminal window using the aiWARE CLI on the workstation that has the controller run mode installed, do the following:
   1. Paste the copied command into the terminal.
   2. Modify the values for "YOUR EMAIL", "YOUR PASSWORD", and "YOUR USERNAME" for the user being created.
   3. Run the command. This command creates two user accounts:
      • One for AI Processing that uses the username, email and password you specified when you ran the command.
      • One for AI Data that uses sysadmin@aiware.run as the username (this is the super user account) and the password you specified when you ran the command.

3. Click the Overview tab of the Instance Detail panel and do the following:

   • Follow the link to the Processing UI and enter the username and password you configured in step 2.
   • Follow the link to the Data UI and enter the super user name sysadmin@aiware.run and the password from step 2.

• To make managing your aiWARE instance easier, you can create a CLI profile on your local workstation. See Manage remote nodes in aiWARE.

• Deploy and manage aiWARE
• Using aiWARE Hub
• Provide access

• System requirements
• Provide access to a Veritone-managed instance
• Provide access to a self-managed instance