Hyper Converged Infrastructure (HCI/aSV)

Sangfor HCI and aSV provide a unified infrastructure combining compute, storage, networking, and built-in security to simplify deployment, operations, and services.
{{sendMatomoQuery("Hyper Converged Infrastructure (HCI/aSV)","Abnormalities Troubleshooting")}}

Abnormalities Troubleshooting

{{ $t('productDocDetail.updateTime') }}: 2025-12-29

Pre-Upgrade Failures

Scenario

Versions

Solutions

Notes

Timeout while

distributing installation

package because the

management interface of the cluster controller only supports 100 Mbps.

Upgrade from

Earlier versions to HCI6.0.1 and

above.

Ensure the

management

interface supports at least 1000 Mbps

before the upgrade.

Management

interfaces less than

1000Mbps are

not supported.

Timeout while checking

update.suc.exec.precheck .flag and

update.rep.finished.flag during the upgrade.

Upgrade from

versions earlier than 5.8.6 to

versions earlier than 6.0.1.

Check the

configuration of

nodes in the cluster. Contact a Sangfor

technical support

representative to

mark nodes with low configuration to skip the check.

This problem

has been fixed and will not

occur while

upgrading

versions earlier than HCI5.8.6   to HCI6.0.1 and above.

Failed to verify the pre- upgrade check package because the memory

usage occupied by the running services is too high.

Upgrade from HCI5.8.6 to

HCI6.0.0 and above.

Restart the vtp-

datareport-server reporting service.

This problem

has been fixed and will not

occur when

upgrading

HCI5.8.7_R1 to


later versions.

Pre-upgrade check failed because the memory

usage occupied by the running services is too high, exceeding

expectations.

Upgrade from

HCI5.8.6 and

above versions to HCI6.0.0.

Contact a Sangfor

technical support

representative to

skip this check step.

This problem

has been fixed and will not

occur while

upgrading

earlier versions

to HCI6.0.1 and above.

The VXLAN interface is

configured with an IP

address but without an IP address pool.

Active upgrade.

Configure the VXLAN IP pool before the

upgrade.

This problem

will be

detected by

the pre-

upgrade check.

The IP address pool must be configured to start the

upgrade.

aCloud cannot be

upgraded after powering off the aCMP VM because aCloud is licensed by

aCMP.

Offline upgrade from HCI5.8.5.

Power on the aCMP VM to activate the   license, and do not power off it before restarting aCloud.

This problem

does not exist in other

versions.

In the upgrade retry

scenario, since other

nodes already have the

success marks of the pre- upgrade check, the

cluster control will be deleted after the pre- upgrade check, thus blocking the upgrade process.

Upgrade from

earlier versions to HCI5.8.6 and

later.

Contact a Sangfor

technical support

representative to

clean up the success marks of the pre-

upgrade check of other nodes.

-

0x0006/0x0005 is

reported during the pre- upgrade check of the

offline upgrade.

Upgrade from

Earlier versions to HCI5.8.6 and

later.

Contact a Sangfor technical support representative.

This problem

has been fixed and will not

occur while

upgrading

earlier versions to 6.0.1 and

later.


The ZK service

encountered an error during the active

upgrade.

Upgrade from

earlier versions to HCI5.8.6 and

later.

Upgrade again. If the problem persists,

please contact a Sangfor technical support

representative.

-

The virtual storage

service encountered an error during the pre-

upgrade check.

Earlier versions to HCI6.0.1.

Contact a Sangfor technical support representative.

This problem

exists only in HCI6.0.1.

Upgrade Failures

Method

Stage

Failure

Solutions

Whether

Rollback Is

Supported

Offline

Upgrade/Active

Upgrade

Check

Environment

for Upgrade

The

environment

check failed.

Troubleshoot

and try again. If the problem

persists, please contact a

Sangfor

technical

support

representative.

Yes, exit the

upgrade to roll back to the

original version.

Upload Update Package

The update

package

upload failed.

Pre-Upgrade Check

Pre-upgrade

check failed.

Upgrade

Host power

encountered an error.

Troubleshoot

and try again

(upgrades from

earlier versions to 5.8.6 and

above do not support retry).

If the problem

persists, please contact a

Sangfor

technical

support

representative.

No. To roll back

to the original

version, please contact a

Sangfor

technical

support

representative.

The host

management interface

encountered an error.

Other errors occurred.

Offline

Upgrade

Restart

Any error

occurred.

Contact a Sangfor  technical

support

Contact a Sangfor  technical

support


representative.

representative to confirm

whether

rollback is supported.