Troubleshooting Errors Found During a Request an Upgrade or Test Upgrade

When you perform a request an upgrade or test upgrade operation, preupgrade checks run on your CommServe database to determine your readiness for an upgrade. If a preupgrade check fails, the error message also displays a workaround or recommendation to fix the error.

The following table displays the most common error messages found in the Preupgrade Readiness Report or in the log generated during a test upgrade:

Note

The following table does not include all the errors. If you do not find a particular error in the table, refer to the report or log file.

Error Message	Workaround
Current Release ‘13' is not supported for upgrade to 11.0. Supported versions are 14 and 15	The CommServe computer is from Commvault V8. You must upgrade the CommServe computer to V9 or V10 before you can upgrade to V11.
If you are upgrading an V9 CommServe: Current service pack level ‘SP XX’ is not supported for upgrade to version 11. You must install service pack ‘SP 14 or later’ before upgrading to version 11.	Install V9 Service Pack 14 or later on the production CommServe, and repeat the request for upgrade (or test upgrade) operation.
If you are upgrading an v10 CommServe: Current service pack level ‘SP XX’ is not supported for upgrade to version 11. Please install Service Pack ‘SP 11 or higher’ before upgrading to version 11.	Install V10 Service Pack 9 or later on the production CommServe, and repeat the request for upgrade (or test upgrade) operation.
#### ERROR : Duplicate client names found. #### Please resolve the following client name conflicts.	Rename the clients that have duplicate names, and repeat the request for upgrade (or test upgrade) operation. To rename a client, see Changing the Client Computer Name.
#### ERROR : Duplicate client host names found. #### Please resolve the following host name conflicts.	Rename the clients that have duplicate host names in the network, and repeat the request for upgrade (or test upgrade) operation.
#### ERROR : Spaces are not allowed in client names. #### Please rename the following client names.	Remove the spaces from the client names and repeat the request for upgrade (or test upgrade) operation. To rename a client, see Changing the Client Computer Name. Note: For client names associated with discovered virtual machines, the spaces are ignored.
There are clients with older software versions (more than two versions old). You must upgrade or de-configure the following clients. Following list may not be the complete list	Upgrade older clients to the same version as the production CommServe, and repeat the request for upgrade (or test upgrade) operation. Clients older than Commvault V9 are not supported. Note: Commvault V8 clients (running the UNIX File System Agent) are supported on the following operating systems: AIX 5.2, Red Hat Linux 3.8, SuSE Linux 9.x, and Ubuntu 7.x. If you want to continue to protect your V8 clients, contact deprecated@commvault.com.
Error for deprecated products that cannot be upgraded: The following clients have deprecated packages installed and cannot be upgraded. Error for deprecated products that can be upgraded: The following clients have deprecated packages installed. After upgrading to version 11, you can use this agent to recover data, but you cannot use it to archive data. To archive data, use the OnePass feature. For more information about OnePass, refer to the Documentation site.	Some products (such as agents and tools) were deprecated in Commvault V11. Most deprecated products are either replaced or merged with new products. For more information, see End-of-Life, Deprecated and Extended Support - Products.
The CommServe database is partially upgraded from a previous attempt. You must roll back the database and resume the upgrade.	Retry to restore the database dump and repeat the test upgrade operation.
Space available on disk [x] where log files of database [x] exist is less than 3 times the size of database. You must have at least [x] free space available on disk [x].	Verify that the computer hosting the standby CommServe has sufficient disk space. The CommServe upgrade might require at least three times the size of the current database.
The following MediaAgent is used for DR backup and need to be upgraded immediately after CS upgrade:	Informational message - No action required. Remember to upgrade the MediaAgent that is used for disaster recovery backups as soon as the CommServe is upgraded.
The following clients have Web Server or Web Client installed and need to be upgraded immediately after the CommServe upgrade:	Informational message - No action required. Remember to upgrade the Web Server and Web Client as soon as the CommServe is upgraded.
The following clients have delay upgraded packages installed and can only be upgraded later. Please refer to the documentation for details.	Some of your clients contain Commvault packages that currently do not support upgrades. Upgrades will be available in a future release.
The following clients have deprecated packages installed and cannot be upgraded	Uninstall deprecated packages, and repeat the request for upgrade (or test upgrade) operation. For more information on deprecated products, see End-of-Life, Deprecated and Extended Support - Products.
The following clients which need to be upgraded immediately also have deprecated or delay upgraded packages installed	Make sure to uninstall deprecated packages, or delayed upgrade packages, and upgrade the client as soon as the CommServe is upgraded.
CS cannot be upgraded with the following deprecated or delay upgraded packages installed	Make sure to uninstall deprecated packages, or the delayed upgrade packages, from the production CommServe, and repeat the request for upgrade (or test upgrade) operation.
The following version 9 clients have a service pack level lower than service pack 3. Before you retry the upgrade, make sure that these version 9 clients have service pack 3 or later.	Install V9 Service Pack 14 or later on all of the clients in your CommCell environment. Then, repeat the request for upgrade (or test upgrade) operation.
Please convert the database to SIMPLE from FULL before performing upgrade for DM2	Open the Web Server (DM2) database in the Microsoft SQL Server Management Studio and change the recovery model to simple. For instructions, see the Microsoft SQL Server Management Studio documentation.
The following version 10 MediaAgents hosting the DDB have a low service pack level. Before you retry the upgrade, make sure these MediaAgents have a minimum of Service Pack 11.	For MediaAgents that are hosting the deduplication database (DDB), make sure to install the following service packs: For V10, install Service Pack 11. For V9, install Service Pack 14.
The following MediaAgents might be hosting more than one active DDB on the same File system volume. This could cause severe performance issues with Deduplication based backups and pruning.	Informational message - No action required. If the deduplication databases (DDB) reside on the same volume, move the DDBs to separate volumes.
Found one or more disk libraries that use Dynamic or DRU Mount paths, which are no longer supported in Version 11. The following libraries are configured with DRU or Dynamic Mount paths. The upgrade process to Version 11 will fail if this is not corrected.	Deconfigure the Data Retention Utility (DRU) and the dynamic mount paths before you upgrade to V11.
The CommServe has both [Protected Virtual Machines] and [CPU Sockets on Hypervisor Hosts] licenses, which are mutually exclusive starting from version 11.	Contact your Software Provider and acquire a new license file with only one of the virtual machine licenses.
The following clients have database versions that are no longer supported in the latest software version.	Informational message - No action required. The clients will continue to operate in V11, but in backward compatibility mode.

