8 Working with Packages for Business Services

This chapter contains the following topics:

• Understanding Packages for Business Services

• Assembling JD Edwards EnterpriseOne Business Services

• Assembling a Package that Contains Published Business Services

• Building a Package with Published Business Services

• Deploying the Package to the Business Services Server

• Enabling the Consumption of Web Services Running on WLS from Migrated Business Services Proxies

Understanding Packages for Business Services

This section provides an overview of packages for business services.

Once business services have been created, they need to be built and deployed for consumption. The package build process builds and creates the necessary files for development client, Oracle Application Server (OAS), WebLogic Server (WLS), and Websphere Application Server (WAS) consumption. The client installation process deploys business services to all development clients. The package deployment process deploys the business services archive (.ear) files to the preconfigured J2EE containers on OAS, WLS, and WAS.

You can build the following combinations of business services packages:

• For only OAS.

• For only WLS.

• For OAS and WAS.

• For OAS and WLS by running the migration process.

• For OAS, WAS, and WLS.

Note:

To build for OAS, WAS, and WLS, you must specify the JDeveloper 10g install path in the JDeveloper Install Path field, specify the location where IBM Rational Application Developer for WebSphere (RAD) is installed in the RAD Install Path field, check the option to Migrate OAS to WebLogic, and specify the location for the JDeveloper 11g install path in the JDeveloper 11g Home field.

You may also migrate the business services that were built for OAS to WLS. The migration process:

• Converts the OAS business service WSDLs to WLS-compatible WSDLs so that the business services running on WLS can be invoked with a SOAP request similar to the one used with OAS.

• Converts the OC4J-based proxies (i.e. business service consumer projects) to WLS-compatible proxies so that the existing OC4J-based proxies (for example, JRH90I30) can run on WLS.

See Also:

• Assembling Business Services for Package Build in this document for detailed steps.

• Business Services Server Reference Guide for more information on configuration and security of the Business Services Server.

Using IBM Rational Application Developer 7.5

With JD Edwards EnterpriseOne Releases 8.11 SP1, 8.12, and 9.0, you can build business services packages for a business services server running IBM WebSphere 6.1 or IBM WebSphere 7 with IBM's Rational Application Developer (RAD) 7.5.

You can build business services packages from these machines using RAD 7.5:

• JD Edwards EnterpriseOne deployment server installed on a Microsoft Windows Server 2008 R2 64-bit operating system.

• JD Edwards EnterpriseOne development client installed on a Microsoft Windows 7 operating system.

The supported version of RAD software is RAD 7.5.5 and above. It is necessary to have RAD 7.5.5 or above installed because support for Microsoft Windows Server 2008 R2 and Microsoft Windows 7 starts with this version.

You must install the following packages via IBM Installation Manager. The order of installation of the packages is not important because this is handled by the Installation Manager:

• IBM RAD for WebSphere Software 7.5.5 (or higher).

• IBM RAD Assembly and Deployment Features 7.5.5 (or higher).

• IBM WAS Version 6.1 Test Environment 6.1.0.19 (comes with the default installation). Apply the latest supported WebSphere Fix Pack listed in the MTRs.

Disk Space Requirements

The disk space requirements for RAD 7.5 are:

• 7.3 Giga Bytes (GB) for extracting the CDs.

• 130 Mega Bytes (MB) for IBM Installation Manager during the installation and approximately 20 MB for user data and downloads.

• 10.5 GB of disk space for IBM RAD 7.5, WebSphere 6.1 Test Environment, WebSphere 7 Test Environment, and shared folders.

Special Considerations

"If you are building the business services package on the deployment server and using RAD 7.5:

• Configure H4A/OH4A to properly work on the deployment server.

• Copy jde.ini entries specific to H4A/OH4A from the client jde.ini (or modify and copy the entries below):

  [LOCALWEB] 
  # Installation flag, if it is 0, no HTML testing setup, disable all HTML testing
  AppServerInstalled=1
   
  # Name of local web server, localhost is default but may not be valid always.
  webhostname=localhost
   
  webport=8888
  webserverstart=C:\JDEdwards\E900\system\oc4j\startOC4J.bat
  webserverstop=C:\JDEdwards\E900\system\oc4j\stopOC4J.bat
  webserverstartarg=
  webserverstoparg=
  # start web server on demand, or immediately
  # valid values : ONDEMAND (web server will be started on the first HTTP request) , 
                   MANUAL (web server has to be started manually by user on port specified),
                   IMME (web server starts as soon as ActivConsole starts)
  StartAppServer=ONDEMAND
   
  # delay time between starting web server and launching browser window
  # default value is 60 (60 secs)
  WebDelay=60
  

