Note: The information in this SAS Note applies only to SAS^® 9.3 metadata server environments. For information about resolving this issue for SAS^® 9.4 environments, see SAS Note 63028, "SAS^® Metadata Server for SAS^® 9.4 fails to start and you see an 'Element named MetadataServer is missing from the Backup Manifest' error."

The SAS^® Metadata Server fails to start if the MetadataServerBackupManifest.xml has been moved or deleted from its default location of configdir/Lev1/SASMeta/MetadataServer.

When the SAS Metadata Server is started, the file MetadataServerBackupManifest.xml is opened and read. If the file has been moved or deleted, the SAS Metadata Server creates a new file that contains a new, unique GUID. The SAS Metadata server then fails to start because the GUID in MetadataServerBackupManifest.xml does not match the GUID in MetadataServerBackupHistory.xml and MetadataServerBackupConfiguration.xml. The following message is written to the server log:

To avoid this problem, do not delete MetadataServerBackupManifest.xml from the configdir/Lev1/SASMeta/MetadataServer directory and do not move it to a different directory.

To recover from this problem:

Note: Any backups that were taken after the date of the restored MetadataServerBackupManifest.xml will not appear in backup history. However, the backup files can still be accessed if they are needed.

1. Remove the following files from Lev1/SASMeta/MetadataServer:
   • MetadataServerBackupHistory.xml
   • MetadataServerBackupConfiguration.xml
   • MetadataServerBackupManifest.xml
2. Restore MetadataServerBackupManifest.xml from the most recently available backup that contains the file.
3. Start the SAS Metadata Server. The SAS Metadata Server will create new instances of MetadataServerBackupHistory.xml and MetadataServerBackupConfiguration.xml.
4. Use SAS^® Management Console to run a current backup of the SAS Metadata Server.

The SAS Management Console Backup and Restore Wizards can be accessed on the Plug-ins tab by navigating to:

Operating System and Release Information

Product Family	Product	System	SAS Release
			Reported	Fixed*
SAS System	SAS Metadata Server	Microsoft Windows Server 2003 Enterprise Edition	9.3 TS1M0
		Microsoft Windows Server 2003 Standard Edition	9.3 TS1M0
		Microsoft Windows Server 2003 for x64	9.3 TS1M0
		Microsoft Windows Server 2008	9.3 TS1M0
		Microsoft Windows Server 2008 for x64	9.3 TS1M0
		Microsoft Windows XP Professional	9.3 TS1M0
		Windows 7 Enterprise 32 bit	9.3 TS1M0
		Windows 7 Enterprise x64	9.3 TS1M0
		Windows 7 Home Premium 32 bit	9.3 TS1M0
		Windows 7 Home Premium x64	9.3 TS1M0
		Windows 7 Professional 32 bit	9.3 TS1M0
		Windows 7 Professional x64	9.3 TS1M0
		Windows 7 Ultimate 32 bit	9.3 TS1M0
		Windows 7 Ultimate x64	9.3 TS1M0
		Windows Vista	9.3 TS1M0
		Windows Vista for x64	9.3 TS1M0
		64-bit Enabled AIX	9.3 TS1M0
		64-bit Enabled HP-UX	9.3 TS1M0
		64-bit Enabled Solaris	9.3 TS1M0
		HP-UX IPF	9.3 TS1M0
		Linux	9.3 TS1M0
		Linux for x64	9.3 TS1M0
		Solaris for x64	9.3 TS1M0
		Microsoft Windows Server 2003 Datacenter Edition	9.3 TS1M0
		Microsoft® Windows® for x64	9.3 TS1M0
		z/OS	9.3 TS1M0

* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.

---

The SAS® Metadata Server in SAS® 9.3 fails and the SAS environment is not available anymore if the MetadataServerBackup.Manifest.xml file is being deleted.

Type:	Usage Note
Priority:	high

Date Modified:	2012-05-02 12:35:34
Date Created:	2012-01-26 14:06:00