Error Message

Workaround

Current Release ‘13' is not supported for upgrade to 11.0.

Supported versions are 14 and 15

The CommServe computer is from Commvault V8.

You must upgrade the CommServe computer to V9 or V10 before you can upgrade to V11.

If you are upgrading an V9 CommServe:

Current service pack level ‘SP XX’ is not supported for upgrade to version 11.

You must install service pack ‘SP 14 or later’ before upgrading to version 11.

Install V9 Service Pack 14 or later on the production CommServe, and repeat the request for upgrade (or test upgrade) operation.

If you are upgrading an v10 CommServe:

Current service pack level ‘SP XX’ is not supported for upgrade to version 11.

Please install Service Pack ‘SP 11 or higher’ before upgrading to version 11.

Install V10 Service Pack 9 or later on the production CommServe, and repeat the request for upgrade (or test upgrade) operation.

#### ERROR : Duplicate client names found.

#### Please resolve the following client name conflicts.

Rename the clients that have duplicate names, and repeat the request for upgrade (or test upgrade) operation.

To rename a client, see Changing the Client Computer Name.

#### ERROR : Duplicate client host names found.

#### Please resolve the following host name conflicts.

Rename the clients that have duplicate host names in the network, and repeat the request for upgrade (or test upgrade) operation.

#### ERROR : Spaces are not allowed in client names.

#### Please rename the following client names.

Remove the spaces from the client names and repeat the request for upgrade (or test upgrade) operation.

To rename a client, see Changing the Client Computer Name.

Note: For client names associated with discovered virtual machines, the spaces are ignored.

There are clients with older software versions (more than two versions old). You must upgrade or de-configure the following clients.

Following list may not be the complete list

Upgrade older clients to the same version as the production CommServe, and repeat the request for upgrade (or test upgrade) operation.

Clients older than Commvault V9 are not supported.

