Skip to content

Environment Setup

1. Development Environment Preparation

📝 The IPU_Toolchain is written based on the AVX2 instruction set. Please run it on a processor that supports AVX2.

Recommended Configuration

🖥️💻 ⚙️
CPU Intel® Xeon® Gold 6242 or Higher
RAM 256G or Higher

最低配置

🖥️💻 ⚙️
CPU Intel® CoreTM i7
RAM 32G

1.1 Installing the Docker Development Environment

Load the SGS docker image file.

tar -Jxvf sgs_docker_v1.8.tar.xz
docker load < sgs_docker_v1.8.tar

Run the SGS docker.

./run_docker.sh

Usage

Explanation of the docker run parameters in the run_docker.sh file. Users can modify these configuration parameters according to their needs:

  • -i / --interactive: Keeps the container's standard input (stdin) open, enabling user interaction with the container.
  • -t / --tty: Allocates a pseudo-terminal (TTY), typically used with -i to provide an interactive shell within the container.
  • --net=host: Uses the host's network stack.
  • --privileged: Enables privileged mode, granting the container access to host machine devices and kernel functionality (e.g., device mounting, kernel module usage).
  • --name: Specifies a custom name for the container to simplify future Docker operations.
  • --ulimit core=-1: Sets the container's core file generation limit. -1 removes the limit, allowing creation of core files of any size.
  • -v /:/work: Mounts the host's root directory / to the container's /work directory (the path /work will be created automatically if it doesn't exist).
  • env LANG=C.UTF-8: Sets the environment variable LANG=C.UTF-8 during container execution to ensure applications correctly support UTF-8 encoding.
  • /bin/bash: Command executed when the container starts (launches a Bash shell). The -it option enables interactive shell access.

1.2 SGS_IPU_Toolchain Environment Setup

Usage

The newly created Docker container does not contain the IPU Toolchain. Please obtain the IPU Toolchain from the mounted path within the container (the mounted path is specified in the -v parameter in run_docker.sh), or use the docker cp command to copy the IPU Toolchain into the container for use.

Navigate to the SGS_IPU_Toolchain directory to set up the environment.

cd /path/to/SGS_IPU_Toolchain
source cfg_env.sh