Upgrade Process

Important Notes

To perform the upgrade, the installation directory needs to be uninstalled and then re-installed. If other files exist in the directory, they will also be deleted. Before this operation, ensure that all data is properly processed.

Procedure

To upgrade RAG SDK to the latest version, upload the latest RAG SDK package to the installation environment and run the following command in the directory where the package is located to upgrade RAG SDK: Execute the following commands as the HwHiAiUser user.

1. Run the --upgrade command.

   bash Ascend-mindxsdk-mxrag_<version>_linux-<arch>.run --upgrade --install-path=<Installation path> --platform=<npu_type>

   <version> indicates the version number, <arch> indicates the OS architecture, and <npu_type> indicates the chip type.

   Table 1 Parameter description

   Parameter	Description
   --upgrade	Upgrades the software package, i.e., upgrades RAG SDK to the version contained in the installation package.
   --platform	Corresponds to the Ascend AI Processor type. Run the npu-smi info command on the server where the Ascend AI Processor is installed, and then delete the last digit of Name. The obtained value is the value of --platform. If the Atlas 800I A3 SuperPoD Server is used, the value is A3.
   --install-path	(Optional) Customizes the root directory for installing the software package. If this parameter is not set, the directory where the current command is executed is used by default. The path must start with a slash (/) or tilde (~). The valid characters include letters (a-z and A-Z), digits (0-9), underscores (_), slashes (/), and hyphens (-). This parameter is recommended if a user-defined directory is used for installation. Ensure that RAG SDK has been installed in the configured path.
   --quiet	Indicates a silent operation.
   --whitelist	(Optional) Installs trustlist features. The value can be operator or whl. If multiple features need to be installed, separate them with commas (,).

   If the message "Do you want to upgrade to a newer version provided by this package and the old version will be removed? [Y/N]" is displayed during the upgrade, enter Y or y to proceed. In this case, the previous version of RAG SDK will be uninstalled. Entering any other key will cancel and exit the upgrade.

2. Check the command output. If the following information is displayed, the upgrade is successful.

   Upgrade RAG SDK successfully