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. |
|
After the protection policy of a dataset is set, SnapManager will not allow you to change the protection policy, because it might require realigning the baseline relationships and result in the loss of existing backups on the secondary storage. |
Update the protection policy using Protection Manager's Management Console, which provides more options on migrating from one protection policy to another. |
|
The host is not able to discover LUNs created on the storage systems. |
Ensure that the transport protocol is properly installed and configured. Ensure that SnapDrive can create and discover a LUN on the storage system. |
|
You tried to restore using the indirect storage method and the temporary volume specified does not exist on the primary storage. |
Create a temporary volume on the primary storage. Or, specify the correct volume name, if a temporary volume is already created. |
|
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). |
|
You tried to create a clone or mount Snapshot copies from the secondary storage of the latest protected backup. |
Clone or mount from an older backup. |
|
You tried to list protection policies on a system where SnapDrive is not configured to use Protection Manager. |
Install Protection Manager and configure SnapDrive to use Protection Manager. |
|
You tried to free or delete the latest protected backup or a backup containing Snapshot copies that are baselines in a mirror relationship. |
Free or delete the protected 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. |
|
|
SnapManager displays the backups as protected even if the protection job in Protection Manager is only partially successful. This condition occurs when dataset conformance is in progress (when the baseline Snapshots are getting mirrored). |
Take a new backup after the dataset is conformant. |
|
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 -no-resetlogs option. The cloned database is not a complete database.However, you can perform SnapManager operations such as creating profiles and backups, splitting clones, and so on with the cloned database, but the SnapManager operations fail because the cloned database is not configured as a complete database. |
Recover the cloned database or convert the database into a Data Guard Standby database. |
Data protection errors
The following table shows the common errors associated with data protection:
Error message | Explanation | Resolution | ||
---|---|---|---|---|
|
You try to create a backup with protection to secondary storage; however, the profile associated with this backup does not have a protection policy specified. |
Edit the profile and select a protection policy. Re-create the backup. |
||
|
You try to delete a profile that has protection enabled; however, Protection Manager is unavailable. |
Ensure that appropriate backups are stored in either primary or secondary storage. Disable protection in the profile. When Protection Manager is available again, return to the profile and delete it. |
||
|
While setting up the backup profile, you enabled protection on the backup so that the backup would be stored on secondary storage. However, SnapManager cannot retrieve the protection policies from Protection Manager Management Console. |
Disable protection in the profile temporarily. Continue creating a new profile or updating an existing profile. When Protection Manager is available again, return to the profile. |
||
|
While setting up the backup profile, you enabled protection on the backup so that the backup would be stored on secondary storage. However, SnapManager cannot retrieve the protection policies from Protection Manager's Management Console. The Protection Manager is not installed or SnapDrive is not configured. |
Install Protection Manager. Configure SnapDrive. Return to the profile, reenable protection, and select the protection policies available in Protection Manager's Management Console. |
||
|
While setting up the backup profile, you enabled protection on the backup so that the backup would be stored on secondary storage. However, SnapManager cannot retrieve the protection policies from Protection Manager's Management Console. |
Disable protection in the profile temporarily. Continue creating or updating the profile. When Protection Manager's Management Console is available, return to the profile. |
||
|
You attempted to create a backup profile. SnapManager creates a dataset for this profile. |
No action necessary. |
||
|
While setting up the backup profile, you attempted to enable protection on the backup so that the backup would be stored on secondary storage. However, SnapManager cannot access protection policies from Protection Manager's Management Console. The Protection Manager is not installed. |
Install Protection Manager. |
||
|
You deleted a profile. SnapManager will delete the associated dataset. |
No action is necessary. |
||
|
You attempted to delete a profile that has protection enabled; however, Protection Manager is no longer installed, or no longer configured, or has expired. SnapManager will delete the profile, but not the profile's dataset from Protection Manager's Management Console. |
Reinstall or reconfigure Protection Manager. Return to the profile and delete it. |
||
|
When setting up the retention policy, you attempted to use an invalid retention class. |
Create a list of valid retention classes by entering this command: Update the retention policy with one of the available classes. |
||
|
While setting up the profile, you enabled protection and entered a protection policy that is not available. |
Identify available protection policies, by entering the following command: |
||
|
You attempted to create a profile; however, the dataset for the same database profile already exists. |
Check the options from the existing profile and ensure that they match what you need in the new profile. |
||
|
You attempted to create a profile for a RAC database; however, the dataset for the same RAC database profile already exists. |
Check the options from the existing profile and ensure that they match what you need in the new profile. |
||
|
You attempted to create a profile with protection enabled and a protection policy selected. However, the dataset for the same database profile already exists, but has a different protection policy. SnapManager will use the newly specified policy for the existing dataset. |
Review this protection policy and determine if this is the policy you want to use for the dataset. If not, edit the profile and change the policy. |
||
|
The Protection Manager's Management Console deletes or frees the local backups created by SnapManager based on the retention policy defined in the Protection Manager. The retention class set for the local backups is not considered while deleting or freeing the local backups.When the local backups are transferred to a secondary storage system, the retention class set for the local backups on the primary storage system are not considered. The retention class specified in the transfer schedule is assigned to the remote backup. |
Run the |
||
|
You tried to disable protection for a protected profile while updating the profile from the SnapManager CLI or GUI. You can disable protection for the profile using the After a dataset is deleted, all secondary and tertiary backup copies are orphaned. Neither the Protection Manager nor SnapManager for SAP have the ability to access those backup copies. The backup copies can no longer be restored by using SnapManager for SAP.
|
This is a known issue in SnapManager for SAP and expected behavior within Protection Manager when destroying a dataset. There is no workaround.The orphaned backups need to be managed manually. |
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. |
|
You tried to restore from secondary storage, but Snapshot copies exist on the primary storage. |
Always restore from the primary if the backup has not been freed. |
|
During recovery, SnapManager tries to mount the latest backup from secondary to feed the archive log files from secondary.Though, if there are any other backups, the recovery can succeed. But, if there are no other backups, the recovery might fail. |
Do not delete the latest backups from primary, so that SnapManager can use the primary backup for recovery. |
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 is a LUN clone. This applies for Data ONTAP 8.1 7-mode as well as clustered Data ONTAP. |
SnapManager supports clone split on the FlexClone technology only. |
|
The operation ID is invalid or no clone split operation is in progress. |
Provide a valid split ID or split label for the clone split status, result, and stop operations. |
|
The split operation is complete. |
Check whether the split process is in progress by using the |
|
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. |
Virtual storage interface errors (virtual storage interface 8000 series)
The following table shows the common errors associated with virtual storage interface tasks:
Error message | Explanation | Resolution |
---|---|---|
|
SnapManager attempted to locate storage resources, but found data files, control files, or logs in the |
Check to see if data files, control files, or redo logs are in the
SAP uses four redo log groups with two members:
|
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 |
|
There could be multiple reasons for this error:
|
Check for the available space in the volume by using the |
|
This could be due to failure in the SnapDrive or storage system. |
Try working on a new clone. |
|
You are trying to split a clone that is already split. |
The clone is already split and the clone related metadata will be removed. |
|
You are trying to split a clone that is undergoing the split process. |
You must wait until the split operation completes. |
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. |
Common SnapDrive for UNIX error messages
The following table shows the common errors related to SnapDrive for UNIX:
Error message | Explanation |
---|---|
|
Initial configuration error |
|
LUN discovery error |
|
LUN discovery error |
|
LUN discovery error |
|
LUN discovery error |
|
LUN discovery error |
|
Initial configuration error |
|
Space issue |
|
LUN discovery error |
|
SnapDrive for UNIX generic error |