• Edit the jdbj.ini to point the environment to JDEPLAN:

  [JDBj-BOOTSTRAP SESSION]
  user=JDE
  password=JDE
  environment=JDEPLAN
  role=*ALL
  

• Ensure that the EnterpriseOne Menu option is accessible from the Tools menu in JD Edwards Solution Explorer.

Using IBM Rational Application Developer 8.5 (Release 8.98 Update 4.11)

With JD Edwards EnterpriseOne Releases 8.98 Update 4.11, you can build business services packages for a business services server running IBM WebSphere 8.5 with IBM's Rational Application Developer (RAD) 8.5 64-bit.

You can build business services packages from these machines using RAD 8.5:

• JD Edwards EnterpriseOne deployment server installed on a Microsoft Windows Server 2008 R2 64-bit operating system.

• JD Edwards EnterpriseOne development client installed on a Microsoft Windows 7 operating system.

You must install the following packages via IBM Installation Manager:

1. IBM Rational Application Developer for WebSphere Software Version 8.5 (8.5.0.RADO85-I20120529_2348).

2. IBM WebSphere Application Server V7 (64-bit) Test Environment Version 7.0.0.23 (2.0.13.WTE70-6470023-I20120517_1723). You have to download this package separately as this is not included with the default package.

Important!:

You must first install RAD 8.5 and then install WAS v7 TE7.0.0.23 (64 bit) on top of RAD 8.5.

Disk Space Requirements

The disk space requirements for RAD 8.5 are:

• Approximately 11 GB for extracting the CDs (including the test environment).

• 150 MB for IBM Installation Manager during the installation and approximately 20 MB for user data and downloads.

• Approximately 8 GB of disk space for IBM RAD 8.5, WebSphere 7.0.0.23 Test Environment (64 bit), and shared folders.

Special Considerations

1. While installing WAS version 7.0 Test Environment 7.0.0.23 (64 Bit) on top of RAD 8.5, create the default WAS profile with the default profile name.

2. If you are building the business services package on the deployment server and using RAD 8.5:

   • Configure H4A/OH4A to properly work on the deployment server.

   • Copy jde.ini entries specific to H4A/OH4A from the client jde.ini (or modify and copy the entries below):

     [LOCALWEB] 
     # Installation flag, if it is 0, no HTML testing setup, disable all HTML testing
     AppServerInstalled=1
      
     # Name of local web server, localhost is default but may not be valid always.
     webhostname=localhost
      
     webport=8888
     webserverstart=C:\JDEdwards\E900\system\oc4j\startOC4J.bat
     webserverstop=C:\JDEdwards\E900\system\oc4j\stopOC4J.bat
     webserverstartarg=
     webserverstoparg=
     # start web server on demand, or immediately
     # valid values : ONDEMAND (web server will be started on the first HTTP request) , 
                      MANUAL (web server has to be started manually by user on port specified),
                      IMME (web server starts as soon as ActivConsole starts)
     StartAppServer=ONDEMAND
      
     # delay time between starting web server and launching browser window
     # default value is 60 (60 secs)
     WebDelay=60
     

3. Edit the jdbj.ini to point the environment to JDEPLAN:

   [JDBj-BOOTSTRAP SESSION]
   user=JDE
   password=JDE
   environment=JDEPLAN
   role=*ALL
   

4. Ensure that the EnterpriseOne Menu option is accessible from the Tools menu in JD Edwards Solution Explorer.

Assembling JD Edwards EnterpriseOne Business Services

This section lists prerequisites and discusses how to assemble business services for package build.

Prerequisites

Before you complete the tasks in this section:

• Use Server Manager to create J2EE business service container(s) for the Business Services Server.

• Use Server Manager to set up Server Manager users.

  In order to deploy the package successfully, the JD Edwards EnterpriseOne user must be a valid Server Manager user. The user cannot deploy the package if the JD Edwards EnterpriseOne user's credentials are not valid for Server Manager.

  See the JD Edwards EnterpriseOne Tools Release 8.98 Server Manager Guide.

• If you have multiple security servers, you must set up JD Edwards EnterpriseOne Trusted Nodes for a successful deployment of business services.

  See "Setting Up a Trusted Node Configuration" in the JD Edwards EnterpriseOne Tools Security Administration Guide.

• If you are building a business services package for WebLogic Server with JDeveloper 11g, JDeveloper 11.1.1.2 needs to be installed on the JD Edwards EnterpriseOne client that you are using to build the business services package.