Note: Commvault V8 clients (running the UNIX File System Agent) are supported on the following operating systems: AIX 5.2, Red Hat Linux 3.8, SuSE Linux 9.x, and Ubuntu 7.x. If you want to continue to protect your V8 clients, contact deprecated@commvault.com.

Error for deprecated products that cannot be upgraded:

The following clients have deprecated packages installed and cannot be upgraded.

Error for deprecated products that can be upgraded:

The following clients have deprecated packages installed. After upgrading to version 11, you can use this agent to recover data, but you cannot use it to archive data. To archive data, use the OnePass feature. For more information about OnePass, refer to the Documentation site.

Some products (such as agents and tools) were deprecated in Commvault V11. Most deprecated products are either replaced or merged with new products.

For more information, see End-of-Life, Deprecated and Extended Support - Products.

The CommServe database is partially upgraded from a previous attempt.

You must roll back the database and resume the upgrade.

Retry to restore the database dump and repeat the test upgrade operation.

Space available on disk [x] where log files of database [x] exist is less than 3 times the size of database. You must have at least [x] free space available on disk [x].

Verify that the computer hosting the standby CommServe has sufficient disk space.

The CommServe upgrade might require at least three times the size of the current database.

The following MediaAgent is used for DR backup and need to be upgraded immediately after CS upgrade:

Informational message - No action required.

Remember to upgrade the MediaAgent that is used for disaster recovery backups as soon as the CommServe is upgraded.

The following clients have Web Server or Web Client installed and need to be upgraded immediately after the CommServe upgrade:

Informational message - No action required.

Remember to upgrade the Web Server and Web Client as soon as the CommServe is upgraded.

The following clients have delay upgraded packages installed and can only be upgraded later. Please refer to the documentation for details.

Some of your clients contain Commvault packages that currently do not support upgrades. Upgrades will be available in a future release.

The following clients have deprecated packages installed and cannot be upgraded

Uninstall deprecated packages, and repeat the request for upgrade (or test upgrade) operation.

For more information on deprecated products, see End-of-Life, Deprecated and Extended Support - Products.

The following clients which need to be upgraded immediately also have deprecated or delay upgraded packages installed

Make sure to uninstall deprecated packages, or delayed upgrade packages, and upgrade the client as soon as the CommServe is upgraded.

CS cannot be upgraded with the following deprecated or delay upgraded packages installed

Make sure to uninstall deprecated packages, or the delayed upgrade packages, from the production CommServe, and repeat the request for upgrade (or test upgrade) operation.

The following version 9 clients have a service pack level lower than service pack 3.

Before you retry the upgrade, make sure that these version 9 clients have service pack 3 or later.

Install V9 Service Pack 14 or later on all of the clients in your CommCell environment. Then, repeat the request for upgrade (or test upgrade) operation.

Please convert the database to SIMPLE from FULL before performing upgrade for DM2

Open the Web Server (DM2) database in the Microsoft SQL Server Management Studio and change the recovery model to simple.

For instructions, see the Microsoft SQL Server Management Studio documentation.

The following version 10 MediaAgents hosting the DDB have a low service pack level.

Before you retry the upgrade, make sure these MediaAgents have a minimum of Service Pack 11.

For MediaAgents that are hosting the deduplication database (DDB), make sure to install the following service packs:

For V10, install Service Pack 11.
For V9, install Service Pack 14.

The following MediaAgents might be hosting more than one active DDB on the same File system volume. This could cause severe performance issues with Deduplication based backups and pruning.

Informational message - No action required.

If the deduplication databases (DDB) reside on the same volume, move the DDBs to separate volumes.

Found one or more disk libraries that use Dynamic or DRU Mount paths, which are no longer supported in Version 11.

The following libraries are configured with DRU or Dynamic Mount paths. The upgrade process to Version 11 will fail if this is not corrected.

Deconfigure the Data Retention Utility (DRU) and the dynamic mount paths before you upgrade to V11.

The CommServe has both [Protected Virtual Machines] and [CPU Sockets on Hypervisor Hosts] licenses, which are mutually exclusive starting from version 11.

Contact your Software Provider and acquire a new license file with only one of the virtual machine licenses.

The following clients have database versions that are no longer supported in the latest software version.

Informational message - No action required.

The clients will continue to operate in V11, but in backward compatibility mode.