(1) Run the following script on your machine to create a Docker container:

docker run -itd --name dolphindb \
  --hostname host1 \
  -p 8848:8848 \
  -v /etc:/dolphindb/etc \
  dolphindb/dolphindb:v2.00.5 \
  sh

Parameters:

• --hostname: The host name (which is used to collect machine fingerprint for Enterprise Edition License). You can check the host name with the hostname shell command.
• -p: The first port 8848 is the host port, and the latter one is the port mapped to the DolphinDB container (the default port). After startup, you can access DolphinDB through the local port 8848.
• -v: Map the /etc directory of the host to the container (/dolphindb/etc). It is used to collect machine fingerprint for Enterprise Edition License.
• --name: The name of the container. You can perform operations on the container, such as checking container-related information, by specifying a container name. If not specified, a random name will be assigned. Note that the container name must be unique.
• dolphindb/dolphindb:v2.00.5: It is a required parameter, which is used to specify the image. The image name must be complete (including dolphindb repository and version), for example, dolphindb/dolphindb:v2.00.5.

(2) Run the following script to check whether the container is successfully created:

docker ps|grep dolphindb

The following information indicates a successful operation:

347bfa54df86   dolphindb/dolphindb:v2.00.5   "sh -c 'cd /data/ddb…"   20 seconds ago   Up 19 seconds   0.0.0.0:8848->8848/tcp, :::8848->8848/tcp   dolphindb

(3) Connect to DolphinDB with the client and conduct a test.

(1) Run the following script on your machine to create a Docker container:

docker run -itd --name dolphindb \
  --hostname cnserver10 \
  -p 8848:8848 \
  -v /etc:/dolphindb/etc \
  dolphindb/dolphindb-arm64:v2.00.7 \
  sh

Parameters:

• --hostname: The host name (which is used to collect machine fingerprint for Enterprise Edition License). You can check the host name with the hostname shell command.
• -p: The first port 8848 is the host port, and the latter one is the port mapped to the DolphinDB container (the default port). After startup, you can access DolphinDB through the local port 8848.
• -v: Map the /etc directory of the host to the container (/dolphindb/etc). It is used to ccollect machine fingerprint for Enterprise Edition License.
• --name: The name of the container. You can perform operations on the container, such as checking container-related information, by specifying a container name. If not specified, a random name will be assigned. Note that the container name must be unique.
• dolphindb/dolphindb-arm64:v2.00.7: It is a required parameter, which is used to specify the image. The image name must be complete (including dolphindb repository and version), for example, dolphindb/dolphindb-arm64:v2.00.7.

(2) Run the following script to check whether the container is successfully created:

docker ps|grep dolphindb

The following information indicates a successful operation:

347bfa54df86   dolphindb/dolphindb-arm64:v2.00.7   "sh -c 'cd /data/ddb…"   20 seconds ago   Up 19 seconds   0.0.0.0:8848->8848/tcp, :::8848->8848/tcp   dolphindb

(3) Connect to DolphinDB with the client and conduct a test.

(1) Run the following script to download the installation package and configure the mapping file (take v2.00.5 for example):

git clone --depth=1 https://github.com/dolphindb/dolphindb-k8s && \
cd dolphindb_k8s/docker-single && \
sh map_dir.sh

(2) Run the following command:

tree /ddbdocker

Expected output:

├── ddbdocker
│   ├── data
│   ├── ddb_related
│   │   ├── dolphindb.cfg
│   │   └── dolphindb.lic
│   └── plugins
│       ├── hdf5
│       │   ├── libPluginHdf5.so
│       │   └── PluginHdf5.txt
│       ├── mysql
│       │   ├── libPluginMySQL.so
│       │   └── PluginMySQL.txt
│       ├── odbc
│       │   ├── libPluginODBC.so
│       │   └── PluginODBC.txt
│       └── parquet
│           ├── libPluginParquet.so
│           └── PluginParquet.tx

Description for the above files/folders:

(3) Start the container with the following script:

docker run -itd --name dolphindb \
-p 8848:8848 \
--ulimit nofile=1000000:1000000 \
  -v /etc:/dolphindb/etc \
  -v /ddbdocker/ddb_related/dolphindb.cfg:/data/ddb/server/dolphindb.cfg \
  -v /ddbdocker/ddb_related/dolphindb.lic:/data/ddb/server/dolphindb.lic \
  -v /ddbdocker/plugins:/data/ddb/server/plugins \
  -v /ddbdocker/data:/data/ddb/server/data \
  dolphindb/dolphindb:v2.00.5 \
  sh \
  -stdoutLog 1

The expected container ID: 3cdfbab788d0054a80c450e67d5273fb155e30b26a6ec6ef8821b832522474f5.

(4) Connect to DolphinDB with the client and conduct a test.

(1) Download the corresponding DolphinDB server image from the official website.

(2) Add map_dir.sh to the same directory as the downloaded ZIP archives as follows:

#!/bin/bash
set -e
clear
# Create a new folder to store the corresponding files
dir1=/ddbdocker
dir2=/ddbdocker/ddb_related