• If you are running the Migration Utility during the business services package build, you must install both JDeveloper 10.1.3.4 and JDeveloper 11.1.1.2 on the JD Edwards EnterpriseOne client that you are using to build the business services package.

• If you are running the Migration Utility during the business services package build, ensure that you have read the Release Notes for 8.98.3.0 and installed the ESUs for the existing business services proxy objects so that the Migration Utility will run successfully.

• In the jde.ini, set the JDeveloperVersion:

  • To 10.1.3 if you are assembling a business services package for OAS or assembling a business service package with the Migration Utility.

  • To 11.1.1 if you are assembling a business services package for WLS.

Assembling Business Services for Package Build

Enter P9603 in the Fast Path.

Figure 8-1 Assemble Business Services form

Description of "Figure 8-1 Assemble Business Services form"

1. On the Assemble Business Services form, in the Pathcode field, enter the path code of the package that you plan to build and tab to the next field.

   Note:

   At this point, the application retrieves all the available business services from F98602 and F98603. If you have used this application before, the application also retrieves the values for the JDeveloper Install Path and Rational Application Developer Install Path fields from the JDE.INI file.

2. If this is your first time in the application, you must manually complete the JDeveloper Install Path and Rational Application Developer Install Path fields. Enter the following values, depending on whether you are assembling your business services to build a package for OAS, WAS, or WLS:

   1. To build for only OAS, enter the location for the JDeveloper 10g install path in the JDeveloper Install Path field.

   2. To build for WAS, enter the location where RAD is installed in the RAD Install Path field & enter the location for the JDeveloper 10g install path in the JDeveloper Install Path field.

   3. To build for only WLS, enter the location for the JDeveloper 11g install path in the JDeveloper Install Path field. The JDeveloper 11g install path should include the root folder of the JDeveloper 11g installation and not the JDeveloper folder (for example, C:\Oracle\Middleware).

3. When you enter the install path, P9603 verifies the actual location and version.

   If this path is correct, the P9603 adds the information to the jde.ini:

   [MTR VALIDATION]
   JDeveloperInstallPath=<Install path specified by P9603>
   JDeveloperVersion=10.1.3
   WebSphereInstallPath=<Install path specified by P9603>
   WebSphereVersion=6.1
   

   Note:

   If the path or version is incorrect, an error appears; the Close button is disabled until you enter the correct path.

4. If the location that you enter in the JDeveloper Install Path field points to an Oracle JDeveloper 10g release, the Migrate to WebLogic option appears.

   If you select this option, the system migrates your business services.

   The migration process:

   • Converts the OAS business service WSDLs to WLS-compatible WSDLs, so that the business services running on WLS can be invoked with a SOAP request similar to the one used with OAS.

   • Converts the OC4J-based proxies (i.e. business service consumer projects) to WLS-compatible proxies so that the existing OC4J-based proxies, like JRH90I30, can run on WLS.

5. If you want to run the migration process during the business services package build:

   1. Check the option to Migrate OAS to WebLogic.

   2. Enter the location for the JDeveloper 11g install path in the JDeveloper 11g Home field.

      The path to JDeveloper 11g should include the root folder of the JDeveloper 11g installation and not the JDeveloper folder (for example, C:\Oracle\Middleware).

      Note:

      When you build a business services package with the migration process, an OAS .ear is generated first and then the migration process converts the OAS .ear to a WLS-compatible .ear file.

6. In the grid, select the business services that you want to expose as a web service and click the Select button.

   You can also double-click the row headings of the business services that you want to expose.

   A check mark appears by each business service that is selected.

7. Click Select again or double-click the row header to unexpose the web service.

8. Click Close to close the application.

Assembling a Package that Contains Published Business Services

This section discusses how to assemble a business service package.

Assembling a Business Service Package

To set the processing options for Package Assembly, go to the Package and Deployment Tools menu, right-click the Package Assembly application (P9601), and select prompt for values.

Figure 8-2 Processing Options for Package Assembly, P9601

Description of "Figure 8-2 Processing Options for Package Assembly, P9601"

1. Set the processing option entitled Business Services to 1. This processing option is blank by default.

2. Select OK.

3. On the Work with Packages form, begin the assembly process.

   See Chapter 4, "Assembling Packages".

Building a Package with Published Business Services

This section provides an overview of the build process, prerequisites, and discusses how to:

• Define a package build with published business services.

• Resubmit the package build.

Understanding the Build Process

This section provides overviews of how the JD Edwards EnterpriseOne system builds a package that contains business services:

• For OAS and WAS.

• For WLS.

• Migration utility for WLS.

For OAS and WAS, the JD Edwards EnterpriseOne system:

