Installing the Administration Server

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Setting Up and Administering the Database

This section provides information and guidelines to assist you in installing, configuring, and managing an Oracle or Sybase database server to use with the AquaLogic Enterprise Security Administration Server.

Note: As of ALES verion 2.5, additional database types such as MS-SQL and PointBase are also supported. These other supported database servers are not covered in this section.

This information is not meant to replace or supersede in any way the database documentation provided by Oracle and Sybase for their database server and client products. Also, the information provided here assumes that you are familiar with the Oracle database documentation.

Note: In prior versions of ALES, if you installed the Administration Server on a machine other than the machine on which you installed the database, you must have also installed and configured the respective Oracle or Sybase client on that machine.
Note: As of version 2.5, the database runtime client is not required; only the JDBC Driver is required in this release.

BEA AquaLogic Enterprise Security stores all policy and configuration data used by the Administration Server and Security Service Modules in the policy database. You can use either an Oracle database or a Sybase database for your policy data storage. You must install and configure the database server software before you install the Administration Server.

Note: To perform a database installation and setup, you must be a database administrator with a database administrator username and password and permission to create a new instance. In addition, you should be knowledgeable about the operating system you are working with and be adept at database installations and configuration issues. If you do not feel comfortable performing any of these tasks, ask your database administrator for assistance.

This section covers the following topics:

 


Setting Up and Administering the Oracle Database

This section contains the procedures for setting up and administering an Oracle database. It covers the following topics:

Before you Begin the Oracle Database Setup

Before you install and set up your Oracle database, review the following topics to better understand Oracle database configuration requirements:

Overview of the Oracle Client/Server Architecture

Each Oracle service is identified by a global database name and an Oracle system identifier referred to as the SID (see Figure A-1). The Oracle global database name is the full name of a database that uniquely differentiates it from any other databases in your network domain. One global database name can represent several database instances. The global database name is also known as the service name. The SID distinguishes the database instance from any other database instances on the same machine.

Figure A-1 Oracle Database Setup

Oracle Database Setup

An Oracle instance is a running Oracle database made up of memory structures and background processes. Each instance is associated with an SID. With the Oracle Parallel Server, multiple instances can exist on different machines for a single database.

The policy database is a set of database schemas in which all data are stored. A database schema is a collection of objects associated with a particular schema name. The objects include tables, views, domains, constraints, assertions, privileges, and so on.

A datafile is an Oracle term for a file that contains the contents of logical database structures, such as tables and indexes. One or more datafiles form a logical unit of storage called a tablespace. A datafile is associated with only one tablespace and only one database.

A tablespace is a logical portion of a database used to allocate storage for table and index data. Each tablespace corresponds to one or more physical datafiles. Every Oracle database has a tablespace called SYSTEM and may have additional tablespaces. A tablespace is used to group related logical structures. The database username or user ID is a login that is given permission by the database administrator to access a specific database instance. This user is also called the schema owner, that is, the owner of the schema objects such as tables, views and triggers that are created.

Oracle Database System Requirements

Table 0-1, Oracle Setup Requirements, on page A-4 describes the minimum requirements for the system on which the Oracle database server is installed.

Table 0-1 Oracle Setup Requirements 
Requirement
Description
Software version
Oracle database server:
  • Version 9i Release 2 (9.2.x)
  • Version 10g Release 1 (10.1.0.4)
Server platform
Any platform supported by Oracle.
Memory
As required by Oracle server installation (64 MB minimum).
Disk space for the starter database
As required by Oracle server installation, plus space required to store policy data; 500 MB recommended.
Disk space for Oracle software
Refer to your installation guide for the Oracle Database Server.
Disk space for policy database
Minimum of one tablespace with 250 MB of free space is required.

Installing and Configuring the Oracle Database

This section provides additional instructions for installing and configuring an Oracle database for use with the AquaLogic Enterprise Security Administration Server.

To install and configure the database, perform the following tasks:

Installing the Oracle Database

This section provides recommendations for installing the Oracle database and creating a database instance. When you run the Oracle installation program, it automatically starts the Database Configuration Assistant, which you use to create an instance of the database. If the Oracle database is already installed on the database host machine, you can skip this procedure and go to Creating an Instance of an Oracle Database.

