> Creating WebLogic Domains Using the Configuration Wizard > How Do I...?

Creating WebLogic Domains Using the Configuration Wizard

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

How Do I...?

This section provides an example of creating a WebLogic Portal domain using an enterprise-quality database. For complete information about WebLogic Portal, see the WebLogic Portal documentation.

 

How Do I: Create a ALSB+WLI Domain

The following example explains the procedure to create a new ALINT domain. For more information about ALINT, see <<ALINT Landing Page>>

  1. Start the Configuration Wizard in graphical mode
    • On Windows, click:

      • Start > Programs > BEA Products > Tools > Configuration Wizard

  2. In the Welcome window, select Create a new WebLogic domain, and click Next.
  3. In the Select a Domain Source window:
    1. Select Generate a domain configured automatically to support the following BEA products.
    2. Select WebLogic Integration, and AquaLogic Service Bus checkboxes.
      3. Note: The WebLogic Portal checkbox is selected by default since it is a prerequisite for WebLogic Portal GroupSpace.
    3. Click Next.
  4. In the Configure Administrator Username and Password window, enter a valid username and password, and click Next. This username is used to boot the Administration Server and connect to it.
  5. In the Configure Server Start Mode and JDK window, specify the Domain startup mode, JDBC and JDK, click Next, and for more information, see Specify the Server Start Mode and JDK.
  6. In the Customize Environment and Services Settings window, select Yes to modify JDBC Data Source Configurations to specify a non-PointBase database, and click Next.
  7. In the Configure the Administration Server window, define the configuration information for the Administration server, and click Next. For more information, see Configure the Administration Server.
  8. In the Configure Managed Servers window, define the configuration information for one or more managed servers, and click Next. For more information, see Configure Managed Servers.
  9. In the Configure Machines window, define the configuration information for machine or hosts in the domain, and click Next. For more information, see Configure Machines.
  10. In the Configure JDBC Data Sources window, modify the configuration information for each data source to point to the desired Database type and driver. For a list of supported databases and drivers for WebLogic Portal, see Supported Database Configurations.

    11. Please keep the following considerations in mind:

    • Each data source for WebLogic Portal is described in WL_HOME/portal/db/jdbc/README.txt. This Readme file includes additional important information about database specific data source settings and XA JDBC Driver usage. It also describes a process for switching a default PointBase domain to a domain using an Enterprise Quality Database, without using the Configuration Wizard guide to modify each data source.
    • For the MySQL Database:

      • The MySQL JDBC driver is not fully XA compatible, therefore WebLogic Portal does not support using com.mysql.jdbc.jdbc2.optional.MysqlXADataSource. Data sources that require XA, and those that are XA capable, should use the com.myself.jdbc.Driver with the global-transactions-protocol LoggingLastResource instead.

    • For Database Types other than MySQL:

      • Always define portalDataSourceAlwaysXA with an XA driver. For example, when configuring a domain for Oracle, use BEA’s Oracle Driver (Type 4 XA).

      Always define p13nDataSource and cgDataSource-nonXA with a non-XA driver. For example, when configuring a domain for Oracle, use BEA’s Oracle Driver (Type 4) with these data sources.

      For every other data source, a tab is displayed in the Configure JDBC Data Sources panel for Database Type and Driver configuration. The remaining data sources can be defined with either an XA or non-XA Driver, as required. When each data source is configured, click Test Connections to display the Test Data Source Connections window. Test each database source to verify database connectivity. Go back to the Configure JDBC Data Sources window to check and correct any database connectivity issue before proceeding.

      Note: If you selected the WebLogic Portal GroupSpace Framework check box in step 3, and you want to use a database other than PointBase for the GroupSpace Database, appsGroupSpaceDataSource will require data source configuration. For example, to use an Oracle database with the WebLogic Portal GroupSpace Framework configure appsGroupSpaceDataSource, to use BEA’s Oracle Driver (Type 4) and specify a user name and password that is unique for WebLogic Groupspace. For more information, see the WebLogic Portal Database Administration Guide.

      Ensure that the database to which you want to test the connection is running.

      Click Next to proceed to the Run Database Scripts window.

  11. In the Run Database Scripts window, select the Log File check box, and then click Run Scripts to create both the P13N and Portal Database Objects.

    12. Also, if you selected WebLogic Portal GroupSpace Framework in Step 3, select the appsGroupSpaceDataSource in Available JDBC Data Sources, and then click Run Scripts to load the database objects for the WebLogic Portal GroupSpace Framework.

    Note: In the Results pane, verify that Database Load Successful is returned for each Run Script execution. Otherwise, correct the problem before proceeding.
  12. In the Configure JMS File Store window, enter any JMS File Store information for the domain, and click Next. For more information, see Configure JMS File Stores.
  13. In the Review WebLogic Domain window, verify the contents of the domain, and click Next. For more information, see Review the Domain Settings.
  14. In the Create WebLogic Domain window, enter a name and location for your new WebLogic Portal domain, click Create. Once the domain is created, the server for WebLogic Portal is ready to be started.

How Do I: Create a Portal Domain Using an Enterprise-Quality Database?

