Chat now with support
Chat with Support

Safeguard Authentication Services 4.1.5 - Management Console for Unix Administration Guide

One Identity Privileged Access Suite for Unix Introducing One Identity Management Console for Unix Installing Management Console for Unix Preparing Unix Hosts Working with Host Systems Managing Local Groups Managing Local Users Active Directory Integration Authentication Services Integration Privilege Manager Integration Reporting Setting Preferences Security Troubleshooting Tips
Auto Profile Issues Active Directory Issues Auditing and Compliance Cannot Create a Service Connection Point Check Authentication Services Agent Status Commands Not Available CSV or PDF Reports Do Not Open Database Port Number Is Already in Use Elevation Is Not Working Hosts Do Not Display Import File Lists Fakepath Information Does Not Display in the Console Java Applet Failures License Info in Report is not Accurate Out of Memory Error Post Install Configuration Fails on Unix or Mac Privilege Manager Feature Issues Profile Task Never Completes questusr Account was Deleted Readiness Check Failed Recovering From a Failed Upgrade Reports Are Slow Reset the Supervisor Password Running on a Windows 2008 R2 Domain Controller Service Account Login Fails Setting Custom Configuration Settings Single Sign-on (SSO) Issues JVM Memory Tuning Suggestions Start/Stop/Restart Management Console for Unix Service Tool Bar Buttons Are Not Enabled UID or GID Conflicts
System Maintenance Command Line Utilities Web Services Database Maintenance

Database Location and Files

Database Location

Management Console for Unix database files are located in the following locations:

  • On Unix/Mac: /var/opt/quest/mcu/db
  • On Windows XP/2003 Server: %SystemDrive%:\Documents and Settings\All Users\Application Data\Quest Software\Management Console for Unix\db
  • On Windows 2008 Server/Vista/7: %SystemDrive%:\ProgramData\Quest Software\Management Console for Unix\db
Database Files

The data for each database consists of multiple files located in the same directory. All the database files start with the same name as defined by the value in the jdbc.url key. For Management Console for Unix, the database consists of the following files by default:

Table 23: Database files
File Description
console.lck This file is used to determine if the database is in use. If console.lck exists, the server is currently running. This file is deleted once the database is properly shutdown. DO NOT BACKUP THIS FILE.
console This file contains the extra SQL statements that have modified the console database since the last checkpoint (something like the 'Redo-log' or 'Transaction-log', but just text.) For a normal shutdown this file is deleted once the database has completely shutdown.
console.properties This file contains general settings about the database including the console.properties entry 'modified'. If [modified=yes], the database is either running or was not closed correctly (because the close algorithm sets 'modified' to 'no' at the end).
console.script This file contains the SQL statements that make up the database up to the last checkpoint.

Database Backup Procedure

It is best to perform a backup when the HSQLDB is not running. use normal backup methods, such as archiving the files in a compressed bundle.

To backup a database

  1. Shutdown the HSQLDB server. (See Start/Stop/Restart Management Console for Unix Service for details about starting and starting the Management Console for Unix Service.)
  2. Copy the following files to a backup location: console.properties and console.script.
  3. Once the HSQLDB server is stopped, replace the files in the database directory (see Database Location and Files above) with the ones you previously backed up.
  4. Once you have replaced the files, start the HSQLDB server.

Note: If a backup immediately follows a checkpoint, then the console file can also be excluded, reducing the significant files to console.properties and console.script.

You can backup the files while the HSQLDB server is running, but make sure that a shutdown or checkpoint is NOT performed during the backup. If you perform a backup while the server is running, you will need to backup the console file, as well. This file will be deleted once the server is shutdown.

Database States

Use the following information to determine if the database was shutdown successfully.

State after shutting down the HSQLDB server:

  • The console.script file contains the information in the database, excluding data for text tables.
  • The console.properties file contains the entry [modified=no].
  • There is no console file.

Aborted database state (may happen by sudden power outage, Ctrl+C in Windows)

  • The console.properties file still contains the entry [modified=yes].
  • The console.script file contains a snapshot of the database at the last checkpoint and is OK.
  • The console file contains all the information to restore all the changes since the snapshot. As a result of abnormal termination, this file may be partially corrupt.
Related Documents