Open Menu
Sextant
 
DAML

Getting Started

Pre-flight checks

If you haven't subscribed to Sextant for DAML and installed it then go to Subscribing to Sextant for DAML

Login to Sextant for DAML

Use a browser to login to your Sextant for DAML instance using the hostname and initial credentials obtained during the installation process.

Adding a Kubernetes cluster to Sextant

In order to get started you need to add your first cluster to Sextant. When you login you are directed to the Clusters page. Click Add+ and you will be presented with the following form.

Adding a cluster

There are comprehensive instructions that take you through the two step process to obtain the three key parameters needed to add your cluster to Sextant.

  • API Server Address
  • Access Token
  • Certificate Authority

Note that these instructions assume that you are familiar with the Kubernetes CLI kubectl. Once you have obtained these parameters all you need to do is name your cluster and click Submit then it will be available for deployments.

Clusters

The four symbols to the right are Delete, Edit, View and Deployments.

Deploying DAML

Select Deployments and you are directed to the Deployments page for your cluster.

Adding a deployment

Click Add+ and you are prompted to select either DAML on Sawtooth or DAML on Aurora.

Selecting a deployment

It is important to note that Sextant does not permit more than one deployment on any given cluster.

Deploying DAML on Sawtooth network

Select DAML on Sawtooth and you will be presented with the following form.

DAML on Sawtooth form

Complete this form then click Submit and Sextant will deploy your DAML on Sawtooth network.

NOTE as you are just getting started it is fine to specify your network name and Kubernetes namespace and accept the defaults.

DAML on Sawtooth deployment

Select View and you can drill down on your deployment.

DAML on Sawtooth drill down

In order to create a gRPC session and interact with the DAML ledger you will need to follow these instructions.

Once you have done this you should see a new LoadBalancer service with an ExternalIP appear when you drill down on your deployment.

DAML on Sawtooth drill down with gRPC

In the case of DAML on Sawtooth you also have the option to expose various underlying Sawtooth services by following these instructions.

Deploying DAML on Aurora

Pre-flight check

Before deploying DAML on Aurora you need to prepare your target Kubernetes cluster by following these instructions. If you have already done this you can skip this section.


Here we are using the AWS Console approach outlined in these instructions and adding the appropriate policy to instance i-07991e0260ce88bfa in an EKS cluster sfd-aurora in us-east-2.

Enablying an EKS Cluster for DAML on Aurora

First we create the policy to enable the management of RDS instances via CloudFormation.

Creating policy

Then we attach our policy to enable the instance to manage RDS instances via CloudFormation.

Attaching policy


Select DAML on Aurora deployment option

Go to the Clusters page; find sfd-aurora and click on Deployments then Add+ and once again you will be prompted to select either DAML on Sawtooth or DAML on Aurora.

Selecting a deployment

Select DAML on Aurora in the dialog and you will be presented with the following form.

DAML on Aurora form

Complete this form then click Submit and Sextant will deploy DAML on Aurora. Note that this could take up to 30 minutes if you opt for a new Aurora RDS instance.

DAML on Aurora deployment

Select View on sfd-aurora and you can drill down on your deployment. (NOTE that there is a bug with the Summary panel which will be fixed in 2.0.5.)

DAML on Aurora drill down

In order to create a gRPC session and interact with the DAML ledger you will need to follow these instructions.

Once you have done this you should see a new LoadBalancer service with an ExternalIP appear when you drill down on your deployment.

DAML on Aurora drill down with gRPC

Accessing your DAML ledger

Provided that you have added a NLB to your deployment you can connect to your DAML ledger using the daml CLI with ExternalIP as the host. For example you can inspect the ledger using the DAML navigator.

daml ledger navigator --host <ExternalIP> --port 39000

That's the end of our Sextant for DAML getting started guide. For further information or to speak to someone at BTP please contact us here.


Subscribing to Sextant for DAML

To subscribe to Sextant for DAML make sure you are logged in to your preferred AWS account then click on this link which will take you to the Sextant for DAML listing in the AWS Marketplace.

Sextant for DAML AWS Marketplace Listing

Once there you can step through the standard AWS Marketplace subscription process which primarily consists of reviewing and accepting our terms then installing an instance of Sextant for DAML by following our detailed instructions.

Note that these instructions assume that you are familiar with Kubernetes and that you have AWS sufficient privileges on your account.