Create and start Docker containers

Use the following information to create DataStax Enterprise (DSE) server, DSE OpsCenter, and DataStax Studio containers in production and non-production environments.

Creating a DataStax Enterprise container

Create a DataStax Enterprise (DSE) server container. For a list of the most commonly used options, see Docker run options.

See the docker run command reference for a full list of options to run a command in a new container.

Enabling advanced functionality

By default, the DSE server image is configured as a transactional (database) node. To configure the node with DSE advanced functionality, add the corresponding option that enables the intended feature to the end of the docker run command.

Combine startup options to run more than one feature.

Option Description

-g

Enable and start DSE Graph.

-k

Enable and start DSE Analytics.

-s

Enable and start DSE Search.

Examples

Setting the DS_LICENSE environment variable signals your acceptance of the DataStax terms of service and is required for the software to start.

  • DSE container

  • with Graph

  • with Analytics

  • with all

docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:6.8.37
docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:6.8.37 -g
docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:6.8.37 -k
docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:6.8.37 -s
docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:6.8.37 -g -k -s

Creating an OpsCenter container

Create a DSE OpsCenter container and a connected DSE server container on the same Docker host. For a list of the most commonly used options, see Docker run options.

DSE 6.8 requires OpsCenter 6.8.

See the docker run command reference for a full list of options to run a command in a new container.

Setting the DS_LICENSE environment variable signals your acceptance of the DataStax terms of service and is required for the software to start.

Procedure

  1. Create an OpsCenter container.

    docker run \
    -e DS_LICENSE=accept \
    -p 8888:8888 \
    --name my-opscenter \
    -d datastax/dse-opscenter
  2. Create a DSE server container that is linked to the OpsCenter container.

    docker run \
    -e DS_LICENSE=accept \
    --link my-opscenter:opscenter \
    --name my-dse \
    -d cr.dtsx.io/datastax/dse-server:6.8.37
  3. Get the DSE container IP address.

    docker exec -it my-dse nodetool status
  4. Open a browser and navigate to http://dse_container_ip:8888, where dse_container_ip is the IP address of the OpsCenter container.

    1. Click Manage existing cluster.

    2. Enter the DSE container IP address in the host name field.

    3. Click Install agents manually. The agent is already installed on the DSE image, so no installation is required.

Results

OpsCenter is ready to use with DSE.

Creating a Studio container

Create a DataStax Studio container. For a list of the most commonly used options, see Docker run options.

See the docker run command reference for a full list of options to run a command in a new container.

Setting the DS_LICENSE environment variable signals your acceptance of the DataStax terms of service and is required for the software to start.

Procedure

  1. Create a Studio container, using my-dse as the hostname.

    docker run -e DS_LICENSE=accept \
    -p 9091:9091 \
    --link my-dse \
    --name my-studio \
    -d datastax/dse-studio
  2. Open a browser and navigate to http://studio_container_ip:9091, where container_IP is the IP address of the container.

Results

Studio is ready to use with DSE.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com