4.2. Version Management of OE Package¶
The version management tool of the unified release host package (ddk_vcs) is used to manage the versions of the dependency libraries and WHL packages in the D-Robotics OE package.
The following will show you how to use the tool in detail.
4.2.1. Function Overview¶
The following features are included in ddk_vcs:
ddk_vcs list.
ddk_vcs install.
ddk_vcs uninstall.
ddk_vcs patch.
ddk_vcs show.
4.2.2. Preparation¶
Attention
If you are using the install.sh provided with the OE package to install or operate with the docker environment, we have already done the setup for you and you can skip this preparation.
After completing the installation, you may need to set the environment variables before using the ddk_vcs tool.
To check whether the enviroment variables are set, in the terminal, run ddk_vcs --help, as follows:
[horizon@gpu-dev067]$ ddk_vcs --help
Please set the value (xj3/j5/x5) of environment variable DDK_VCS_MODE and run it again.
If you are prompted to set the enviroment variables, add a line export DDK_VCS_MODE=x5 to ~/.bashrc. Save the file and use the command source ~/.bashrc to make it take effect.
4.2.3. Detailed Information¶
Note
Please note that the version in the logs and commands below are for example only, the actual version is based on the version in your OE package.
4.2.3.1. Command: ddk_vcs list¶
The command ddk_vcs list is used to list the installed packages.
The parameters are as follows:
[horizon@gpu-dev067]$ ddk_vcs list --help
Usage: ddk_vcs list [OPTIONS]
List installed packages.
Options:
-l, --local Show all existing packages(*.tar.gz) on host machine.
--help Show this message and exit.
When this command is executed without any parameter, it returns the information of each module currently installed, see the following example:
[horizon@gpu-dev067]$ ddk_vcs list
Host package version: x5 v1.1.49b
The following packages versions
Platform Package Version MD5
--------------- -------------- -------- -------------
aarch_64 dnn 1.17.3d 6c1cb8d48c
x86_64_gcc11.4 dnn_x86 1.17.3d 5e5e864dce
x86_64_gcc11.4 horizon-nn 0.17.1 origin:0.17.1
x86_64_gcc11.4 horizon-nn-gpu N/A origin:N/A
x86_64_gcc11.4 horizon-tc-ui 1.16.2 origin:1.16.2
x86_64_gcc11.4 hbdk 3.44.7 origin:3.44.7
Note
After each installation by using the install script in the OE package, the origin information in the last few rows will be updated to the current environment version, which will not be changed in subsequent installations using ddk_vcs and only Version will be changed.
Using the -l argument will display the current version of the module that can be installed, as shown in the below example:
[horizon@gpu-dev067]$ ddk_vcs list -l
Host package version: v1.1.49b
The following packages versions
Platform Local Package Version MD5
--------------- ---------------------- -------- ----------
aarch_64 dnn_1.17.3d.tar.gz 1.17.3d 6c1cb8d48c
x86_64_gcc11.4 dnn_x86_1.17.3d.tar.gz 1.17.3d 5e5e864dce
You can install these modules using the command ddk_vcs install.
4.2.3.2. Command: ddk_vcs install¶
The command ddk_vcs install is used to install the installation package.
The parameters are as follows:
[horizon@gpu-dev067]$ ddk_vcs install --help
Usage: ddk_vcs install [OPTIONS] MODULE_FILE...
Install packages.
Options:
-p, --platform [aarch_64|x86_64_gcc11.4]
Platform name
--help Show this message and exit.
You can install the corresponding module tarball directly by using ddk_vcs install, as shown in the below example:
Note
You need to specify the corresponding platform during installation.
[horizon@gpu-dev067]$ ddk_vcs install dnn_1.17.3d.tar.gz -p aarch_64
dnn installed successfully, version: 1.17.3d, platform: aarch_64
[horizon@gpu-dev067]$ ddk_vcs install hbdk-3.44.7-cp38-cp38-linux_x86_64.whl horizon_nn-0.17.1-cp38-cp38-linux_x86_64.whl
hbdk-3.44.7-cp38-cp38-linux_x86_64.whl installed successfully
horizon_nn-0.17.1-cp38-cp38-linux_x86_64.whl installed successfully
By using ddk_vcs list -l, you can get the version information of each module package in the current host package.
Then use ddk_vcs install to easily switch between the versions, as shown in the below example:
[horizon@gpu-dev067]$ ddk_vcs install dnn==1.15.2 --platform aarch_64
dnn installed successfully, version: 1.15.2, platform: aarch_64
If the corresponding version is not available on the local host, you can install it by specifying the location of the installation package.
4.2.3.3. Command: ddk_vcs uninstall¶
The command ddk_vcs uninstall is used to uninstall the specified module.
The parameters are as follows:
[horizon@gpu-dev067]$ ddk_vcs uninstall --help
Usage: ddk_vcs uninstall [OPTIONS] MODULE...
Uninstall packages.
Options:
-p, --platform [aarch_64|x86_64_gcc11.4]
Platform name [required]
--help Show this message and exit.
The example is as follows:
[horizon@gpu-dev067]$ ddk_vcs uninstall dnn --platform aarch_64
Start to uninstall modules, platform: aarch_64
dnn uninstalled successfully, version: 1.17.3d, platform: aarch_64
4.2.3.4. Command: ddk_vcs patch¶
By using the command ddk_vcs patch ddk_patch.tar.gz, you can install the pre-made patch package.
The example is as follows:
[horizon@gpu-dev067]$ ddk_vcs patch ddk_patch.tar.gz
dnn installed successfully, version: 1.15.2_patch0, platform: aarch64
4.2.3.5. Command: ddk_vcs show¶
The command ddk_vcs show is used to display information about the installed packages. Use ddk_vcs show [module name] to show information about the corresponding module.
The parameters are as follows:
[horizon@gpu-dev067]$ ddk_vcs show --help
Usage: ddk_vcs show [OPTIONS] MODULE
Show information about installed packages.
Options:
-p, --platform [aarch_64|x86_64_gcc11.4]
Platform name
--help Show this message and exit.
The example is as follows:
[horizon@gpu-dev067]$ ddk_vcs show dnn
Host package version v1.1.49b
The following packages versions
Platform Package Version MD5
-------- ------- ------- ----------
aarch_64 dnn 1.17.3d 6c1cb8d48c