Foglight 5.9.4 - Installing Foglight on a UNIX System with an External Oracle Database

Manual database configuration

If you chose Manually create the repository database while installing the Management Server for use with an external database, there are two ways in which you can configure the database before starting the Management Server. Choose the one that best suits your needs:

Option 1 - Run the Foglight database tool to configure the database

Run Foglight’s database tool from the command line after exiting the installer. The database tool is located in the <foglight_home>/client/ directory.

NOTE: The database tool and scripts described do not create tablespaces. If you need to create new tablespaces, you must do so manually first, before running the database tool. See the Performance Tuning Field Guide for more information about Oracle® tablespaces.

NOTE: The -Ddb.admin.user must exist, and must have database administrator privileges.

NOTE: The tool creates the -Ddb.schema.username user when you run the command.

NOTE: To delete the database and start over, run the database tool with the dropdb option instead of the createdb option shown in the preceding example.

Option 2 - Run SQL scripts to configure the database

If you clicked Create during the database installation step, the SQL scripts in the<foglight_home>/scripts/sql directory are prepared with the provided configuration options. There are four SQL files for each database type ([dbtype]):

You can review these scripts before running them.

NOTE: Unless you are creating custom Oracle® tablespaces, you should not need to edit these scripts. If you are creating Oracle tablespaces, check with your database administrator to correctly assign tablespace names. It is recommended that you create a Foglight label for Data, Index, and Objects.

If custom tablespaces are configured in the storage-config.xml, as described in the Performance Tuning Field Guide, the database administrator must edit the oracle_create_db.sql script and add grants for the custom tablespaces. These grants are similar to the ones that grant a quota on the USERS tablespace. For example:

NOTE: In the example above, replace the italicized text (for example, SOME_CUSTOM_DATA_TABLESPACENAME_HERE) with the actual custom tablespace names defined in the storage-config.xml file.

You must run the configured scripts against the database using a third-party tool.

After you have run all four scripts, you can start the Management Server. Proceed to Starting and stopping the Management Server.

Initializing the database

For external databases, once the database has been successfully initialized, you can run Foglight.