1. Creates the \\work\sbf\sbfbuild.ini, which defines the paths to the exposed methods.

2. Creates the Ant scripts logtimestamp.xml and build.xml in the \\work\sbf directory.

3. Runs the build.xml Ant script to extract source.

   When the extract occurs, Unjar_BusinessService.log is generated in the \\work\sbf directory.

4. Creates service interface files.

   An interface file is created for each published business service. The selected methods are listed in the created published business service.

5. Creates the Web Service Inspection Language (WSIL) file, which is used for Business Process Execution Language (BPEL).

6. Creates Ant scripts for OAS.

   These scripts are named build.properties and build.xml. They are created within the \\work\sbf\OAS directory.

7. Creates Ant scripts for WAS.

   These scripts are created within the \\work\sbf\WAS directory.

8. Runs the OAS build.xml Ant script.

   The build.xml Ant script:

   1. Creates javadoc.

   2. Compiles java source files.

   3. Assembles the business services' source into an .ear file that is OAS-compatible.

9. Runs the WAS build.xml Ant script.

   The build.xml script creates an .ear file that is WAS-compatible.

10. Compresses the java folder for deployment of the client sbf.cab.

    Note:

    Review the oas_BusinessService.log or was_BusinessService.log to verify that the build was successful. If the build is successful, "Build Successful" appears at the bottom of the log. If the build failed, "Build Failed" appears at the bottom of the log.

For WLS, the JD Edwards EnterpriseOne System:

1. Creates the \\work\sbf\sbfbuild.ini, which defines the paths to the exposed methods.

2. Creates the Ant scripts, logtimestamp.xml and build.xml in the \\work\sbf directory.

3. Runs the build.xml Ant script to extract source. When the extract occurs, the Unjar_BusinessService.log is generated in the \\work\sbf directory.

4. Creates the Java Web Service (JWS) files. A JWS file is created for each published business service. The selected methods are listed in the created published business service.

5. Creates the WSIL file, which is used for BPEL.

6. Creates Ant scripts for WLS. These scripts are named build.properties and build.xml. They are created within the \\work\sbf\wls directory.

7. Runs the WLS build.xml Ant script.

   The build.xml Ant script:

   1. Creates javadoc.

   2. Compiles java source files.

   3. Assembles the business services' source into an .ear file that is WLS-compatible.

8. Compresses the java folder for deployment of the client sbf.cab.

Note:

Review the wls_buildservices.log in \\work\sbf\wls to verify that the build was successful. If the build is successful, "Build Successful" appears at the bottom of the log. If the build failed, "Build Failed" appears at the bottom of the log.

When running the migration utility for WLS:

1. The OAS business services .ear file is created as indicated by the existing process.

2. The business services package build process invokes the migration utility.

3. The migration utility creates the migrated WLS .ear file in the \\<Pathcode>\Package\<Package_name> folder.

Note:

Review the create_ear.out file on the business services package build machine in the \\<Pathcode>\Package\<Package_name>\MOAS location to verify that the migrated WLS .ear file was built successfully. If the build is successful, "Build Successful" appears at the bottom of the log.

Prerequisites

Before building the package, verify that logging is turned off. When the jdeproperties.log file is set for logging in the \system\classes folder and a package build is submitted, the build process is slowed down. It is not recommended to have logging turned on during package builds.

Defining a Package Build with Published Business Services

To define a package build with published business services:

1. Enter P9621 in the Fast Path or go to the Package and Deployment Tools menu and select Package Build.

2. Use the Package Build application to define build properties for the package.

3. On the Package Build Location form, select Client as the Build Location.

   Note:

   Business services are not built for server-only packages.

The JVM's virtual memory is set to a maximum of 512 MB. You can change this using the following jde.ini settings:

[PACKAGE BUILD]

JavacMaxMemorySize= 512 MB

JavadocMaxMemorySize= 512 MB

Resubmitting the Package Build

If errors occur during the package build, you will need to reset the status and resubmit the package build.

Enter P9622 in the Fast Path or go to the Package and Deployment Tools menu and select Package Build History.

Figure 8-3 Work with Package Build History form

Description of "Figure 8-3 Work with Package Build History form"

1. On the Work with Package Build History form, enter your package in the Package Name field and select Find.

2. In the tree structure, expand your package name and CLIENT.

3. Click Business Services and select your business service.

4. Select Reset Status from the Row menu to reset the status of your business services.

5. Select Resubmit Build from the Row menu.

Deploying the Package to the Business Services Server

This section provides overviews of the deployment process for OAS/WAS and WLS, and discusses how to deploy the business services.

Understanding the Deployment Process for OAS and WAS