The following example explains the procedure to create a new WebLogic Portal domain that uses a database other than the default PointBase database. For additional information about configuring an Enterprise-Quality Database, see the WebLogic Portal Database Administration Guide.

  1. Start the Configuration Wizard in graphical mode.
    • On Windows:

      • Start > Programs > BEA Products > Tools > Configuration Wizard

    • On UNIX:

      • Go to the /common/bin subdirectory of the product installation directory. For example: cd $BEAHOME/wlserver_10.0/common/bin

      Enter sh config.sh

  2. In the Welcome window, select Create a new WebLogic domain, and click Next.
  3. In the Select a Domain Source window:
    1. Select Generate a domain configured automatically to support the following BEA products.
    2. Select the WebLogic Portal check box.
      3. Note: The WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.
    3. Optionally, select the WebLogic Portal GroupSpace Framework and WebLogic Portal GroupSpace Application check boxes to include database resources required for a GroupSpace Community and a pre-configured GroupSpace application, respectively. For more information, see the WebLogic Portal GroupSpace Guide
      4. Note: The WebLogic Portal checkbox is selected by default since it is a prerequisite for WebLogic Portal GroupSpace.
    4. Click Next.
  4. In the Configure Administrator Username and Password window, enter a valid username and password, and click Next. This username is used to boot the Administration Server and connect to it.
  5. In the Configure Server Start Mode and JDK window, specify the Domain startup mode, JDBC and JDK, click Next, and for more information, see Specify the Server Start Mode and JDK.
  6. In the Customize Environment and Services Settings window, select Yes to modify JDBC Data Source Configurations to specify a non-PointBase database, and click Next.
  7. In the Configure the Administration Server window, define the configuration information for the Administration server, and click Next. For more information, see Configure the Administration Server.
  8. In the Configure Managed Servers window, define the configuration information for one or more managed servers, and click Next. For more information, see Configure Managed Servers.
  9. In the Configure Machines window, define the configuration information for machine or hosts in the domain, and click Next. For more information, see Configure Machines.
  10. In the Configure JDBC Data Sources window, modify the configuration information for each data source to point to the desired Database type and driver. For a list of supported databases and drivers for WebLogic Portal, see Supported Database Configurations.

    11. Please keep the following considerations in mind:

    • Each data source for WebLogic Portal is described in WL_HOME/portal/db/jdbc/README.txt. This Readme file includes additional important information about database specific data source settings and XA JDBC Driver usage. It also describes a process for switching a default PointBase domain to a domain using an Enterprise Quality Database, without using the Configuration Wizard guide to modify each data source.
    • For the MySQL Database:

      • The MySQL JDBC driver is not fully XA compatible, therefore WebLogic Portal does not support using com.mysql.jdbc.jdbc2.optional.MysqlXADataSource. Data sources that require XA, and those that are XA capable, should use the com.myself.jdbc.Driver with the global-transactions-protocol LoggingLastResource instead.

    • For Database Types other than MySQL:

      • Always define portalDataSourceAlwaysXA with an XA driver. For example, when configuring a domain for Oracle, use BEA’s Oracle Driver (Type 4 XA).

      Always define p13nDataSource and cgDataSource-nonXA with a non-XA driver. For example, when configuring a domain for Oracle, use BEA’s Oracle Driver (Type 4) with these data sources.

      For every other data source, a tab is displayed in the Configure JDBC Data Sources panel for Database Type and Driver configuration. The remaining data sources can be defined with either an XA or non-XA Driver, as required. When each data source is configured, click Test Connections to display the Test Data Source Connections window. Test each database source to verify database connectivity. Go back to the Configure JDBC Data Sources window to check and correct any database connectivity issue before proceeding.

      Note: If you selected the WebLogic Portal GroupSpace Framework check box in step 3, and you want to use a database other than PointBase for the GroupSpace Database, appsGroupSpaceDataSource will require data source configuration. For example, to use an Oracle database with the WebLogic Portal GroupSpace Framework configure appsGroupSpaceDataSource, to use BEA’s Oracle Driver (Type 4) and specify a user name and password that is unique for WebLogic Groupspace. For more information, see the WebLogic Portal Database Administration Guide.

      Ensure that the database to which you want to test the connection is running.

      Click Next to proceed to the Run Database Scripts window.

  11. In the Run Database Scripts window, select the Log File check box, and then click Run Scripts to create both the P13N and Portal Database Objects.

    12. Also, if you selected WebLogic Portal GroupSpace Framework in Step 3, select the appsGroupSpaceDataSource in Available JDBC Data Sources, and then click Run Scripts to load the database objects for the WebLogic Portal GroupSpace Framework.

    Note: In the Results pane, verify that Database Load Successful is returned for each Run Script execution. Otherwise, correct the problem before proceeding.
  12. In the Configure JMS File Store window, enter any JMS File Store information for the domain, and click Next. For more information, see Configure JMS File Stores.
  13. In the Review WebLogic Domain window, verify the contents of the domain, and click Next. For more information, see Review the Domain Settings.
  14. In the Create WebLogic Domain window, enter a name and location for your new WebLogic Portal domain, click Create. Once the domain is created, the server for WebLogic Portal is ready to be started.

  Back to Top       Previous  Next