Getting Started

 

The WebLogic Collaborate samples demonstrate implementations of WebLogic Collaborate features. In addition, successful installation and setup of the Hello Partner sample provides verification for installation and basic configuration.

This section includes the following topics:

• Samples Overview

• Installing the Samples

 

---

Samples Overview

The WebLogic Collaborate samples have the following attributes in common:

• They demonstrate step-by-step deployment.

• They are run by workflows that are triggered by XML events.

• They can be customized and redeployed.

With the exception of the Hello Partner sample, which verifies basic communication protocols, the samples demonstrate WebLogic Collaborate solutions to plausible business problems. The following samples are described in this guide:

• Hello Partner Sample—Demonstrates the basic handshake necessary for communication. The Hello Partner sample uses the WebLogic Collaborate default XOCP messaging protocol.

• Trading Partner Lightweight Client Sample—Illustrates a request-reply scenario in which two trading partners without a WebLogic Collaborate installation use the WebLogic Collaborate mailbox interface. Two types of lightweight client communication are simulated for this demonstration:

  • Browser-based client—Uses XML and JMS to prepare, deliver, and collect information

  • File-sharing client—Uses a third-party file-sharing server to exchange messages

• Messaging API Sample—Uses the XOCP protocol. Three trading partners are collocated on the same server with the hub. Uses a logic plug-in to simulate delaying message delivery.

Use the WebLogic Collaborate Administration Console to export the sample workflow templates, and then use the WebLogic Process Integrator Studio to change the templates as appropriate. For details, see Administering BEA WebLogic Collaborate and Using the BEA WebLogic Process Integrator Studio, respectively.

 

---

Installing the Samples

Before you can run some samples, you must make unique configuration changes or populate a database. For specific installation and configuration instructions, see the documentation for the appropriate sample. Instructions are provided for both Windows and UNIX systems:

• To install the samples on a Windows system, use the Windows Start menu.

• To install the samples on a UNIX system, enter the appropriate command at the prompt.

Note: The samples installation is configured with a single WebLogic Collaborate instance. However, in an actual peer-to-peer type of installation, each trading partner (with the exception of the lightweight clients) has a WebLogic Collaborate installation, configured for the appropriate delivery channels.

This section describes two types of installations:

• Installing Using the Default Database

• Installing Using Other Supported Databases

Installing Using the Default Database

1. Install and configure WebLogic Process Integrator.

   For instructions, see Installing and Configuring BEA WebLogic Process Integrator.

2. Install and configure WebLogic Collaborate.

   The samples, including all associated files, schemas, and scripts, are loaded when you install WebLogic Collaborate. For full installation and configuration instructions, see Installing BEA WebLogic Collaborate.

3. Bulkload the sample data file into the repository, using the procedure appropriate for your platform.

   • Windows: From the Start menu, choose Start—>Programs—>BEAWebLogic EBusiness Platform—>WebLogic Integration 2.0/Samples—>Bulkload—>sample_name

   • UNIX: For the Hello Partner and Lightweight Client samples:

     cd $WLC_HOME/config/samples/shortcuts/
     sh BulkloadHelloPartner.sh

     For the Messaging API sample:

     cd $WLC_HOME/config/samples/shortcuts/
     sh BulkloadMessagingAPI.sh

     The data, schemas, and logic plug-ins required to run the samples are loaded. Wait for the bulkloading process to complete.

     Note: See also "Working With the Bulk Loader" and "Working with the Repository" in Administering BEA WebLogic Collaborate.

4. Start WebLogic Collaborate, using the procedure appropriate for your platform:

   • Windows: From the Start menu, choose
     WebLogic Integration 2.0—>Collaborate—>Samples—>Start Collaborate

   • UNIX: Run the shell script as follows:

     cd $WLC_HOME/config/samples/
     sh startWeblogic.sh

     When WebLogic Collaborate is started,WebLogic Process Integrator is started, too.

     For the Messaging API sample, skip to Step 7.

5. Start the WebLogic Process Integrator Studio, using the procedure appropriate for your platform:

   • Windows: From the Start menu, choose
     WebLogic Integration 2.0—>Collaborate—>Samples—>Start Studio

   • UNIX: Run the shell script as follows:

     cd $WLC_HOME/config/samples/shortcuts
     sh studio.sh

     To log in, use the following information:

   • Login: joe

   • Password: password

   • URL: t3//localhost:7001

     Make sure that ORG1 is selected in the Studio organization list.

6. Using the WebLogic Process Integrator Studio, import the JAR files that contain the workflows and business operations used by the samples.

   Windows:

   • From the Studio menu, choose Tools—>Import Package.

   • Browse to the WLC_HOME/config/samples/workflows directory.

   • Select HelloPartnerAndLightWeightClient.jar from the directory appropriate for your operating system.

     Windows: %WLC_HOME%\config\samples\workflows

     UNIX: $WLC_HOME/config/samples/workflows

   • Select ORG1 as the Target Organization.

   • Check for active workflows after importing.

   • Import HelloPartnerAndLightWeightClient.jar.

7. Run a sample by completing the appropriate procedure.

Installing Using Other Supported Databases

The WebLogic Collaborate samples are configured to use Cloudscape as the default database. In addition to Cloudscape, WebLogic Collaborate supports the Oracle and Microsoft SQL databases. For more information about the databases supported by WebLogic Collaborate, see Administering BEA WebLogic Collaborate.

If you prefer to use a database other than Cloudscape when running the samples, you must execute the following steps:

1. Specify an alternate database during product installation. See Installing BEA WebLogic Collaborate.

