Getting started with the IBM SaaS Console with accounts

From the IBM SaaS Console, manage your subscriptions and instances.

This Console is included with the following products:

  • Concert
  • watsonx.data
  • watsonx.governance as a Service on AWS

Accessing the SaaS Console

To gain access to the SaaS Console, subscribe to a trial or a paid product subscription or accept an invitation.

Managing SaaS accounts

View account details and account health status and manage user access.

  1. After you log in to the SaaS Console, select an account to manage its subscriptions. The Subscriptions page opens.
  2. From the Account summary section, click Access management. The Access management page opens.
  3. From the Access management page, you can add users to the account, subscriptions, and service instances. You can also set up user groups to manage access.
  4. To add users, from the Users tab, click Add users. Enter the email addresses of the users whom you want to add.
  5. To grant user access, select the box on the same row as a user's name.
  6. After you select all the users to give access to, click Assign roles to users or Add users to user groups.
    • To assign roles to users, choose a Scope. Depending on the scope, next choose either a Role or a Subscription. Click Assign.
      • A Subscription owner can take any available action in a subscription.
      • A Subscription viewer can view instances of a subscription and check instance statuses.
      • A Subscription admin can manage instances. Admin actions include inviting users and assigning roles to them. Admins can also create, update, and delete instances of a subscription.
    • To add users to user groups, select the user groups where you want to add the users. Click Add.
  7. To view a user or edit a user's access, click Options on the row of the user whom you want to view or edit. To change the user's access, click Grant access.
  8. To delete a user, click Options on the row of the user whom you want to delete and select Delete user.

Creating user groups

  1. To create a user group, from Access management, select the User groups tab and click Create user groups. The Create a user group window appears.
  2. Enter a name and an optional description for your group. Click Create. The group is added to the user group table on the Access management page.
  3. To view or delete a user group, click Options on the row of the group that you want to view or delete. From Options, you can select either View user group or Delete user group.

Managing your subscriptions

From the Subscriptions page, click View subscription details. Manage your subscription plan as needed according to the subscription status.

Table: Subscription statuses
Subscription status Expectation
Active The subscription is current and available.
Expired The subscription is expired. If you are on a trial plan, to resume usage with the current data, upgrade to a paid plan. If you are on a paid plan, to resume usage with the current data, renew the subscription.
Suspended The subscription is suspended due to business reasons. For more details, contact sales or open a ticket.

If the usage limit is exceeded, Allotted usage exceeded appears under Payment tier. Usage of the product might be limited, or added charges might apply to using the product. If you are on a trial plan, to resume usage with the current data, upgrade to a paid plan by clicking Buy subscription. If you are on a paid plan, either upgrade the plan by clicking Manage subscription plan or wait until the period renews.

Managing instances

Each product determines the number of instances that you can provision per subscription, but you can have only one instance per trial subscription.

  1. From the Subscriptions page, find the product that you want to view and click View subscription details. The Instances tab opens and shows the instances for that subscription.
  2. Click Create instance. The Create instance page opens.
  3. Select the Region and enter the Instance name.
  4. Click Create. The instance appears under the Instances tab, and the instance count increases on the Subscriptions page.
  5. To view details about an instance, from the Instances tab, click the instance row. The Instance details page opens.
  6. To delete an instance, open the options in the instance row and click Delete instance. The Confirm delete window opens. Confirm that you want to delete the instance by entering the instance name. This option is disabled for trial instances.

Viewing billing and usage

For services that record usage, you can go to the Subscriptions page, find the product that you want to view, and click View usage to view subscription usage.

  • A warning appears if allotted usage is exceeded. You still have access to product features, but certain features might be disabled or unavailable, and overage charges might apply.
  • If an error about loading the data appears, refresh the page to fetch subscription usage again.

Viewing instance statuses

On the Instances tab, the following statuses can appear:

Table: Instance statuses
Instance status Expectation
Active The instance is active, and the actions for your subscription type are available.
Deleting The instance is being deleted.
Expired The instance expired. Upgrade or renew the subscription to continue to use the instance.
Expiring The instance is expiring. Upgrade or renew the subscription to continue to use the instance.
Provisioning The instance is being created.
Running You can take any available action with the instance.
Restoring Instance data is being restored.
Resuming The instance is resuming an action.
Stopped The instance is stopped because of an unactive subscription.
Suspended The instance is suspended, and actions are disabled or unavailable.
Suspending The instance is being suspended.
Unexpiring The instance is being renewed from the Expired or Expiring states.
Updating After you upgrade an instance, the instance takes time to update.

If an error occurs, one of the following error statuses appears:

Table: Errors
Error Cause
Delete error A problem occurred during the deletion of an instance.
Expire error A problem occurred while an instance was expiring.
Provisioning error A problem occurred during the provisioning of the instance, and the instance failed to provision.
Restore error A problem occurred while an instance was being restored.
Resume error A problem occurred while an instance was resuming an action.
Suspend error A problem occurred while an instance was suspended.
Upgrade error A problem occurred while an instance was upgrading.
Unexpire error A problem occurred while an instance was being renewed.

If an error occurs, and you no longer need the instance data, you can delete the instance and create another one.

Troubleshooting the IBM SaaS Console

Why doesn't my instance appear in the SaaS Console?

  • After you create an instance, check the SaaS Console after a few minutes. An instance might take time to appear.
  • If the instance still doesn't show up, contact support.

How do I upgrade a subscription?

From your trial subscription, go to the subscription listing in the SaaS Console and click Manage subscription plan. You cannot have both a trial and a paid subscription for the same product at the same time.

How do I get support in the SaaS Console?

Click the question mark icon to open the Find answers fast panel. Then, click Additional support. Click Submit & manage tickets. The support site opens.