Using a Codec-accelerated Node

Preparations

Submit a service ticket and consult the ECS service to obtain the driver and software packages of the codec-accelerated node.

You are advised to pack these installation packages, upload them to an OBS bucket, and make sure that the bucket address is accessible during node creation. The install_pkg.tar.gz package is used as an example.

Installing Drivers and Software Packages Using the Pre- or Post-installation Commands

• If the version of a cluster is earlier than v1.23.17-r0, v1.25.12-r0, v1.27.9-r0, v1.28.7-r0, or v1.29.3-r0, you can use post-installation command to deliver the driver and software installation commands.
  

  After clusters are upgraded to v1.23.17-r0, v1.25.12-r0, v1.27.9-r0, v1.28.7-r0, v1.29.3-r0, or later, if a node pool contains a codec-accelerated node, you need to install drivers and software packages using pre-installation command.

  Expand Procedure

  1. On the page for creating a node or node pool, expand (Optional) Advanced Settings.
  2. Configure post-installation command.

     

     The following is an example:

     # Replace the value with the actual address. install_pkg specifies the address for storing the driver and software packages. You need to make sure that the address can be accessed during node creation. OBS is recommended.
     install_pkg="xxx/install_pkg.tar.gz"
     #Installation package name
     install_pcie="vastai-pci-d3-2-v2-6-a1-6-sp5-xhs-hwtype-video_00.24.06.04_x86_64.rpm"
     install_gcc="gcc_make.tar.gz"
     install_dkms="dkms-2.6.1-6.hce2.noarch.rpm"
     install_container_runtime="vastai-docker-0.3.8.0-1.el7.x86_64.rpm"
     install_vaststream_sdk="vaststream-2.1.1_sp3-20230717-d00e24d-x86-av.tar.gz"
     install_tools="tools-2.2.1-davp1-202307251819-08bf515-x86-tools.tar.gz"
     install_path=/opt/vastai/
      
     mkdir -p ${install_path}
     cd ${install_path}
     wget $install_pkg -O install_pkg.tar.gz
     tar -zxvf install_pkg.tar.gz
     tar -zxvf ${install_gcc}
     rpm -ivh gcc_make/*.rpm --force --nodeps
     rpm -i ${install_dkms}
     rpm -i ${install_pcie}
     rpm -i ${install_container_runtime}
      
     sed -i 's/default_runtime_name = "runc"/default_runtime_name = "vastai"/g' /etc/containerd/config.toml
     cat > text001.txt <<EOF
             [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.vastai]
               privileged_without_host_devices = false
               runtime_engine = ""
               runtime_root = ""
               runtime_type = "io.containerd.runc.v2"
               [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.vastai.options]
                 BinaryName = "/usr/bin/vastai-container-runtime"
     EOF
     sed -i "/.containerd.runtimes\]/r text001.txt" /etc/containerd/config.toml
     systemctl daemon-reload && systemctl restart containerd
     rm -rf text001.txt
      
     # install tools
     tar -zxvf ${install_tools}
     mv tools-2.2.1-davp1-202307251819-08bf515-x86/tools ${install_path}
     ln -s ${install_path}/tools/vasmi /usr/bin/vasmi
      
     # install vaststream sdk
     tar -zxvf ${install_vaststream_sdk}
     ${install_path}/vaststream-2.1.1_sp3-20230717-d00e24d-x86/ai_video/AI1.5.0_VIDEO2.4.0_V2.1.1_SP3_20230717.bin
     source ${install_path}/vaststream/env.sh

• If the version of a cluster is 1.23.17-r0, 1.25.12-r0, 1.27.9-r0, 1.28.7-r0, 1.29.3-r0, or later, CCE detects the vc1-200t model and automatically modifies the containerd configurations. You can use pre-installation command to deliver the driver and software package installation commands.

  Expand Procedure

  1. On the page for creating a node or node pool, expand (Optional) Advanced Settings.
  2. Configure pre-installation command.

     

     The following is an example:

     # Replace the value with the actual address. install_pkg specifies the address for storing the driver and software packages. You need to make sure that the address can be accessed during node creation. OBS is recommended.
     install_pkg="xxx/install_pkg.tar.gz"
     #Installation package name
     install_pcie="vastai-pci-d3-2-v2-6-a1-6-sp5-xhs-hwtype-video_00.24.06.04_x86_64.rpm"
     install_gcc="gcc_make.tar.gz"
     install_dkms="dkms-2.6.1-6.hce2.noarch.rpm"
     install_container_runtime="vastai-docker-0.3.8.0-1.el7.x86_64.rpm"
     install_vaststream_sdk="vaststream-2.1.1_sp3-20230717-d00e24d-x86-av.tar.gz"
     install_tools="tools-2.2.1-davp1-202307251819-08bf515-x86-tools.tar.gz"
     install_path=/opt/vastai/
      
     mkdir -p ${install_path}
     cd ${install_path}
     wget $install_pkg -O install_pkg.tar.gz
     tar -zxvf install_pkg.tar.gz
     tar -zxvf ${install_gcc}
     rpm -ivh gcc_make/*.rpm --force --nodeps
     rpm -i ${install_dkms}
     rpm -i ${install_pcie}
     rpm -i ${install_container_runtime}
      
     # install tools
     tar -zxvf ${install_tools}
     mv tools-2.2.1-davp1-202307251819-08bf515-x86/tools ${install_path}
     ln -s ${install_path}/tools/vasmi /usr/bin/vasmi
      
     # install vaststream sdk
     tar -zxvf ${install_vaststream_sdk}
     ${install_path}/vaststream-2.1.1_sp3-20230717-d00e24d-x86/ai_video/AI1.5.0_VIDEO2.4.0_V2.1.1_SP3_20230717.bin
     source ${install_path}/vaststream/env.sh

Verifying the Installation

1. After the node is installed, log in to it.
2. Check whether the driver is installed:

   lsmod |grep vastai_pci

   If information similar to the following is displayed, the installation is successful.

   

3. Check the driver version:

   cat /dev/vastai0_version |grep Driver

   Information similar to the following is displayed.

   

4. Run the following command to check whether tools are installed:

   vasmi list

   If information similar to the following is displayed, the installation is successful.