Create Self-Service Resources

Once you have started all the governance components and successfully configured them, it’s time to access the Self-Service to create the Axual Resources.

These steps are used to create the Tenant and User in the Axual Self-Service.

This user will get TENANT_ADMIN role, so he will be able to create all the mandatory resources of the organization.

Access the Local login page and press the Register button

The URL is <self-service.host>/login/local
Fill the user details and press the Register button
Provide the Organization details and press the Continue button

Check this page to configure the wizard to expect the Organization Short Name

You have now reached the Self-Service dashboard.

Create the Cluster

These steps are used to create a Cluster in the Axual Self-Service.

We are writing the steps to add the local cluster started with the Axual Streaming Charts. But these steps can be used as reference for any cluster

Open the clusters menu and press the New Cluster button
Provide the Cluster Details
1. Put local as the Name
2. Put Local cluster as the Description
3. Put local as the Location
4. Select Apache Kafka as the Provider Type
Press the Continue button
Provide the Kafka Details
1. Put platform.local:31575 as the Kafka bootstrap URL
2. Select TLS as the Authentication Method
3. Upload a super-user certificate
4. Upload a super-user private-key
5. Press the Verify button to validate that the above information is valid

Toggle the Shared cluster to be no

Shared clusters are visible to all tenants defined in the Axual platform. Only SUPER_ADMIN can manage those clusters.

Private clusters are visible to only the tenant that has defined it. TENANT_ADMIN can manage those clusters.

Provide the Cluster Patterns
1. Put {tenant}-{instance}-{environment}-{topic} as the Topic pattern
2. Put {tenant}-{instance}-{environment}-{group} as the Group pattern
3. Put {tenant}-{instance}-{environment}-{application.id}-{transactional.id} as the Transactional pattern
Press the Add Cluster button

The cluster patterns are used to decide how many instances, environments, and tenants can use this cluster.

Now that you have created a Cluster in the Self-Service, you can proceed to create an Instance.

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.

Open the instances menu and press the Add instance button
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
Press the Select cluster button

Do not fill the Instance Manager URL field, this field is for older installation. It will be removed in future releases.
Select the local cluster
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
Verify the Schema Registry details by pressing the Verify button
Once verified, you can add Schema Registry Listeners. This is a set of <protocol:URL> pair for setting various Schema Registry Listeners. The Schema Registry Listeners are used by the Kafka Clients to connect to the Schema Registry.
You can close the Instance/Cluster modal by pressing the Select Cluster button
You can click on Show full configuration to validate the selected cluster details
You can close the full configuration modal
Enable the Authentication Method for this Instance
1. Toggle the SSL (MUTUAL TLS)
2. Upload the Signing CA used to sign your application certificate
Press the Add Instance button

Now that you have created an Instance in the Self-Service, you can proceed to create an Environment.

Create the Environment

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

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

Open the environments menu and press the New Environment button
Provide the Environment Details
1. Put dev as the Name
2. Put dev as the ShortName
3. Put Dev environment as the Description
4. Select a Color
5. Select dta as the Instance
6. Select Public as the Visibility
7. Select Auto as the Authorization Issuer
8. Select Admins as the Owner
Press the Add Environment button

Now that you have created an Environment in the Self-Service, you can proceed to create a Topic.

Create the Topic

String/String Topic

These steps are used to create a string/string Topic in the Axual Self-Service and deploy to the Kafka Cluster.

We are writing the steps to create a string-string topic in the dev environment created in the previous step.

Open the topics menu and press the New Topic button
Provide the Topics Details
1. Put string-string as the Name
2. Put String/String topic as the Description
3. Select Admins as the Owner
4. Select String as the Key Type
5. Select String as the Value Type
6. Select Delete as the Retention Policy
Press the Add Topic button

Now that you have created a Topic in the Self-Service, you can proceed to configure it in the previously created Environment

Open the topic configuration modal
Provide the topic configuration and press Save
1. Put 3 as the Retention time
2. Put 4 as the Number of partitions
Press the Save button

Now the string-string topic is available in the kafka cluster.

Create the Application

These steps are used to create a producer Application in the Axual Self-Service.

We are writing the steps to create a java-producer application that will produce to the string-string topic created in the previous step.

Open the applications menu and press the New Application button
Provide the Application Details
1. Put io.axual.producer as the ID
2. Put Java Producer as the Name
3. Put java_prd as the Short Name
4. Select Admins as the Owner
5. Select Custom as the Application Type
6. Select Java as the Type
7. Select Public as the Visibility
8. Put Java producer application as the Description
Press the Add Application button
Once the application has been created, be sure to have dev environment selected in the Environment Dropdown
Open the application-authentication
Upload your application certificate
Once the Platform Manager validates the application certificate, it’s possible to press the Apply button
Press the + Add request button
Select the type of request to make
1. Choose Producer as the Application Type
2. Select string-string as the Topic
Press the Request Approval button

Based on the Environment Authorization Issuer it’s possible that Stream Owner will require approving the pending access request

Since the dev Environment created as AUTO Authorization Issuer, the access request is approved.

The Topic ACL has been updated, the Application is able to produce to the string-string topic.