2. Switch the sample database configuration, specifying one of the following as the value of db_name: Cloudscape, Oracle, or MSSQL7.

   Windows: From the Start menu, choose WebLogic Integration 2.0—>Collaborate—>Samples—>Switch DB Config—>Change Database, DBname—>Use db_name

   UNIX: Run the following shell script:

   cd $WLC_HOME/config/samples/shortcuts
   sh SwitchDBTodb_name.sh.

3. Create the schemas for the database you are using.

   • Oracle on Windows:

   1. Run the following script:

      cd %WLPI_HOME%\ddl
      sqlplus ORACLE_USER/ORACLE_PASSWORD@ORACLE_SERVICENAME@wlpi_oracle.ddl

   2. Create the common repository by running the following script:

      cd %WLINT_HOME\repository\oracle
      createDD oracle

   3. Create the WebLogic Collaborate repository by running the following script:

      cd %WLC_HOME%\bin
      createDB oracle
      
      
      

   • SQL Server on Windows:

   1. Run the following script:

      cd %WLPI_HOME%\ddl
      osql -e -n -S MSSQL_HOSTNAME -U MSSQL_USER -P MSSQL_PASSWORD -i wlpi_mssql.ddl

   2. Create the common repository:

      cd %WLINT_HOME%\repository\mssql
      createDB mssql

   3. Create the WebLogic Collaborate repository by running the following script:

      cd %WLC_HOME%\bin
      createDB mssql

   • Oracle on UNIX:

   1. Run the following script:

      cd $WLPI_HOME/ddl
      sqlplus ORACLE_USER/ORACLE_PASSWORD@ORACLE_SERVICENAME@wlpi_oracle.ddl

   2. Run the next script:

      cd $WLINT_HOME/repository/oracle
      sh createDB.sh oracle

   3. Run the final script:

      cd $WLC_HOME/bin:
      sh createDB.sh oracle

   • SQL Server on UNIX: SQL Server runs only on Windows systems. In order to run SQL Server on a UNIX system, you must create the database and schemas on a machine running the Windows operating system, and accessed remotely.

     To change to SQL Server on a UNIX system, manually edit the SQL database-specific information in the following files, and bulkload the repository before switching databases.

     $WLC_HOME/config/samples/config.MSSQL7
     $WLC_HOME/config/samples/samplesDBManagement/bulkloading/mssql7/HelloPartnerBulkloadWrapper.xml
     $WLC_HOME/config/samples/samplesDBManagement/bulkloading/mssql7/MessagingAPIBulkloadWrapper.xml
     $WLC_HOME/config/samples/samplesDBManagement/mssql7/setDBVars.sh

     For more information about creating the database schemas required, see "Step 7: Creating the WebLogic Collaborate Tables" in Installing BEA WebLogic Collaborate in Installing BEA WebLogic Collaborate.

Note: To recreate the Cloudscape database, you must perform the following steps appropriate for your operating system.

Windows: Navigate to the appropriate directories and execute the following commands:

cd %WLINT_HOME%\repository\cloudscape
rmdir db
cd %WLPI_HOME%\bin
createCloudscape.cmd
cd %WLC_HOME%\bin
createDB cloudscape

UNIX: Navigate to the appropriate directories and execute the following scripts:

cd $WLINT_HOME/repository/cloudscape
rm -rf db
cd $WLPI_HOME/bin
sh createCloudscape.sh
cd $WLC_HOME/bin
sh createDBsh cloudscape

1. Bulkload the sample data file into the repository, using the procedure appropriate for your platform.

   • Windows: From the Start menu, choose Start—>Program—>Samples—>Bulkload—>sample_name

   • UNIX: For the Hello Partner and Lightweight Client samples:

     cd $WLC_HOME/config/samples/shortcuts/
     sh BulkloadHelloPartner.sh

     For the Messaging API sample:

     cd $WLC_HOME/config/samples/shortcuts/
     sh BulkloadMessagingAPI.sh

     The data, schemas, and logic plug-ins required to run the samples are loaded. Wait for the bulkloading process to complete.

     Note: See also "Working With the Bulk Loader" and "Working with the Repository" in Administering BEA WebLogic Collaborate.

2. Start WebLogic Collaborate, using the procedure appropriate for your platform:

   • Windows: From the Start menu, choose
     WebLogic Integration 2.0—>Collaborate—>Samples—>Start Collaborate

   • UNIX: Run the script as follows:

     cd $WLC_HOME/config/samples/
     sh startWeblogic.sh

     When WebLogic Collaborate is started, WebLogic Process Integrator is started, too.

     For the Messaging API sample, skip to Step 7.

3. Start the WebLogic Process Integrator Studio, using the procedure appropriate for your platform:

   • Windows: From the Start menu, choose
     WebLogic Integration 2.0—>Collaborate—>Samples—>Start WLPI Studio

   • UNIX: Run the following script:

     cd $WLC_HOME/config/samples/shortcuts/
     sh studio.sh

     The default username and password are joe (lowercase) and password (lowercase), respectively.

     Make sure that ORG1 is selected in the Studio organization list.

4. When using the WebLogic Process Integrator Studio, import the JAR files that contain the workflows used by the samples.

   Windows:

   • From the Studio menu, choose Tools—>Import Package.

   • Select ORG1 as the Target Organization.

   • Check for active workflows after importing.

   • Import HelloPartnerAndLightWeightClient.jar from the directory appropriate for your operating system.

     Windows: %WLC_HOME%\config\samples\workflows

     UNIX: $WLC_HOME/config/samples/workflows

5. Run a sample by completing the appropriate procedure.