Prepare deployment files
This topic describes how to prepare StarRocks deployment files.
Currently, the binary distribution packages StarRocks provides on the StarRocks official website support deployments only on x86-based CPU. If you want to deploy StarRocks with the ARM-based CPU, you need to prepare the deployment files using the StarRocks Docker image.
For x86-based CPU
From v3.1.14, v3.2.10, and v3.3.3, StarRocks binary distribution packages are named in the StarRocks-{Version}-{OS}-{ARCH}.tar.gz
format, where Version
is a number (for example, 3.3.3
) that indicates the version information of the binary distribution package, OS
indicates the operating system (including centos
and ubuntu
), and ARCH
indicates the CPU architecture (currently only amd64
is available, which is equivalent to x86_64). Make sure that you have chosen the correct version of the package.
In versions earlier than v3.1.14, v3.2.10, and v3.3.3, StarRocks provides binary distribution packages named in the StarRocks-{Version}.tar.gz
format.
Follow these steps to prepare deployment files for the x86-based platform:
-
Obtain the StarRocks binary distribution package directly from the Download StarRocks page or by running the following command in your terminal:
# Replace <version> with the version of StarRocks you want to download, for example, 3.3.3,
# and replace <OS> with centos or ubuntu.
wget https://releases.starrocks.io/starrocks/StarRocks-<version>-<OS>-amd64.tar.gz -
Extract the files in the package.
# Replace <version> with the version of StarRocks you want to download, for example, 3.3.3,
# and replace <OS> with centos or ubuntu.
tar -xzvf StarRocks-<version>-<OS>-amd64.tar.gzThe package includes the following directories and files:
Directory/File Description apache_hdfs_broker The deployment directory of the Broker node. From StarRocks v2.5 onwards, you do not need to deploy Broker nodes in general scenarios. If you need to deploy Broker nodes in your StarRocks cluster, see Deploy Broker node for detailed instructions. fe The FE deployment directory. be The BE deployment directory. LICENSE.txt The StarRocks license file. NOTICE.txt The StarRocks notice file. -
Dispatch the directory fe to all the FE instances and the directory be to all the BE or CN instances for manual deployment.
For ARM-based CPU
Prerequisites
You must have Docker Engine (17.06.0 or later) installed on your machine.
Procedures
From v3.1.14, v3.2.10, and v3.3.3, StarRocks provides Docker images in the starrocks/{Component}-{OS}:{Version}
format, where Component
indicates the component the image (including fe
, be
, and cn
), OS
indicates the operating system (including centos
and ubuntu
), and Version
is the version number (for example, 3.3.3
). Docker will automatically identify your CPU architecture and pull the corresponding image. Make sure that you have chosen the correct version of the image.
In versions earlier than v3.1.14, v3.2.10, and v3.3.3, StarRocks provides Docker images in the repositories starrocks/artifacts-ubuntu
and starrocks/artifacts-centos7
.
-
Download a StarRocks Docker image from StarRocks Docker Hub. You can choose a specific version based on the tag of the image.
# Replace <component> with the component you want to download, for example, fe,
# replace <version> with the version of StarRocks you want to download, for example, 3.3.3,
# and replace <OS> with centos or ubuntu.
docker pull starrocks/<Component>-<OS>:<version> -
Copy the StarRocks deployment files from the Docker image to your host machine by running the following command:
# Replace <component> with the component you want to download, for example, fe,
# replace <version> with the version of StarRocks you want to download, for example, 3.3.3,
# and replace <OS> with centos or ubuntu.
docker run --rm starrocks/<Component>-<OS>:<version> \
tar -cf - -C /release . | tar -xvf - -
Dispatch the deployment files to the corresponding instances for manual deployment.