Skip to main content

Recover users.xml File on AhsayCBS

Article ID
5015
Last Reviewed Date
Product Version
AhsayCBS: 7.9 or above
Operating System
All Platforms
Description

This Know-How article will discuss how to recover a previous version of the users.xml file from a backup on AhsayCBS if:

  • the current copy of the AhsayCBS users.xml file is corrupted.
  • a backup user account was accidentally deleted from the AhsayCBS server.
  • some of the backup user accounts are missing.

A copy of the AhsayCBS user profile, users.xml file is compressed and backed locally to %AhsayCBS_Install%/conf/Backup folder automatically at 6:00 AM daily (format: dr-YYYY-MM-DD_Configuration.zip and dr-YYYY-MM-DD_Branding). The dr-YYYY-MM-DD_*.zip files are stored locally on AhsayCBS according to the following cycle which keeps up to a maximum of 24 copies; 7 daily copies, 5 copies - Monday of each week, 12 copies - 1st Monday of each month.

If the Auto Save feature is enabled on AhsayCBS then the file will be uploaded to the Ahsay License Server. For details refer to the Auto Save section of the AhsayCBS Administrator - System Settings Guide.

The dr-YYYY-MM-DD_Configuration.zip contains a backup of all system configuration files in the following folders:

  1. %AhsayCBS_Install%/conf
  2. %AhsayCBS_Install%/system/obs/policies
Solution

To recover the users.xml file, you need to extract the users.xml from a previous backup and copy it back to your %AhsayCBS_Install%/conf folder.

  1. Stop your AhsayCBS service.
  2. Go to the %AhsayCBS_Install%/conf/Backup folder and extract the users.xml file from the backup file dr-YYYY-MM-DD_Configuration.zip.

    • For AhsayCBS installation on Windows platform, you can use the 7-Zip utility to extract the users.xml
    • For AhsayCBS installation on Linux / Unix platform, you can use the gunzip utility to extract the users.xml
  3. Copy the users.xml file back to the AhsayCBS_Install/conf folder.
  4. Start your AhsayCBS service.
  5. Login to AhsayCBS web management console using system account.
  6. Go to Backup / Restore > Users, Groups, Policies > Backup User to list your backup user accounts.