Skip Headers

Oracle Pedigree and Serialization Manager Installation Guide
Release 1.2
Part Number E36380-01		Go to Table of Contents
Contents 		Go to previous page
Previous 		Go to next page
Next

Setting Up WebLogic Components for Serial Destinations

Some components are only needed if you are using serial destinations functionality. Not all components will be needed. The set up of each component is based on the functionality being used. It does not hurt to set them all up, even if all of them are not going to be used.

This appendix covers the following topics:

Creating a JDeveloper Project

To support user-configurable setup of serial destinations, composites were created within Oracle SOA Suite to manage the business process flow of transmitting serials. Since these serial destinations are truly user-defined (for example, sending serials to a third-party FTP server, and so on), the SOA composites need to be modified to configure these destinations. To modify the SOA composites for transmitting serials, Oracle JDeveloper must be installed and the appropriate SOA projects extracted.

To Install Oracle JDeveloper:

  1. If you do not already have Oracle JDeveloper installed, you can download a free copy at: http://www.oracle.com/technetwork/developer-tools/jdev/overview/index.html.

  2. Use the Installation Guide for JDeveloper that is available through the above link to install Oracle JDeveloper.

  3. Once the install has completed, run Oracle JDeveloper.

  4. Use the Check for Updates wizard that is available under the Help menu to find and install the Oracle SOA Composite Editor extension. This extension is required to create and modify SOA composite applications.

To Unzip JARs:

  1. Within the "pas.zip" file that is included as part of the Oracle Pedigree and Serialization Manager download, there is a file called PasSerializationManagerSoa.zip. Unzip this file and extract the following files to the same machine that includes the Oracle JDeveloper installation:

    1. sca_PasTransmitSerialsViaFileComposite_rev1.0.jar

    2. sca_PasTransmitSerialsViaWebComposite_rev1.0.jar

To Create an Application in JDeveloper:

  1. Open Oracle JDeveloper.

  2. Create a new SOA Application and name it: PasSerializationManagerSoa.

  3. Create a new SOA project and name it: PasTransmitSerialsViaFileComposite.

  4. Select Empty Composite.

  5. Click on the new project.

  6. Select File > Import.

  7. Select SOA Archive into SOA Project.

  8. Click Browse and select sca_PasTransmitSerialsViaFileComposite_rev1.0.jar that was unzipped.

  9. Click Finish.

  10. Repeat steps 3 - 9 for the PasTransmitSerialsViaWebComposite.

To Create an Application Server in JDeveloper

To deploy from JDeveloper, an application server must be created. It records information about the standalone WebLogic server so the SOA composite can be deployed to it.

  1. Open the Application Server Navigator.

  2. Create a new Application Server:

    1. Standalone Server.

    2. Connection Name.

    3. Username and password.

    4. WebLogic Host Name, Port, and Domain.

    5. Test the connection. Make sure all tests are successful.

    6. Finish the creation of the application server.

Creating a JMS Queue

If the method of communication for a serial destination is to be used with a JMS Queue, then a JMS Queue must be created.

To Create a Database User for the JMS Persistent Store:

  1. A new database user/schema should be created to support the persistence of JMS messages in the database. Create a new database user using the following SQL commands:

    -- USER SQL
CREATE USER <databaseuser> IDENTIFIED BY <databasepassword>
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP;
    -- ROLES
GRANT "RESOURCE,CONNECT" TO <databaseuser>; 
    -- SYSTEM PRIVILEGES
GRANT UNLIMITED TABLESPACE TO <databaseuser>;

    Important: Replace <databaseuser> and <databasepassword> with your own values.

To Create a JMS Persistent Store Data Source:

  1. Log onto the Oracle WebLogic Server Administration Console.

  2. Navigate to Services > Data Sources

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button and then click the Generic Data Source.

  4. Enter the following:

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Select the appropriate database driver, and then click the Next button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  6. Click the Next button on the Transaction Options page.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  7. Enter your database connection details, and then click the Next button.

    The Database User Name and Credentials were previously created using the "To Create a Database User for the JMS Persistent Store" procedure.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  8. Click the Test Configuration button to verify the connection is successful. Once verified, click the Next button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  9. Select soa_server1 as the Target.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  10. Click the Finish button.

To Create a Persistent Store:

  1. Log onto the Oracle WebLogic Server Administration Console.

  2. Navigate to Services > Persistent Stores

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button and then click the Create JDBCStore.

  4. Enter the following:

    The Data Source value was previously created using the "To Create a JMS Persistent Store Data Source" procedure.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Click the OK button.

To Create a JMS Server:

  1. Log onto the Oracle WebLogic Server Administration Console.

  2. Navigate to Services > Messaging > JMS Servers

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button.

  4. Enter the following:

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Click the Next button.

  6. Select soa_server1 as the Target.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  7. Click the Finish button.

