Skip to main content
Version: 2.5

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 CentOS 7.9. If you want to deploy StarRocks with the ARM architecture CPUs or on Ubuntu 22.04, you need to prepare the deployment files using the StarRocks Docker image.

For x86-based CentOS 7.9

StarRocks binary distribution packages are named in the StarRocks-version.tar.gz format, where version is a number (for example, 2.5.2) that indicates the version information of the binary distribution package. Make sure that you have chosen the correct version of the package.

Follow these steps to prepare deployment files for the x86-based CentOS 7.9 platform:

  1. 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, 2.5.2.
    wget https://releases.starrocks.io/starrocks/StarRocks-<version>.tar.gz
  2. Extract the files in the package.

    # Replace <version> with the version of StarRocks you have downloaded.
    tar -xzvf StarRocks-<version>.tar.gz

    The package includes the following directories and files:

    Directory/FileDescription
    apache_hdfs_brokerThe 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.
    feThe FE deployment directory.
    beThe BE deployment directory.
    LICENSE.txtThe StarRocks license file.
    NOTICE.txtThe StarRocks notice file.
  3. 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 or Ubuntu 22.04

Prerequisites

You must have Docker Engine (17.06.0 or later) installed on your machine.

Procedures

  1. Download a StarRocks Docker image from StarRocks Docker Hub. You can choose a specific version based on the tag of the image.

    • If you use Ubuntu 22.04:

      # Replace <image_tag> with the tag of the image that you want to download, for example, 2.5.4.
      docker pull starrocks/artifacts-ubuntu:<image_tag>
    • If you use ARM-based CentOS 7.9:

      # Replace <image_tag> with the tag of the image that you want to download, for example, 2.5.4.
      docker pull starrocks/artifacts-centos7:<image_tag>
  2. Copy the StarRocks deployment files from the Docker image to your host machine by running the following command:

    • If you use Ubuntu 22.04:

      # Replace <image_tag> with the tag of the image that you have downloaded, for example, 2.5.4.
      docker run --rm starrocks/artifacts-ubuntu:<image_tag> \
      tar -cf - -C /release . | tar -xvf -
    • If you use ARM-based CentOS 7.9:

      # Replace <image_tag> with the tag of the image that you have downloaded, for example, 2.5.4.
      docker run --rm starrocks/artifacts-centos7:<image_tag> \
      tar -cf - -C /release . | tar -xvf -

    The deployment files include the following directories:

    DirectoryDescription
    be_artifactsThis directory includes the BE or CN deployment directory be, StarRocks license file LICENSE.txt, and StarRocks notice file NOTICE.txt.
    broker_artifactsThis directory includes the Broker deployment directory apache_hdfs_broker. From StarRocks 2.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 for detailed instructions.
    fe_artifactsThis directory includes the FE deployment directory fe, StarRocks license file LICENSE.txt, and StarRocks notice file NOTICE.txt.
  3. Dispatch the directory fe to all the FE instances and the directory be to all the BE or CN instances for manual deployment.