To install the Oracle database and create a database instance, perform these steps:

  1. Ensure that the system requirements are satisfied as defined in Table 0-1 and install the Oracle database according to instructions in the Oracle Database Installation Guide. When the Oracle Universal installer runs, select the install options as specified in Table 0-2. For other installer options, accept the default settings or set them as you desire.
  2. Table 0-2 Recommended Selections in the Oracle Universal Installer
    Installer Option
    Recommended Selections
    Available Products
    Oracle 9i Database 9.2.x
    Installation Types
    Enterprise Edition
    Database Configuration
    General Purpose
    Oracle MTS Recovery Service Configuration Port Number
    Accept the default setting.
    Global Database Name (For Oracle 10g only)
    The full Oracle database name that distinguishes the database from any other databases in your network domain, for example asi.ales, where asi is the database name and ales is the domain.
    Database System Identifier (For Oracle 10g only)
    The Oracle system identifier (SID). The SID distinguishes the database instance from any other database instances on the same machine, for example asi,
    Passwords (For Oracle 10g only)
    The install program creates four user accounts, SYS, SYSTEM, SYSMAN, and DBSNMP and assigns default passwords. During the installation, you are prompted to change these passwords. For security reasons, Oracle recommends that you specify new passwords for these user accounts when you install the database software. Be sure to record your password settings as you will need them later.

  3. For Oracle 9i, when the Database Configuration Assistant starts, step through the screens and use the settings specified in Table 0-3.
  4. Note: For Oracle 10g, the Database Configuration Assistant is run after the installer program (just as it is with Oracle 9i), however, for 10g, it does not prompt you for input.

    Table 0-3 Oracle 9.1.2 Database Configuration Assistant Settings
    Database Configuration Assistant Screen
    Recommended Setting
    Step 1 of 8: Operations
    Select Create a database, and click Next.
    Step 2 of 8: Templates
    Select New Database, and click Next

    Note: This selection specifies the template to use to create the instance of the database.

    Step 3 of 8: Database Identification
    Specify the Global Database Name, for example asi.ales.
    Specify the SID, for example asi, and click Next.
    Step 4 of 8: Database Features
    Set these check boxes to on: Oracle spatial, Oracle Ultra Search, Oracle Data Mining, Oracle OLAP, Example Schemas and all check boxes below, and click Next.
    Step 5 of 8: Database Connection Options
    Select Dedicated Server Mode, and click Next
    Step 6 of 8: Initialization Parameters
    Select the Memory tab, click the Custom radio button, and set the parameters as follows:
    • Shared Pool: 69 Mbytes
    • Buffer Cache: 24 Mbytes
    • Java Pool: 32 Mbytes
    • Large Pool: 8 Mbytes
    • PGA: 24 Mbytes
    Click Next.
    Step 7 of 8: Database Storage
    Click Next. The Database Assistant creates the database.
    Database Configuration Assistant
    Set passwords for the SYS and SYSTEM accounts and record these passwords as you will need them later. Click Exit. The Database Assistant completes.
    End of Installation
    Click Exit.

  5. For Oracle 9i, do one of the following to set your system PATH environment variables:
    • For Windows systems, set the environment variables as shown in Listing 0-1.
    • For Solaris and Linux systems, refer to the Oracle Installation Guide Release 2 (9.2.0.1.0) for UNIX systems for instructions.
    • Listing 0-1 Oracle 9i System PATH Environment Variable Settings for Windows
      <drive>:\oracle\ora920\bin;
      C:\Program Files\Oracle\jre\1.3.1\bin;
      C:\Program Files\Oracle\jre\1.1.8\bin;
      Where <drive> is the hard drive on which the Oracle database is installed.
  6. For Oracle 10g, do one of the following to set environment variables:
    • On Microsoft Windows, the installer program sets the environment variables for you.
    • On Solaris, refer to the Oracle Database Installation Guide 10g release 1 (10.1.0.4) for Solaris.
    • On Linux, refer to the Oracle Database Installation Guide 10g release 1 (10.1.0.4) for Linux.
  7. If you want to allow remote connections to this database instance, proceed to Configuring the Oracle Database Listener for Remote Connections.

Configuring the Oracle Database Listener for Remote Connections

To configure the Oracle database to accept remote connections from the Administration Server, you must configure an Oracle listener. This would only be necessary if you intend to install the Administration Server on a machine other than the machine on which the Oracle data is installed.