if [ ! -e "$dir1" ]; 
then
    mkdir $dir1
fi

if [ ! -e "$dir2" ]; 
then
    mkdir $dir2
fi


# Obtain the installation package
ddb_zip=$(ls ./DolphinDB_Linux64_V*.zip)
ddb_name=$(basename $ddb_zip .zip)

if [ -e $ddb_zip ];
then
    echo -e "Upload installation package successfully" "\033[32m UpLoadSuccess\033[0m"
else
    echo -e "The installation package cannot be found, please upload to this directory" "\033[31m UpLoadFailure\033[0m"
    echo ""
    sleep 1
    exit
fi
#解压安装包
unzip "${ddb_zip}" -d "${ddb_name}" 
if [ -d ./$ddb_name ];then
    echo -e "Unzip installation package successfully" "\033[32m UnzipSuccess\033[0m"
else
    echo -e "Unzip installation package failed, check if the installation package is downloaded completely" "\033[31m UnzipFailure\033[0m"
    echo ""
    sleep 1
    exit
fi

# Get the source and target files (folders) under the corresponding paths
source_f1=./${ddb_name}/server/dolphindb.cfg
source_f2=./${ddb_name}/server/dolphindb.lic
source_dir4=./${ddb_name}/server/plugins

f1=/ddbdocker/ddb_related/dolphindb.cfg
f2=/ddbdocker/ddb_related/dolphindb.lic
dir3=/ddbdocker/data
dir4=/ddbdocker/plugins


# Iterate over the target paths and set conditional statements to determine if existing files are to be overwritten
function isCovered() {  

for i in $*;
do
    if [ -e $i ];
    then
        #echo $i
        read -p "The $i has already existed, would you want to recover or clean it and other similar ones?(y/n)" answer
        if [ $answer=="y" ];
        then
            break
        else
            echo ""
            sleep 1
            exit
        fi
    fi
done
}

isCovered $f1 $f2 $dir3 $dir4

# Make a copy of the corresponding file (folder)
cp -rpf $source_f1 $f1
cp -rpf $source_f2 $f2

if [ -e "$dir3" ]; 
then
    rm -rf $dir3
fi

mkdir $dir3
cp -rpf $source_dir4 $dir4

# Delete the installation package
rm -rf ./${ddb_name}

(3) Run the following command:

sh map_dir.sh && tree /ddbdocker

Expected output:

├── ddbdocker
│   ├── data
│   ├── ddb_related
│   │   ├── dolphindb.cfg
│   │   └── dolphindb.lic
│   └── plugins
│       ├── hdf5
│       │   ├── libPluginHdf5.so
│       │   └── PluginHdf5.txt
│       ├── mysql
│       │   ├── libPluginMySQL.so
│       │   └── PluginMySQL.txt
│       ├── odbc
│       │   ├── libPluginODBC.so
│       │   └── PluginODBC.txt
│       └── parquet
│           ├── libPluginParquet.so
│           └── PluginParquet.tx

Description for the above files/folders:

(4) Start the container with the following script:

docker run -itd --name dolphindb \
  -p 8848:8848 \
  --ulimit nofile=1000000:1000000 \
  -v /etc:/dolphindb/etc \
  -v /ddbdocker/ddb_related/dolphindb.cfg:/data/ddb/server/dolphindb.cfg \
  -v /ddbdocker/ddb_related/dolphindb.lic:/data/ddb/server/dolphindb.lic \
  -v /ddbdocker/plugins:/data/ddb/server/plugins \
  -v /ddbdocker/data:/data/ddb/server/data \
  dolphindb/dolphindb:v2.00.5 \
  sh \
  -stdoutLog 1

The expected container ID: 3cdfbab788d0054a80c450e67d5273fb155e30b26a6ec6ef8821b832522474f5.

(5) Connect to DolphinDB with the client and conduct a test.

(1) Error messages:

Can't find time zone database. Please use parameter tzdb to set the root directory of time zone database.

Solution: If the Docker image does not contain the tzdata package (e.g., ubuntu:latest), the above error will be reported at startup. Execute the following command to install the tzdata package:

```bash
apt-get install tzdata
```

(2) Error messages:

```bash
<ERROR> : Failed to retrieve machine fingerprint
```

Solution: Since the official license requires machine fingerprint which Docker does not have access to, the above exception will be thrown in the logs at startup. You need to add the following parameters to docker run:

```bash
-v /etc:/dolphindb/etc 
```

(3) Error messages:

```bash
docker: Error response from daemon: driver failed programming external connectivity on endpoint dolphindb (178a842284d64fbe128ff3f1188ead76ef4072c9149226f8bf62dc7795a58603): Error starting userland proxy: listen tcp4 0.0.0.0:8848: bind: address already in use.
```

Solution: Change the port number of the host, or use the following command to check whether the port is available or not:

```shell
lsof -i:8848
COMMAND     PID USER   FD   TYPE    DEVICE SIZE/OFF NODE NAME
dolphindb 17238 root    6u  IPv4 231927135      0t0  TCP *:8848 (LISTEN)
```