To Create a JMS Module:

  1. Log onto the Oracle WebLogic Server Administration Console.

  2. Navigate to Services > Messaging > JMS Modules

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button.

  4. Enter %BusinessObjectName%JMSModule as the Name of the JMS Module.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Click the Next button.

  6. Select soa_server1 as the Target.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  7. Click the Next button.

  8. Click the Finish button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  9. Select the JMS Module just created by clicking on its name.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  10. Click the New button.

  11. Select Connection Factory.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  12. Click the Next button.

  13. Enter the following:

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  14. Click the Next button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  15. Click the Finish button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  16. Click the New button.

  17. Select Queue.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  18. Click the Next button.

  19. Enter the following:

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  20. Click the Next button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  21. Click the Create a New Subdeployment button.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  22. Click the OK button.

  23. Select the JMS Server previously created using the "To Create a JMS Server" procedure.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  24. Click the Finish button.

To Create an Outbound Connection Pool in the JMSAdaptor:

  1. Log onto the Oracle WebLogic Server Administration Console.

  2. Navigate to Deployments > JMSAdaptor > Configuration > Outbound Connection Pools

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button.

  4. Select oracle.tip.adapter.jms.IJmsConnectionFactory as the Outbound Connection Group.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Click the Next button.

  6. Enter a value for the JNDI Name.

    For example, eis/wls/%BusinessObjectName%)

    Important: This name must be the same as the JNDI name used for the JMS destination in the JMS Queue adapter of the PasTransmitSerialsViaWeb composite.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  7. Click the Finish button.

  8. Navigate back to Deployments > JMSAdapter > Configuration > Outbound Connection Pools

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  9. Click the JNDI Name that was created previously.

    For example, eis/wls/%BusinessObjectName%)

  10. In the ConnectionFactoryLocation property value field, enter the JNDI name of the connection factory that was used when creating the connection factory resource in the JMS Module, and then press Enter.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  11. Click the Save button.

    Important: Remember to update the JMSAdapter’s deployment using the updated deployment plan for the above changes to take effect.

Creating a JMS Destination

Now that you have a JMS Queue, you have to define a destination and set that destination up in SOA. You will need a development environment with Oracle JDeveloper to complete this task.

To Create a Destination in Oracle Pedigree and Serialization Manager:

  1. Navigate to the Maintain Serial Destinations page and create a new destination. Make sure to select a communication method of Web Service.

  2. Add a serial destination rule for the new destination.

For more information on creating serial destinations and destination rules, see Maintaining Serial Destinations and Destination Rules, Oracle Pedigree and Serialization Manager Process Guide.

To Set Up a New JMS Destination in SOA:

  1. Navigate to your development environment and start up Oracle JDeveloper.

  2. Open the SOA application that you created in the above procedure "To Create an Application in JDeveloper".

  3. Navigate to the project PasTransmitSerialViaWebComposite and open the Composite.xml.

    PasTransmitSerialsViaWeb\Composite.xml

    the picture is described in the document text

    Notice that there is already a JMS Adapter called ExampleWSQueue.

  4. Add another JMS Adapter (similar to the ExampleWSQueue) and have it point to the JMS Queue that you created earlier. Make sure to create a wire from the TransmitSerialsViaWeb BPEL to your new JMS Adapter:

  5. Open the TransmitSerialViaWeb.bpel and scroll to the bottom. You should see something like this:

    PasTransmitSerialsViaWeb\PasTransmitSerialsViaWeb.bpel

    the picture is described in the document text

  6. Add a case to the switch conditioning it on the name of the new destination you created earlier (use the case named ExampleJMSQueue as an example).

  7. Add an Invoke in your new case connecting it to your new JMS Adapter

  8. Add an Assign to load the payload

  9. Add another Assign under your new invoke to assign no exception (use one of the existing AssignNoException to copy from).

  10. If not already done, create a Configuration Plan for the composite using the machine address and port that the database server is on. You can use as an example the existing configuration plan PasTransmitSerialsViaWebComposite_cfgplan.xml, and see how it is replacing "http://my-prod-server" and "8889".

  11. Deploy PasTransmitSerialViaWebComposite using the configuration plan created in the previous step and you are ready to use your new destination.

Configuring a Web Service Adapter

If you want to send serials to a web service, you have to configure a web service adapter in SOA. You will need a development environment with Oracle JDeveloper to complete this task.

To Configure a Web Service Adapter:

  1. Navigate to your development environment and start up Oracle JDeveloper.

  2. Open the SOA application that you created in the above procedure "To Create an Application in JDeveloper".

  3. Navigate to the project PasTransmitSerialViaWebComposite and open the Composite.xml.

    PasTransmitSerialsViaWeb\Composite.xml

    the picture is described in the document text

    Notice that there is already a Web Service Adapter called ExampleWebService. Use it as an example.

  4. Import the WSDL and schema for the web service you are adding. The directory where the schemas are kept is PasTransmitSerialViaWebComposite/XSD.

  5. Add another Web Service Adapter (similar to ExampleWebService) using your newly added WSDL. Make sure to create a wire from the TransmitSerialsViaWeb BPEL to your new Web Service Adapter:

  6. Open the TransmitSerialViaWeb.bpel and scroll to the bottom. You should see something like this:

    PasTransmitSerialsViaWeb\PasTransmitSerialsViaWeb.bpel

    the picture is described in the document text

  7. Add a case to the switch conditioning it on the name of the new destination you created earlier (use the case named ExampleWebService as an example).

  8. Add an Invoke in your new case connecting it to your new JMS Adapter.

  9. Add an Assign to load the payload.

  10. Add another Assign under your new invoke to assign no exception (use one of the existing AssignNoException to copy from).

  11. If not already done, create a Configuration Plan for the composite using the machine address and port that the database server is on. You can use as an example the existing configuration plan PasTransmitSerialsViaWebComposite_cfgplan.xml, and see how it is replacing "http://my-prod-server" and "8889".

  12. Deploy PasTransmitSerialViaWebComposite using the configuration plan created in the previous step and you are ready to use your new destination.