To configure an Oracle listener, perform the following steps:

  1. Start the Oracle Net Configuration Assistant and respond to the assistant screens as directed in Table 0-4.
  2. Table 0-4 Oracle Listener Setting
    Assistant Screen
    Setting
    Welcome
    Select Listener configuration, and click Next.
    Listener
    Select Add, and click Next.
    Listener Name
    Enter listener name, for example, asi, and click Next.
    Select Protocols
    Select TCP, and click Next.
    TCP/IP Protocol
    Select the standard port 1521, and click Next.

  3. To verify that the listener is configured, open a command window on a remote system and enter this command: SQLplus system/password@listenername.
  4. where password is the password you assigned to the SYSTEM account upon installation and listenername is the name you assigned to the Oracle listener, for example asi.

Creating an Instance of an Oracle Database

This section describes how to create and configure an instance of an Oracle database. It assumes that the Oracle database software was installed.

Note: You should only perform this procedure when you want to create and configure instances of the database in addition to the instance that was created when the database software was installed.

Perform the following steps to create an instance of an Oracle database:

Note: The section provides guidance to assist you, but it does not supersede the documentation provided by Oracle.
  1. To start the Oracle Database Configuration Assistant, click Start>Programs>Oracle-<OraHome>Configuration and Migration Tools>Database Configuration Assistant, where OraHome indicates the version of the software. The Database Configuration Assistant starts.
  2. When the Database Configuration Assistant starts, step through the screens and select settings as specified in Table 0-3.

Administering an Oracle Policy Database

This section covers the following topics:

Using the Database Administration Utilities with Oracle

lists and describes the batch and shell files provided for database administration. The files are located in the following directory:

bea\ales25-admin\bin\

where:

Before running these scripts with an Oracle database, you need to ensure the following setup steps are completed:

Backing Up an Oracle Database

BEA strongly recommends that you backup your original policy database regularly. A database backup is always recommended before you uninstall or re-install the policy database. You may need to contact your database or system administrator to assist with this process. Backups should be done on a regularly scheduled basis.

For instructions on backing up your Oracle database, see the Oracle Backup and Recovery Guide that comes with your Oracle documentation.

 


Setting Up and Administering the Sybase Database

This section contains the procedures for setting up and administering an Sybase database. It covers the following topics:

Before you Begin the Sybase Database Setup

Before you begin to set up your Sybase database, review the following topics to better understand Sybase database configuration requirements:

Overview of the Sybase Client/Server Architecture

The Sybase Adaptive Server is the server in the Sybase client/server architecture (see Figure A-2). It manages multiple databases and multiple users, keeps track of the actual location of data on disks, maintains mapping of logical data description to physical data storage, and maintains data and procedure caches in memory.

The policy database is a set of database schemas in which all data are stored. The Sybase database contains a set of related data tables and other database objects organized and presented to serve a specific purpose.

A database device is a Sybase term that represents the portion of a device (a portion of a hard drive, such as a partition) that is dedicated to holding database data. When creating the database device, you can choose either a raw partition or an existing file system. Choosing a raw partition can increase the performance of the database server.

Figure A-2 Sybase Adaptive Server Setup

Sybase Adaptive Server Setup

The Database Login ID is a login created by a system administrator to log onto the Adaptive Server. Each Database Login has a password and a default database to access. A login is valid if the Adaptive Server has an entry for that user in the system table syslogins.

The Database Administrator (DBA) has a special database login ID that can access all databases in the Adaptive Server. The DBA is also referred to as the system administrator. In fact, the name of the DBA login is sa (for System Administrator).

The Database Owner (DBO) is a special database login with permission to perform all actions on a policy database. Usually, the login that creates the database automatically becomes the DBO. The Database User ID is dbo (lowercase), which is different from its Database Login ID. For your policy database, you can use any Database Login ID as the DBO.

The Database User ID pertains to one specific database and is a login given permission by the DBO or DBA (system administrator) to access that one database. In most cases, the database user ID is the same as the Database Login ID. However, in some cases, they may be different, as with the special dbo user ID.

A database schema is a collection of objects associated with a particular schema name. The objects include tables, views, domains, constraints, assertions, privileges, and so on.

The policy owner is a Database User ID that controls the set of database schema in the database. BEA recommends that you not use dbo as a policy owner because it requires special administration. The AquaLogic Enterprise Security architecture allows multiple policy owners in its database, each owning a policy different from the other policies.

Sybase Database System Requirements

Table 0-6 describes the minimum requirements for the system on which the Sybase Adaptive Server is installed.

