Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ML1 and version 5.3
Sv translation

This page describes how to upgrade Xpand. If you have any questions, please contact MariaDB Support.


  1. All nodes must be online. The output of clx stat should indicate a cluster status of OK.
  2. Confirm that the upgrade package you have is compatible with your current version of Xpand, including the OS version.

  3. Review the list of Upgrade Alerts included in the Release Notes. 
  4. All upgrades should be run as the Xpand daemon user (xpand)
  5. Passwordless SSH authentication must be configured for the Xpand daemon user (xpand). To verify this, confirm that the clx command returns successfully with no passwords requested: 

    shell> /opt/clustrix/bin/clx cmd 'date'  

    See Configuring SSH Authentication.

  6. Ensure that the clocks are synchronized between nodes. For instructions on syncing the clocks between nodes, see the Verify NTP is running on Xpand.

To upgrade:

All Xpand upgrade packages will upgrade the database and XpandGUI. The upgrader should be run from a single node and will upgrade all nodes in the cluster. Xpand does not support downgrades.


Performing an upgrade will incur a short period of downtime.

  1. Download the upgrade package to a single node 

  2. (Optional) if you are using a non-default ssh port, set an environment variable

    shell> export CLX_SSH_PORT= ssh_port_number
  3. Run the upgrader as the database daemon user (e.g. xpand). If the database has been installed with root users only, then run the upgrader as root. 

    shell> sudo su xpand
    shell> ./xpand-xpdnode- version install

    This will upgrade every node in the cluster. While the upgrade is in progress, there is a brief period during which the database is unavailable.


    Because of an issue with the mariadb/mysql client, the command sudo -u xpand <command> does not use the correct user for sql logins and the upgrade will fail with an error. To upgrade successfully you must sudo to the xpand user with sudo su xpand or log in as that user directly.

Once the database portion of the upgrade is complete, the cluster is online. The UI portion of the upgrade will continue but the database is available. To verify that the upgrade has succeeded successfully, examine the value for clustrix_version

sql> select @@clustrix_version;        
| @@clustrix_version
| +---------------------------------+
| clustrix-9.2
| +---------------------------------+
1 row in set (0.00 sec)

For more on how version strings are reported, see Xpand Version and MySQL Version Compatibility

Caveats for Upgrade

  • Upgrades cannot be run on clusters in read-only mode
Sv translation

질문이 있으시면 Clustrix 지원팀에 문의하십시오.

업그레이드 전 필수 사항

  1. 작동 가능한 clx 툴: 설치 과정에서는 clx 툴이 노드 간에 적절한 인증을 받을 수 있다고 가정합니다. 만약 이 툴이 작동하지 않으면 설치를 계속하기 전에 이 툴이 먼저 작동하도록 해야 합니다. 다음 명령을 실행하여 작동 여부를 확인할 수 있습니다.

    shell> /opt/clustrix/bin/clx cmd 'date'               
  2. 노드 간 시간 동기화: 모든 노드는 시차가 5초 이내여야 하며 그렇지 않으면 설치 프로그램이 종료됩니다. 노드 간 시간 동기화에 대한 지침은 Verify Chronyd is running on Xpand 를 참고하십시오.

노드 간 통신 설정에 대한 자세한 내용은 Network Security with Xpand를 참고하십시오.


ClustrixDB 소프트웨어 업그레이드 패키지는 데이터베이스 바이너리, ClustrixGUI 구성요소 및 기타 ClustrixDB 도구와 파일을 포함하여 가동 중인 ClustrixDB 소프트웨어를 업그레이드합니다. 이 패키지는 모든 노드의 소프트웨어를 업그레이드합니다. 설치가 완료되고 데이터베이스 프로세스가 재시작되므로 잠시 동안 클러스터를 사용할 수 없습니다.

  1. 임의 노드 중 하나에서 업그레이드 패키지를 /clustrix 디렉토리로 다운로드하십시오.
  2. 압축된 파일을 푸십시오.

    shell> tar -xf clustrix-clxnode-<version>-upgrade.gz 
  3. 설치 프로그램을 실행하십시오.

    shell> ./clustrix-clxnode-<version> install