Database Administration Guide
Using a Microsoft SQL Server Database
This section describes the steps necessary to use a Microsoft SQL Server database with WebLogic Portal 8.1, and includes information on the following subjects:
Review this entire chapter and any release notes before proceeding. The steps in this chapter should be performed by a database administrator.
Understanding Database Configuration for WebLogic Platform
Typically, you use the WebLogic Configuration Wizard to configure and connect to the database that you will use to support WebLogic Platform. For more information about how to use the WebLogic Configuration Wizard, see http://download.oracle.com/docs/cd/E13196_01/platform/docs81/confgwiz/index.html.
When using the Configuration Wizard to configure databases for use with WebLogic Platform, use the following steps.
- Create your vendor database(s). If you want to use behavior event tracking in a production environment, consider using a separate database for behavior event tracking.
Note: If you are creating a separate database for behavior event tracking, see Creating a Database for Behavior Tracking Events on page 2-8.
- Prepare the database for use with WebLogic Platform. BEA provides several sample initialization scripts that need to be modified and run on the vendor database before using the database with WebLogic Platform.
- After the database is configured, use the Configuration Wizard to create and load appropriate database objects and set JDBC driver settings at domain creation time.
Manually Configuring Databases
In some cases, you may need to manual configure your database(s) without the use of the Configuration Wizard.
Manual configuration should be used in the following cases:
- If your desired database was not configured via the WebLogic Configuration Wizard.
- If after running the Configuration Wizard you decide to have your domain point to a different database.
- If you would like to refresh your database with the base configuration data that comes with the product.
Note: BEA's database creation scripts first drop all database objects and then recreate them, which means all data added since your original installation will be lost. Upon completion of the database creation scripts, only the base configuration data that is needed for the product will exist.
- When you want to create only a subset of Portal database objects, for example to create only Behavior Tracking database objects for a particular database.
Use the following steps when you need to manually configure a database.
- Create your vendor database(s), see page 2-3. If you want to use behavior event tracking in a production environment, consider using a separate database for behavior event tracking.
- Prepare the database for use with WebLogic Platform, see page 2-3. BEA provides several sample initialization scripts that need to be modified and run on the vendor database before using the database with WebLogic Platform.
- Create database objects, see page 2-5. This creates proprietary database objects that are used by WebLogic. This is done by editing the database properties file provided by BEA.
- Configure the JDBC settings for your database using WebLogic Console Server,see page 2-6.
Configuring a Microsoft SQL Server Database
Before following the steps outlined in this chapter, you need to have already defined your SQL Server instance and the databases you need.
Be sure that you are using a supported version, see http://download.oracle.com/docs/cd/E13196_01/platform/docs81/support/supp_plat.html#1085671.
To configure a SQL Server database, do the following:
- Install the SQL Server client on the WebLogic Platform host and do the following:
- Configure it for access to your SQL Server database.
- Ensure that you can connect to your SQL Server database via the OSQL utility.
See your SQL Server documentation for details.
Note: If you plan to use the Configuration Wizard to create the database objects for a new domain, you will not need to install the SQL Server Client.
- Verify that security authentication settings for the SQL Server are set to "SQL Server and Windows."
- From Enterprise Manager, right-click on the desired SQL Server.
- Select Properties, then select the Security tab.
- Under authentication, ensure that SQL Server and Windows is selected.
- Prepare the SQL Server Database. The database creation scripts will install domain-specific tables. It is recommended that you work with a SQL Server system or database administrator to adjust the
SAMPLE
scripts and create database devices, databases, and database users for your SQL Server environment.
Notes: Multiple databases are required if you have multiple domains, or to run multiple environments using the same SQL Server instance (for example, if you want to run development and system test from a single SQL Server installation).
Be sure to back up your database(s) before installing any new database objects. See your database documentation for details.
- Review and modify the provided sample scripts to suit your environment. These scripts are available in:
<WL_HOME>\portal\db\sql_server\2000\admin
. The sample scripts use the following defaults:
The following table lists the script names and the usage notes for each script.
Script Name
|
Description
|
create_database.sql
|
Create the WEBLOGIC database and WEBLOGIC database owner user login. An alias is created to make WEBLOGIC dbo in the database. Make the WebLogic database the default database for the WebLogic user.
Usage Notes: You need to change database names, database owner user and password.
The default names are the following:
You also need to edit the script to reflect valid disk locations for DATA and the LOG devices, or to adjust file sizes. DATA and LOG files should be placed on separate physical disks and away from any system database files.
|
statistics.sql
|
Runs sp_updatestats to compute database statistics needed for the database optimizer. Analyze schema should be run whenever any significant changes in database data occur. Your database administrator will typically schedule sp_updatestats to run periodically in your environment.
|
install_report.sq
|
Builds an informational installation report about the database objects created in the WEBLOGIC schema.
|
bt_create_database.sql
|
Create the WEBLOGIC_EVENT database and WEBLOGIC_EVENT database owner user login. An alias is created to make WEBLOGIC_EVENT dbo in the database.
Usage Notes: You need to change database names, database owner user and password.
The default names are the following:
You also need to edit the script to reflect valid disk locations for DATA and the LOG devices, or to adjust file sizes. DATA and LOG files should be placed on separate physical disks and away from any system database files.
|
- Run
create_database.sql
via OSQL
as a user with System Administrator privileges (i.e. the sa user). For example:
osql -Usa -SSQLSERVER -e -icreate_database.sql -ocreate_database.log
The output from running create_database.sql
is written to create_database.log
. Verify that there are no errors in the log file before proceeding.
Creating Database Objects
The scripts to create Microsoft SQL Server database objects were designed to run in a Windows environment (they use the OSQL utility to create Microsoft SQL Server database objects). If you are using UNIX version of WebLogic Server with a Microsoft SQL Server database and do not have WebLogic products also installed on Windows contact BEA support for assistance.
To create WebLogic Platform database objects, use the following steps:
- Verify that you can connect to the target database server with a valid user ID and password. For example:
osql
-SSQLSERVER -U<userid> -P<password>
- Open your domain's
db_settings.properties
file for edit and comment out the database settings for PointBase.
- Uncomment the database settings for your new target database and update the following settings for your database:
server=
dblogin=
password=
- Initialize the database with the new settings.
- For Windows, navigate to the
<BEA_HOME>\user_projects\domains\portalDomain
directory and double-click on the create_db.cmd
file.
- Verify the results in the
db.log
file.
Note: If you are using the sample domain, run the create_db.cmd file from the following directory: <BEA_HOME>\weblogic81\samples\domains\portal
.
Configuring Your Domain's JDBC Driver Settings
Note: These settings do not allow support for XA functionality. For instructions on enabling XA, consult About XA.
- Start the WebLogic Server for your domain.
- Login to the WebLogic Server Console.
- Configure your new connection pools.
- Go to Services -> JDBC -> Connection Pools.
- Click Configure a new Connection Pool.
- Select the appropriate Database Type and Non-XA Database Driver from the drop down list boxes and click Continue.
- Choose a name for the new Connection Pool (For example: cgPoolN) and fill in the blanks for your vendor database. Click Continue.
- Test your connection to verify that you can successfully connect to your database.
- Create and deploy your new Connection Pool.
- Update your data sources.
- From Services -> JDBC -> Data Sources, click on each data source and switch each to the newly created connection pool. Be sure to apply each change.
- Verify that each Data Source is changed by clicking on Data Sources and then verifying that Pool Name has been set to the new Connection Pool for each.
- From Services -> JMS -> Stores -> cgJMSStore, switch cgJMSStore to use the new Connection Pool.
- Stop your domain's WebLogic Server, then restart it.
- In the WebLogic Server Console, delete the original cgPool connection pool.
- Go to Services -> JDBC -> Connection Pools.
- Right-click on the cgPool connection pool and select Delete.
Creating a Database for Behavior Tracking Events
You may want to store behavior tracking events in a different location than other WebLogic Portal database objects for increased performance. For more information about behavior tracking, see http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/adminportal/help/SA_BehavTrackServ.html.
Note: By default, behavior tracking database objects are created in the same database as other WebLogic Portal database objects. You only need to follow these steps if you are configuring a separate database for behavior tracking events.
- Run
bt_create_database.sql
via OSQL
as a user with system administrator privileges (i.e. the sa user). For example:
osql -Usa -SSQLSERVER -e -ibt_create_database.sql -obt_create_database.log
The output from running bt_create_database.sql
is written to bt_create_database.log
. Verify that there are no errors in the log file before proceeding.
- Open your domain's
db_settings.properties
file for edit.
- Within the db_settings.properties file, uncomment the database settings for your new target database and update the following settings for your database:
server=<SERVER_NAME>
dblogin=WEBLOGIC_EVENT
password=WEBLOGIC_EVENT
- Within the
db_settings.properties
file, find the p13n_modules
, portal_modules
and netuix_modules
lines at the top of the file.
- Copy these 3 lines and comment out the original settings by adding a # sign.
- Replace the original settings as follows:
- Replace
p13n_modules=p13n au bt ds
with p13n_modules=bt
.
- Replace
portal_modules=cm wlcs wps collaboration sample_cm
with portal_modules=
- Replace
netuix_modules=pf
with netuix_modules=
.
When you are finished, the section should look like this:
#p13n_modules=p13n au bt ds
#portal_modules=cm wlcs wps collaboration sample_cm
#netuix_modules=pf
p13n_modules=bt
portal_modules=
netuix_modules=
- Save the changes to the
db_settings.properties
file.
- Initialize the database with the new settings.
- Navigate to the
<BEA_HOME>\user_projects\domains\portalDomain
directory, and double-click on the create_db.cmd
file.
- Verify the results in the
db.log
file.
Note: If you are using the sample domain, run the create_db.cmd file from the following directory: <BEA_HOME>\weblogic81\samples\domains\portal
.