This is an overview of how business services are deployed to the Business Services Server for OAS and WAS.

1. When you click Deploy, the R98825F runs.

   Note:

   If you are deploying the package to both the enterprise server and the business services server, you select the enterprise server and click Deploy. R98825D deploys the package to the enterprise server and then calls R98825F to deploy the package to the business services server.

2. The R98825F creates the scfjar folder.

3. The scf_manifest.xml is created in the scfjar folder.

   This xml contains information that the package deployment process uses to communicate with the Server Manager.

4. The OAS and WAS .ear files are copied to the scfjar folder.

5. The contents of the scfjar folder are combined to form the bssv_timestamp.jar file.

   Note:

   If errors occur, they are logged to the jas.log or jasdebug.log files.

6. The jar file is uploaded to Server Manager and both the file and the scfjar folder are deleted from the deployment server.

Understanding the Deployment Process for WLS

This is an overview of how business services are deployed to the business services server for WLS.

1. When you click Deploy, the R98825F runs.

   Note:

   If you are deploying the package to both the enterprise server and the business services server, you select the enterprise server and click Deploy. R98825D deploys the package to the enterprise server and then calls R98825F to deploy the package to the business services server.

2. The R98825F creates the scfjar folder.

3. The scf_manifest.xml is created in the scfjar folder.

   This xml contains information that the package deployment process uses to communicate with the Server Manager.

4. E1BSSVAuthenticator.jar is copied to the scfjar folder.

   E1BSSVAuthenticator.jar is a custom authenticator jar that is required to secure business services on Oracle WebLogic Server.

5. The WLS .ear file is copied to the scfjar folder.

6. The contents of the scfjar folder are combined to form the bssv_timestamp.jar file.

   Note:

   If errors occur, they are logged to the jas.log or jasdebug.log files.

7. The jar file is uploaded to Server Manager and both the file and the scfjar folder are deleted from the deployment server.

Prerequisites (Release 8.98 Update 4.11)

For Websphere Application server installation v8.5, the Web Server Plug-ins for IBM WebSphere Application Server V8.5 entry in the httpd.conf has to be manually entered. The file httpd.conf is found at the location "<IBM_HTTPServer_InstallFolder>\conf\". For a windows installation an entry like the following has to be made to httpd.conf:

LoadModule was_ap22_module "<Plugins_Install_Folder>\bin\32bits\mod_was_ap22_http.dll"
WebSpherePluginConfig "<Plugins_Install_Folder>/config/webserver1/plugin-cfg.xml"

Deploying the Business Services

Enter P9631 in the Fast Path or go to the Package and Deployment Tools menu and select Package Deployment.

Figure 8-4 Work with Package Deployment form

Description of "Figure 8-4 Work with Package Deployment form"

1. On the Work with Package Deployment form, click the Add button.

2. On the Package Selection form, select the business services package to deploy and click Next.

   Note:

   In order to deploy a business services package for WLS, you must select a server with a Server Type of owl_1031.

3. On the Package Deployment Targets form, select Business Services Server as the Deployment Target.

   Note:

   The check box for Business Services Server is disabled if the selected package does not contain business services.

4. On the Package Deployment Attributes form, enter the Management Server URL and click Next.

   Server Manager returns a list of eligible business services servers to which the user can deploy the business services.

   Note:

   In order to deploy the package successfully, the JD Edwards EnterpriseOne user must be a valid Server Manager user. The user cannot deploy the package if the JD Edwards EnterpriseOne user's credentials are not valid for Server Manager. The user also cannot deploy the package if there is no valid business services server defined in Server Manager.

   See the JD Edwards EnterpriseOne Tools Release 8.98 Server Manager Guide for information about setting up Server Manager users.

5. Select the appropriate servers and click Next.

6. On the Business Services Package Deployment Properties Revisions form, click End.

7. On Work with Package Deployment, open your package name and then Business Service Application Server in the tree structure.

8. Select the date/time stamp and select Deploy from the Row menu.

   Note:

   You cannot deploy to an individual business services server. Business services are deployed to all servers under the selected date/time stamp.

Enabling the Consumption of Web Services Running on WLS from Migrated Business Services Proxies

With 8.98.3.0, when you have built a business services package for WLS by running the Migration Utility, the migrated business services proxy/consumer objects can only consume web services running on OAS.

If you want the migrated business services proxy/consumer objects to also be able to consume web services running on WLS, you must perform the following steps:

1. Install the JD Edwards EnterpriseOne 8.98.3.1 Tools Release and build the business services package with the Migration Utility.

2. Configure the soft-coding record to point to a WLS-based web service.