Install Hyper-Converged Database (HCD) 1.0 (HCD 1.0) using a docker image
In general, this method of installation is used if you prefer to run HCD in a containerized environment.
The following steps set up HCD in a Docker container that is running on your local machine.
The installation can be run within the container as any user on Linux or Mac.
You may either run HCD only using a docker run
command, or run HCD with the Data API using a docker-compose
command.
Prerequisites
-
Docker must be installed and configured on your machine.
-
The Docker container will have the appropriate Java runtime environment (Java 11) and Python 3 installed in the execution environment.
-
HCD only
The following command will start HCD on a standalone container:
docker run -e DS_LICENSE=accept -p 9042:9042 \
cr.dtsx.io/datastax/hcd:1.0.0
The -p
option of the docker run command ensures that the cqlsh
port is exported and available from outside the container.
The database is up and running when the following message is visible in the output:
INFO [main] 2023-07-20 07:53:28,954 PipelineConfigurator.java:125 -
Starting listening for CQL clients on /0.0.0.0:9042 (unencrypted)...
You can now establish a connection to HCD using the Cassandra Query Language (CQL) shell cqlsh
.
HCD with Data API
A docker-compose file is available to run HCD with the Data API. See the Data API github repository for more information.