Instances

Create the Instance

These steps are used to create an Instance in the Axual Self-Service.

We are writing the steps to create a dta instance using the local cluster created in the previous step.

  1. Open the instances menu and press the Add instance button

    Self-Service Instances Menu

  2. Provide the Instance Details and press the Continue button

    1. Put Dev Test Acceptance as the Name

    2. Put dta as the ShortName

    3. Put DTA Instance as the Description

  3. Press the Select cluster button

    Self-Service Add Instance Details page
    Do not fill the Instance Manager URL field, this field is for older installation. It will be removed in future releases.

  4. Select the local cluster

  5. Provide the Schema Registry Credentials for this Instance/Cluster

    1. Put http://axual-axual-schema-registry-master:20000/ as the Rest Endpoint

    2. Select No Authentication as the Authentication Method

      Self-Service Add Schema Registry Details page

  6. Verify the Schema Registry details by pressing the Verify button

    Self-Service Verify Schema Registry Details

  7. Once verified, you can press Add listeners button to add Schema Registry Listeners. This step is optional.

    1. Input TLS as the Protocol

    2. Input localhost:25000 as the URL

      Self-Service Add Schema Registry Listeners
      Schema Registry Listeners is a set of protocol:URL pair for setting various Schema Registry Listeners. They are used by the Kafka Clients to connect to the Schema Registry. You can add more listeners and there are no validation on our side.

  8. You can close the Instance/Cluster modal by pressing the Select Cluster button

  9. You can click on Show full configuration to validate the selected cluster details

    Self-Service View Selected Cluster

  10. You can close the full configuration modal

    Self-Service View Cluster Full Configuration

  11. Enable the Authentication Method for this Instance

    1. Toggle the SSL (MUTUAL TLS)

    2. Upload the Signing CA used to sign your application certificate

  12. Press the Add Instance button

    Self-Service Add Instance Security

Now you have successfully created an Instance in the Self-Service

Self-Service Instance Create

Environment Mapping

This setting allows Tenant Admin to enable or disable mapping environments under an Instance regardless of whether the user is an Environment Author.

When enabled, Environment Author can create an environment under that Instance.

When disabled (which is the default), creation of an environment under that Instance is not allowed regardless of whether the user is an Environment Author.

If Environment Mapping is disabled for Instance 1 then:

  • No user can create a new Environment using Instance 1

  • No user can update an Environment to use Instance 1

  • No user can update an Environment using Instance 1 to use a different Instance

To enable environment mapping for an Instance

  1. Log in as a Tenant Admin.

  2. Move to the Instance page.

  3. Select the Instance.

  4. Click Edit Instance button.

  5. Under Governance Settings, click on the Environment Mapping toggle

  6. Click Update Instance button.

    Enable Environment Creation
You can also enable environment mapping when creating an instance from the create instance page.

Granular Stream Browse Permissions For An Instance

Granular stream browse permissions allows Tenant Admin to have an instance level access control over topics configured on all environments mapped to it.

When enabled, all environments in the instance will support granular authorization.

When disabled (which is the default), all environments in the instance have the same authorization for both stream configuration and browse, which means there is no granular browse permission applied over a topic.

To enable granular stream browse permissions for an instance

  1. Log in as a Tenant Admin.

  2. Move to the Instance page.

  3. Select the Instance.

  4. Click Edit Instance button.

  5. Under Governance Settings, click on the Enable granular stream browse permissions toggle

  6. Click Update Instance button.

    Enable Granular Stream Browse Permission
Disabling granular stream browse permissions on an instance that had it enabled leads to deleting of all existing Permission Groups.
You can also enable granular stream browse permissions when creating an instance from the create instance page.