Академический Документы
Профессиональный Документы
Культура Документы
Background........................................................................................................................................... 1 Known Issue ......................................................................................................................................... 2 Possible Causes................................................................................................................................. 3 Workarounds..................................................................................................................................... 4 Backing Up Shared Services ................................................................................................................ 4 Recovering from a Corrupted State ...................................................................................................... 5 Regular Recovery ............................................................................................................................. 5 Recovering from Catastrophic Failures ............................................................................................ 5
Background
Hyperion System 9 Shared Services ships with an embedded open-source LDAP server (OpenLDAP). OpenLDAP stores provisioning information, such as a list of users, their roles, and related information. In Windows environments, OpenLDAP is installed as the Hyperion SharedService9 OpenLDAP service, as shown in the Windows service control manager:
The OpenLDAP process (slapd) is shown running in the Windows task manager:
Known Issue
The Shared Services OpenLDAP service may become corrupted if it is not shut down properly. Corruption may happen if: The machine is forcibly shut down without a proper Windows shutdown. The OpenLDAP process is terminated from within Windows task manager. The OpenLDAP process is terminated when data is being written to the database. On laptops, the laptop lid is closed, causing the system to go into suspend mode.
Possible Causes OpenLDAP uses a file-based database (called BerkeleyDB, or BDB) to store its content. The OpenLDAP data files are stored in: c:\Hyperion\SharedServices\9.0\openLDAP\var\openldap-data
If you forcibly shut down the OpenLDAP system, the database is left in an inconsistent state from which it cannot recover when you try to restart the OpenLDAP service. If the service is corrupted, the following message is returned when you try to start it.
If the OpenLDAP service is corrupted, you cannot logon to Shared Services or any other System 9 products. The following error is returned when you attempt to log on as a valid user:
Workarounds Do not terminate the OpenLDAP service (slapd process) from the Windows task manager. Always properly shut down the operating system before shutting down the machine to ensure that all services are properly shut down. On laptops, shut down the Shared Services Windows service as well as the OpenLDAP service before putting the system in hibernate mode. These services can be stopped from the Windows service control manager or from the Windows Start menu item Stop Shared Services as shown below.
In development or demo environments, try running OpenLDAP as a process rather than running it as a service, described below.
Running OpenLDAP as a Process from the Command Line Navigate to the OpenLDAP folder in your Shared Services installation. The default location is: c:\Hyperion\SharedServices\9.0\openLDAP Command (debug mode): slapd -d 1 -f slapd.conf Command (production mode): slapd -f slapd.conf
To recover from a catastrophic failure: 1. Back up the current BDB data and log files stored in: c:\Hyperion\SharedServices\9.0\openLDAP\var\openldap-data 2. Restore all database and log files from the backup. The system now has a snapshot of data at the time of backup and the log files since the time of the backup. 3. Navigate to the BDB data folder and run the db_recover utility with the c option. BDB attempts to recover the database from the backup copy of the database files and the log files written since the database file snapshot was made.