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 |
|---|---|
|
Enable and start DSE Graph. |
|
Enable and start DSE Analytics. |
|
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 Search
-
with all
docker run -e DS_LICENSE=accept --name my-dse \
-d cr.dtsx.io/datastax/dse-server:{dse-latest-version}docker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:{dse-latest-version} -gdocker run -e DS_LICENSE=accept --name my-dse \
-d cr.dtsx.io/datastax/dse-server:{dse-latest-version} -kdocker run -e DS_LICENSE=accept --name my-dse \
-d cr.dtsx.io/datastax/dse-server:{dse-latest-version} -sdocker run -e DS_LICENSE=accept --name my-dse -d cr.dtsx.io/datastax/dse-server:{dse-latest-version} -g -k -sCreating 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
-
Create an OpsCenter container.
docker run -e DS_LICENSE=accept -p 8888:8888 --name my-opscenter \ -d datastax/dse-opscenter -
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:{dse-latest-version} -
Get the DSE container IP address.
docker exec -it my-dse nodetool status -
Open a browser and navigate to http://dse_container_ip:8888, where
dse_container_ipis the IP address of the OpsCenter container.-
Click Manage existing cluster.
-
Enter the DSE container IP address in the host name field.
-
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
-
Create a Studio container, using
my-dseas the hostname.docker run -e DS_LICENSE=accept \ -p 9091:9091 \ --link my-dse \ --name my-studio \ -d datastax/dse-studio -
Open a browser and navigate to http://studio_container_ip:9091, where
container_IPis the IP address of the container.
Results
Studio is ready to use with DSE.
