Documentation

Installing, Rolling Back, and Uninstalling the CANN Cold Patch Package

The CANN package supports cold patch upgrade. That is, one or more library files can be upgraded separately. Therefore, the CANN cold patch package is released.

Restrictions

  • The cold patch can be used to upgrade only the corresponding baseline version or patch version.
  • For cold patches based on the same baseline version, ensure that the cold patch version to be installed is later than the previous cold patch version.
  • Only one cold patch version can be rolled back.
  • The cold patch package provides .run and .rpm software packages.

Impact of Installation and Rollback

  • Other maintenance operations are not allowed during installation and rollback.
  • Services will be interrupted during cold patch package installation and rollback.
  • After the cold patch package is installed or rolled back, services are not affected.

Operations Related to the CANN Cold Patch Package (.run)

The CANN cold patch package can be installed and rolled back. You can set the parameters as required. For details about the parameters, see Table 1.

For example, to install a cold patch, run the following command (replace xxx.run in the command with the actual package name):

1
./xxx.run --install
Table 1 Parameters supported by the patch package

Parameter

Description

--help | -h

Queries help information.

--version

Queries the software package version.

--info

Queries software package build information.

--list

Queries the software package list.

--check

Checks the consistency and integrity of software packages.

--quiet

Indicates silent installation, which skips interactive messages.

--nox11

Indicates that the graphical terminal window is not displayed during the installation.

--noexec

Decompresses a software package to the current directory without running the installation script. It is used together with --extract=<path> in the format of --noexec --extract=<path>.

--extract=<path>

Decompresses a software package to a specified directory.

--tar arg1 [arg2 ...]

Runs the tar command on the software package. Use the parameters following tar as the command parameters. For example, the --tar xvf command indicates that the RUN package will be decompressed to the current directory.

--install

Installs the cold patch package.

--rollback

Rolls back to the previous version.

--uninstall

Deletes the backup library file of the source version. Rollback is not supported.

--install-path=<path>

Specifies the installation path of the cold patch package.

The running user must have the read and write permissions on the specified path.

If no installation path is specified:

  • The installation path in the global configuration file ascend_cann_install.info is read first.
    You can run the following command to check whether the file exists in the following directory:
    • root user: /etc/Ascend
    • Non-root user: ${HOME}/Ascend
  • If ascend_cann_install.info does not exist in the current environment, the patch package is installed in the default path.
    • For installation as the root user, the default installation path is /usr/local/Ascend.
    • For installation as a non-root user, the default installation path is ${HOME}/Ascend.

Installing the CANN Cold Patch Package (.rpm)

  • If a non-root user is used for installation or rollback, the privilege escalation command is required. You need to obtain the sudo permission required for the command. After using the command, cancel the permission for high-risk commands. Otherwise, sudo privilege escalation may occur.
  • If you perform related operations as a non-root user, add sudo -E before the following commands. To install a cold patch as a non-root user, run sudo -E rpm -Uvh *.rpm.
The following is an example of the CANN cold patch package installation command (replace xxx.rpm with the actual full name of the software package):
1
rpm -Uvh xxx.rpm