Error messages
You can find information about the error messages associated with different SnapManager operations.
Most common error messages
The following table lists some of the most common and important errors associated with SnapManager for SAP:
Error message | Explanation | Resolution |
---|---|---|
|
SnapManager process does not have write access to the file system. |
You must ensure that the SnapManager process has write access to the file system. After correcting this, you may need to take another snapshot. |
|
The underlying volumes are not in a SnapVault or SnapMirror relationship. |
You must configure a data protection relationship between the source and destination volumes and initialize the relationship. |
|
Profiles with identical names cannot exist in a repository. |
Provide a profile name that is not in use. |
|
Dataset might have been deleted or does not exist. |
Before updating the dataset metadata, verify that the dataset exists by using the NetApp Management Console. |
|
Profile cannot be updated when backup, restore, and cloning operations are in progress. |
Update the profile after completion of the current operation. |
|
Retention duration of archive log backups cannot be negative. |
Specify a positive value for the retention duration of archive log backups. |
|
Database is not in the required state for a backup operation. |
Check that the database is in a relevant state before creating a backup copy. The state of the database that is to be restored depends on the type of restore process that you want to perform and the type of files that are to be included. |
|
Notification settings are not configured for the repository after a rolling upgrade. |
After a rolling upgrade, update summary notification settings to receive notifications. |
|
Label name contains special characters other than the underscore. |
The label name must be unique within the profile. The name can contain letters, numbers, an underscore (_), and a hyphen (-) (but cannot start with a hyphen). Ensure that labels do not contain any special characters except the underscore. |
|
The fully qualified domain name (FQDN) of the profile host is configured instead of the system's host name and the FQDN of the profile host cannot be resolved. |
Ensure that you use the system's host name and not the FQDN. |
|
The operation to restore a backup with control files fails to drop the control disk group. This issue occurs if there are stale backed up control files in the control disk group. |
Identify the stale backed up control files and manually delete them. |
|
Backup create operation failed to remove the backup copy from the catalog when SnapManager is integrated with RMAN. |
Check if there are any external scripts used for removing the backups from RMAN. Execute the |
|
Multiple Snapshot copies are created for a single operation ID. |
Delete the Snapshot copies manually and use scripts to delete the entries from the repository. |
System time and the time displayed by SnapManager in the log files do not match or not synchronized. |
A time zone change is not yet supported by Java 7. |
Apply the |
|
Data or control files or redo logs are multiplexed in an ASM database. |
Remove the Oracle multiplexing. |
|
SnapManager does not backup external tables (for example, tables that are not stored in .dbf files). This issue occurs because the database was not open during the backup, SnapManager cannot determine if any external tables are being used. |
There might have been external tables in the database that are not backed up as part of this operation (because the database was not open during the backup). |
|
Proper access privileges and roles are not set. |
Set access privileges or roles for the users who are trying to execute the command. |
|
There are more number of archive log files in the database than the maximum allowed. |
|
|
Archive log pruning fails in one of the destinations. In such a scenario, SnapManager continues to prune the archive log files from the other destinations. If any files are manually deleted from the active file system, the RMAN fails to prune the archive log files from that destination. |
Connect to RMAN from the SnapManager host. Run the RMAN |
|
The archive log files are manually deleted from the archive log destinations. |
Connect to RMAN from the SnapManager host. Run the RMAN |
|
Environment variables are set not set correctly in the pre-task or post-task scripts. |
Check if the pre-task or post-task scripts follow the standard SnapManager plug-in structure. For additional information about using the environmental variables in the script, see Operations in task scripts. |
|
When you perform an upgrade from SnapManager 3.2 for SAP to SnapManager 3.3 for SAP, the upgrade operation fails with this error message. This issue might occur because of one of the following reasons:
|
You must assign the values to the following parameters:
After modifying the parameter values, you must restart the database. For more information, see the Knowledge Base article 2017632. |
Error messages associated with the database backup process (2000 series)
The following table lists the common errors associated with the database backup process:
Error message | Explanation | Resolution |
---|---|---|
|
The archive log backup is taken along with the data files backup, and you tried to delete the archive log backup. |
Use the |
|
The archive log backup is associated with the database backup and is within the retention period, and you tried to delete the archive log backup. |
Use the |
|
You exclude some archive log files during the profile create or backup create operation. |
No action is required. |
|
The archive log files do not exist in the active file system during the profile create or backup create operation. These archived log files are not included in the backup. |
No action is required. |
|
No archive log files are created for the current database during the profile create or backup create operation. |
No action is required. |
|
All the archive log files are missing from the file system or excluded during the profile create or backup create operation. |
No action is required. |
|
You try to back up the cloned database that was created with the - |
Recover the cloned database or convert the database into a Data Guard Standby database. |
Error messages associated with the restore process (3000 series)
The following table shows the common errors associated with the restore process:
Error message | Explanation | Resolution |
---|---|---|
|
You attempted to restore a backup that has its storage resources freed without specifying a restore specification. |
Specify a restore specification. |
|
You attempted to restore a backup that has its storage resources freed along with a restore specification that does not contain mapping for all the files to be restored. |
Correct the restore specification file so that the mappings match the files to be restored. |
|
The online redo log files or archive log files cannot be used for recovery.This error occurs due to following reasons:
|
If the file mentioned in the error message is an archived log file and if you have manually provided for recovery, ensure that the file has full access permissions to Oracle.Even if the file has full permissions, and the message continues, the archive log file does not have any change numbers to be applied for recovery, and this message can be ignored. |
Error messages associated with the clone process (4000 series)
The following table shows the common errors associated with the clone process:
Error message | Explanation | Resolution |
---|---|---|
|
You are using SnapManager to create new clones; however, the dump destinations to be used by the new clone already exist. SnapManager cannot create a clone if the dump destinations exist. |
Remove or rename the old dump destinations before you create a clone. |
|
The clone creation fails when you create the clone from the standby database using the following setup:
|
Add the |
You did not provide a value for a parameter in the clone specification file. |
You must either provide a value for the parameter or delete that parameter if it is not required from the clone specification file. |
Error messages associated with the managing profile process (5000 series)
The following table shows the common errors associated with the clone process:
Error message | Explanation | Resolution |
---|---|---|
|
The dump operation cannot be performed when profile creation fails. |
Use |
Error messages associated with freeing backup resources (backups 6000 series)
The following table shows the common errors associated with backup tasks:
Error message | Explanation | Resolution |
---|---|---|
|
You attempted to perform the backup free operation using commands, when the backup is mounted or is marked to be retained on an unlimited basis. |
Unmount the backup or change the unlimited retention policy. If clones exist, delete them. |
|
You attempted to perform the backup free operation using commands, when the backup has been already freed. |
You cannot free the backup if it is already freed. |
|
You attempted to perform the backup free operation using commands, when the backup status is not successful. |
Try again after a successful backup. |
|
Using commands, you attempted to mount a backup that has its storage resources freed. |
You cannot mount, clone, verify, or perform backint restore on a backup that has its storage resources freed. |
Error messages associated with the rolling upgrade process (9000 series)
The following table shows the common errors associated with the rolling upgrade process:
Error message | Explanation | Resolution |
---|---|---|
|
You tried to perform rolling upgrade of a host, which does not exist in the previous repository version. |
Check whether the host exists in the previous repository using the |
|
You tried to perform roll back of a host, which does not exist in the new repository version. |
Check whether the host exists in the new repository using the |
|
You tried to roll back a host that contains new profiles existing in the repository. However, these profiles did not exist in the host of the earlier SnapManager version. |
Delete new profiles in the later or upgraded version of SnapManager before the rollback. |
|
You tried to roll back a later version of the SnapManager host that has mounted backups. These backups are not mounted in the earlier version of the SnapManager host. |
Unmount the backups in the later version of the SnapManager host, and then perform the rollback. |
|
You tried to roll back a later version of the SnapManager host that has backups that are being unmounted. |
Mount the backups in the later version of the SnapManager host, and then perform the rollback. |
|
You performed a rolling upgrade on a single host and then updated the repository for that host. |
Perform a rolling upgrade on all the hosts. |
|
You attempted to perform a rolling upgrade or rollback operation if the repository database is left in an inconsistent state. |
Restore the repository that you backed up earlier. |
Execution of operations (12,000 series)
The following table shows the common errors associated with operations:
Error message | Explanation | Resolution |
---|---|---|
|
While setting up the profile, you entered information about the host and port. However, SnapManager cannot perform these operations because the SnapManager server is not running on the specified host and port. |
Enter the command on a host running the SnapManager server. You can check the port with the |
Execution of process components (13,000 series)
The following table shows the common errors associated with the process component of SnapManager:
Error message | Explanation | Resolution |
---|---|---|
|
When creating a profile, you customized the Snapname pattern; however, you included special characters that are not allowed. |
Remove special characters other than letters, numbers, underscore, dash, and braces. |
|
When you were creating a profile, you customized the Snapname pattern; however, the left and right braces do not match. |
Enter matching opening and closing brackets in the Snapname pattern. |
|
When you were creating a profile, you customized the Snapname pattern; however, you included a variable that is not allowed. |
Remove the offending variable. To see a list of acceptable variables, see Snapshot copy naming. |
|
When you were creating a profile, you customized the Snapname pattern; however, you omitted the required |
Insert the required |
Error messages associated with SnapManager Utilities (14,000 series)
The following table shows the common errors associated with SnapManager utilities:
Error message | Explanation | Resolution |
---|---|---|
|
You did not enter the email address. |
Enter a valid email address. |
|
You did not enter the email subject. |
Enter the appropriate email subject. |
|
You did not enter the email server host name or IP address. |
Enter the valid mail server host name or IP address. |
|
You did not enter the email port number. |
Enter the email server port number. |
|
You did not enter the sender's email address. |
Enter a valid sender's email address. |
|
You enabled authentication and did not provide the user name. |
Enter the email authentication user name. |
|
You enabled authentication and did not provide the password. |
Enter the email authentication password. |
|
The port number, mail server, or receiver's email address is invalid. |
Provide proper values during email configuration. |
|
This could be due to invalid port number, invalid mail server, or invalid receiver's mail address. |
Provide proper values during email configuration. |
|
Notification sending failed, because notification configuration is not available. |
Add notification configuration. |
|
You have entered time in an incorrect format. |
Enter the time in the format: hh:mm. |
|
The date configured is incorrect. |
Date should be in the range from 1 through 31. |
|
The day configured is incorrect. |
Enter the day range from 1 through 7. |
|
The SnapManager server got shut down due to unknown reasons. |
Start the SnapManager server. |
|
You have not configured summary notification. |
Configure the summary notification. |
|
You have selected both the profile and summary notification options. |
Enable either the profile notification or summary notification. |
|
You have not enabled the success or failure options. |
You must select either success or failure option or both. |