Creating a Web Service Destination

If you want to send serials to a web service, you have to define a destination.

To Create a Destination in Oracle Pedigree and Serialization Manager:

  1. Navigate to the Maintain Serial Destinations page and create a new destination. Make sure to select a communication method of Web Service.

  2. Add a serial destination rule for the new destination.

For more information on creating serial destinations and destination rules, see Maintaining Serial Destinations and Destination Rules, Oracle Pedigree and Serialization Manager Process Guide.

Configuring a FTP Adapter

If the method of communication for the serial destination is File Exchange, then a connection factory must be created for the FTP Adapter.

To Create a Connection Factory:

  1. Log onto the Oracle WebLogic Administration Console.

  2. Navigate to Deployments > FTPAdapter > Configuration > Outbound Connection Pools

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  3. Click the New button.

  4. Select javax.resource.cci.ConnectionFactory as the Outbound Connection Group.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  5. Click the Next button.

  6. Enter eis/Ftp/FileExchange as the JNDI Name.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  7. Save the deployment plan.

  8. Click the Finish button.

  9. Navigate back to Deployments > FTPAdapter > Configuration > Outbound Connection Pools

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  10. Click eis/Ftp/FileExchange instance that was created previously.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  11. Click the Next link until the host property can be viewed.

  12. Enter the machine name of the FTP Server as the Property Value field for the host and press Enter.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  13. Click the Next link until the password property can be viewed.

  14. Enter the password for the FTP Server in the Property Value field for the password and press Enter.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  15. Click the Next link until user name property can be viewed.

  16. Enter the user name for the FTP Server in the Property Value field for the user name and press Enter.

    Oracle WebLogic Server Administration Console

    the picture is described in the document text

  17. Click the Save button.

    Important: Remember to update the FTP Adapter’s deployment using the updated deployment plan for the above changes to take effect. You may need to bounce the WebLogic server for this change to take effect.

Creating a File Exchange Destination

Now that you have an FTP Adapter configured in WebLogic, you have to define a destination and set that destination up in SOA. You will need a development environment with Oracle JDeveloper to complete this task.

To Create a Destination in Oracle Pedigree and Serialization Manager:

  1. Navigate to the Maintain Serial Destinations page and create a new destination. Make sure to select a communication method of File Exchange.

  2. Add a serial destination rule for the new destination.

For more information on creating serial destinations and destination rules, see Maintaining Serial Destinations and Destination Rules, Oracle Pedigree and Serialization Manager Process Guide.

To Set Up a New File Exchange in SOA:

  1. Navigate to your development environment and start up Oracle JDeveloper.

  2. Open the SOA application that you created in the above procedure "To Create an Application in JDeveloper".

  3. Navigate to the project PasTransmitSerialViaFileComposite and open the Composite.xml.

    PasTransmitSerialsViaFile\Composite.xml

    the picture is described in the document text

    Notice that there is already a FTP Adapter called FileExchange. Use it as an example.

  4. Add another FTP Adapter (similar to FileExchange) pointing to the FTP Adapter you created earlier. Take care in setting the physical directory. Make sure to create a wire from the TransmitSerialsViaFile BPEL to your new FTP Adapter.

  5. Open the TransmitSerialViaFile.bpel and scroll to the bottom. You should see something like this:

    PasTransmitSerialsViaFile\ PasTransmitSerialsViaFile.bpel

    the picture is described in the document text

  6. Add a case to the switch conditioning it on the name of the new destination you created earlier (use the case named ExampleFTPServer as an example).

  7. Add an Invoke in your new case connecting it to your new FTP Adapter.

  8. Add an Assign to load the payload.

  9. Add another Assign under your new invoke to assign no exception (use one of the existing AssignNoException to copy from).

  10. If not already done, create a Configuration Plan for the composite using the machine address and port that the database server is on. You can use as an example the existing configuration plan PasTransmitSerialsViaWebComposite_cfgplan.xml, and see how it is replacing "http://my-prod-server" and "8889".

  11. Deploy PasTransmitSerialViaFileComposite using the configuration plan created in the previous step and you are ready to use your new destination.

Contents   |   Previous   |   Top of Page   |   Next

Oracle Logo
Copyright © 2013, Oracle and/or its affiliates. All rights reserved.