CLI Tools

Most commands support the following options:

• -h or --help - Specify <command> help for help about a command
• -p or --profile - named AWS credentials to use for accessing the AWS account
• -r or --region - AWS region of the Datomic system

Queries the supplied Datomic Compute Group for logs.

Log requires one argument, a compute-group-name:

datomic log list <compute-group>

• -f or --filter - alerts by default or all if specified.
• -t or --tod - logs from the specified time provided as a Clojure #inst literal to the value of --minutes-back. Defaults to the current time.
• -m or --minutes-back - logs from --tod to an integer number of minutes in the past. Defaults to 20 minutes.
• -i or --instance-id - Limit log results to EC2 instances with this prefix.
• General options.

Returns the details of a specific log. Returns a JSON array.

Detail requires two arguments, a compute-group-name and a message-id supplied to -m:

datomic log detail <compute-group> -m <message-id>

• -m or --msg - message id (provided by log list command)
• -i or --instance-id - only show logs from compute groups with a prefix matching the supplied string
• General options

List-instances displays the EC2 instances, with their instance-id and current status, that are utilized by the supplied system-name:

datomic system list-instances <system>

General options.

Describe-groups displays information about the compute groups of the supplied Datomic Cloud system:

datomic system describe-groups <system>

A JSON array of compute group information is returned:

[{"name": "<group-name>",
  "type": "<group-type>",
  "endpoints":
  [{"type": "<endpoint-type>",
    "api-gateway-endpoint": "<endpoint-address>",
    "api-gateway-id":" <gateway-id>",
    "api-gateway-name": "<gateway-name>"},
   ...],
  "cft-version": "<cloudformation-version>",
  "cloud-version": "<cloud-version>"},
 ...]

Lists all currently active and inactive Datomic systems on the sourced or specified account.

datomic cloud list-systems

General options.

The client commands use ssh to allow connections from outside the Datomic VPC through the access gateway to a Datomic system.

client commands requires a single argument: system-name.

The access gateway runs inside a Datomic system's private VPC. It acts as an entry point for Client API and analytics connections from outside the VPC.

While the gateway runs automatically based on your CloudFormation template, there are some situations where you may want to explicitly control it:

• You can start or stop the gateway to control access or EC2 instance costs
• You can restart the gateway to recover from a process failure
• You can restart the gateway to pick up new analytics catalog settings

You can also monitor the status of the access gateway in the AWS EC2 Management Console. The access gateway is named SystemName-bastion. Note that:

• When the Instance State is running, the access gateway is available for use.
• An Instance State of terminated indicates the access gateway has terminated. You will incur no future charges for that instance.

Solo manages the ASG for a Datomic solo instance.

Solo commands requires a single argument, system-name.

Tools for utilizing Datomic analytics.