Table 0-6 Sybase Database Minimum Requirements 
Requirement
Description
Software Version
Sybase Adaptive Server Enterprise 12.5.2.
Server Platform
Any platform supported by Sybase.
Memory
As required by Sybase server installation (42 MB minimum).
Disk Space for the default database
As required by Sybase server installation.
Disk Space for Sybase software
Refer to the Sybase Adaptive Server Enterprise Installation Guide for details.
Disk Space for the Policy Database
A minimum of two database devices is required, each having 250 MB.

Installing and Configuring the Sybase Adaptive Server

This section provides instructions for installing and configuring a Sybase database for use with the AquaLogic Enterprise Security Administration Server.

For guidance on installing and configuring the database, see the following topics:

Installing the Sybase Database

This section provides recommendations for installing and configuring the Sybase database software. If the Sybase database is already installed on the database host machine, you can skip this procedure and go to Creating Sybase Database Devices.

To install the Sybase Adaptive Server, perform these steps:

  1. To install a Sybase Adaptive Server database software, follow the Sybase installation instructions in the Sybase Adaptive Server Enterprise Installation Guide. When the Sybase Installer displays the Configure New Server screen, select the Configure new Adaptive Server and Configure new XP Server check boxes and proceed with the installation.
  2. When the final installer screen appears, select the Yes, restart my computer radio button and click Finish.
  3. Note: By default SYBASE names your database server based on your machine name.
  4. After the machine restarts, start the SYBASE Server (Sybase SQLServer) manually.

Creating Sybase Database Devices

The policy database requires at least two database devices, each having at least 250 MB of free space. The first device stores policy data and the other stores the transaction log. You must create these two database devices before you create and configure the policy database.

Note: For better performance, BEA recommends a raw partition as the best configuration for the database device. Obviously, you must allocate sufficient disk space to ensure that the database meets your performance requirements.

To Create Sybase Database devices on the Windows platform, perform the following steps:

  1. To start the Sybsase Central tool, click Start-->Programs-->Sybase-->Sybase Central Java Edition. The Sybase Central tool opens.
  2. Click Tools, select Connect and log in as user sa (no password is required). The Sybase Central screen appears as shown in Figure A-3.
  3. Note: The user sa does not have a password by default.
    Figure A-3 Sybase Central


    Sybase Central

  4. Expand the Sybase Database server node in the left pane (shown as WAILEE in Figure A-3, but your server is displayed instead) and click Database Devices. Add Device Database appears in the right pane (see Figure A-4).
  5. Figure A-4 Add Database Device Screen


    Add Database Device Screen

  6. Double click Add Database Devices. The Specify the Name and Path screen appears (see Figure A-5).
  7. Figure A-5 Database Device Name and Path Screen


    Database Device Name and Path Screen

  8. Specify the path (for example C:\Sybase\data\asi_data_dev.dat) and the device name (for example asi_data_dev), and click Next. The Add Database Device - Advanced Options screen appears (see Figure A-6).
  9. Figure A-6 Sybase Add Database Device - Advanced Options Screen


    Sybase Add Database Device - Advanced Options Screen

  10. Set the Device number to 2, Size to 250 MB, click the check box to on, and click Finish.
  11. To add database device asi_log_dev, repeat steps 4. to 6., but set the database device name to asi_log_dev instead of asi_data_dev, and click Finish.
Note: For instructions for creating Sybase database devices on Solaris and Linux platforms, see the Chapter "Managing Adaptive Server Databases" in the Sybase Adaptive Server Enterprise Configuration Guide for the particular platform.

Administering the Sybase Policy Database

This section covers the following database administration topics:

Using the Database Administration Utilities with Sybase

Table 0-7 lists and describes the batch and shell files provided for database administration. The files are located in the following directory:

bea\ales25-admin\bin\

where:

Before running these scripts with a Sybase database, you need to ensure the following setup steps are completed:

Backing Up a Sybase Database

BEA strongly recommends that you backup your original policy database regularly. A database backup is always recommended before you uninstall or re-install the policy database. You may need to contact your database or system administrator to assist with this process. Backups should be done on a regularly scheduled basis.

If you have an existing backup procedure in place, you may choose to run it. Otherwise, follow these steps:

  1. Login to your Sybase database server as the system administrator, database operator, or database owner.
  2. The database owner is not the same as the policy owner.

  3. Backup the transaction log by using the Sybase dump transaction command.
  4. Backup the database by using the Sybase dump database command.
Note: See your Sybase documentation for further information on using these commands.

  Back to Top       Previous  Next