service enablement installation and configuration - oracle

58
JD Edwards World Service Enablement Installation and Configuration Guide Version A9.1 Revised – January 31, 2008

Upload: others

Post on 09-Feb-2022

13 views

Category:

Documents


0 download

TRANSCRIPT

Service Enablement Installation and ConfigurationJD Edwards World Service Enablement Installation and Configuration Guide Version A9.1 Revised – January 31, 2008
JD Edwards World
Copyright © 2007, Oracle. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are “commercial computer software” or “commercial technical data” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.
The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.
Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
Open Source Disclosure
Oracle takes no responsibility for its use or distribution of any open source or shareware software or documentation and disclaims any and all liability or damages resulting from use of said software or documentation. The following open source software may be used in Oracle's PeopleSoft products and the following disclaimers are provided.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/). Copyright (c) 1999-2000 by The Apache Software Foundation. All rights reserved. THIS SOFTWARE IS PROVIDED “AS IS’’ AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 1
Table of Contents
Deployment Option 1 - Install the Transidiom Server on iSeries ...... 9
Installing Seagull Transidiom 5250 Gateway for iSeries ................................................ 9 Installing the Seagull Transidiom AIS for iSeries.......................................................... 16 Installing the JD Edwards World Components for iSeries........................................... 19
Deployment Option 2 - Install the Transidiom Server on Windows 26
Installing the Seagull Transidiom 5250 Gateway for Windows .................................. 26 Installing the Seagull Transidiom AIS for Windows .................................................... 32 Installing the JD Edwards World Service Enablement Components ......................... 36
Deployment Complete......................................................................... 42
Overview
Overview
Thank you for ordering JD Edwards World Service Enablement. This Java based service enablement product is a statement of Oracle's continued commitment to the JD Edwards World product family. Service Enablement allows you to integrate your JD Edwards World Software with other software packages through the use of Java based web services.
This guide explains installation and configuration options and steps for JD Edwards World Service Enablement. This includes the LegaSuite GUI product from Seagull Software, formerly known as Transidiom. We use the name Transidiom in this guide, to match the version of the product we are using.
To use JD Edwards World Service Enablement, you must first decide whether to run the Seagull Transidiom Server on the iSeries (Deployment Option 1) or on a Windows/NT server (Deployment Option 2). This guide contains an explanation for both options. The explanation of the Transidiom Central application install is first and the two deployment options follows.
2 JD Edwards World, A9.1
Pre-Installation Conditions
Pre-Installation Conditions
Before you install JD Edwards World Service Enablement, refer to the JD Edwards World A9.1 Minimum Technical Requirements guide for information about hardware and software you must install prior to this installation. You should also access Customer Connection for updates to this guide.
You must set up a proxy user for use with Service Enablement. For security reasons, this application functions with a proxy account with limited authority. For AS400 administration, the requirements for proxy user profile are as follows:
User class is *USER
Special Authority is *NONE
Group Profile is QUSER
Limit capabilities is *YES
Additionally, the proxy user must have authority to use menu travel and fast path.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 3
Install Transidiom Central on Windows/NT
Install Transidiom Central on Windows/NT
Installing the Seagull Transidiom Central
1. On a PC, unzip the A91_ServiceEnablement.zip file in a temporary folder.
2. On a PC, open the Setup.exe file from the JD Edwards World Service Enablement download or CD.
The system displays the Options Menu on the Welcome screen where you can launch several different installations.
3. On the Options Menu, place your cursor over Transidiom Central in the list of products.
4 JD Edwards World, A9.1
Install Transidiom Central on Windows/NT
4. Choose Install Transidiom Central in the lower right hand corner of the screen to start the InstallShield setup program.
5. On the Welcome screen, click Next.
6. On the License Agreement screen, choose I accept the terms in the license agreement and click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 5
Install Transidiom Central on Windows/NT
7. On Customer Information, enter user information and click Next.
8. On Destination Folder, ensure the Destination Folder path is C:\Program Files\SEAGULL\Transidiom Central and click Next.
9. On SEAGULL Projects Folder, ensure the Projects Folder path is C:\SEAGULL Projects and click Next.
6 JD Edwards World, A9.1
Install Transidiom Central on Windows/NT
10. On Change Program Menu Folder, accept the default Program Folders and click Next.
11. On Ready to Install the Program, click Install.
12. On InstallShield Wizard Completed, click Finish.
This completes the Transidiom Central install process.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 7
Install Transidiom Central on Windows/NT
8 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
Deployment Option 1 - Install the Transidiom Server on iSeries
This deployment option is a three step process. You must install all of the following:
Seagull Transidiom 5250 Gateway for iSeries
Seagull Transidiom Application Interface Server (AIS) for iSeries
JD Edwards World Components for iSeries
Installing Seagull Transidiom 5250 Gateway for iSeries
1. On the Welcome screen, choose Gateway from the Options Menu, and then choose 5250 Gateway for iSeries to start the InstallShield setup program.
2. On the Welcome screen, click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 9
Deployment Option 1 - Install the Transidiom Server on iSeries
3. On Software License Agreement, click Yes.
4. On Installation Procedure, choose Automatic Installation and click Next.
5. On Choose Destination Location, choose a folder for temporary files and click Next.
10 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
6. On Select Components, choose Program Files and Transidiom 5250 Gateway components and click Next.
7. On Server Port Setting, accept the default of 400 in the Port field and click Next.
8. On Host System Setting 5250 Gateway for iSeries, enter the host system name or IP address for your iSeries and click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 11
Deployment Option 1 - Install the Transidiom Server on iSeries
9. On FTP Connection settings, complete the following fields to connect to the iSeries where you will install the 5250 Gateway.
TCP/IP Address
User Name
10. On Transidiom 5250 Gateway for iSeries installation, click Ok.
11. On Setup Complete, choose Launch Registration Wizard now and click Finish.
12 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
12. On Welcome to the SEAGULL Registration Wizard, click Next.
13. On Select installation machine, choose Host Machine and click Next.
14. On Host system serial number, enter the serial number in the Enter host system serial number field.
Locate this serial number by starting the iSeries where the 5250 Gateway install resides with no license activation information. On the Command Line, enter SEATRA/STRTRAGW. Open the license.log file in the SEATRA folder and locate the serial number.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 13
Deployment Option 1 - Install the Transidiom Server on iSeries
15. On Registration information, complete the following fields:
Contact full name
Contact e-mail
Machine description
16. Enter 45B9DEF303F34FF6F3DC in the Installation key field and click Next.
17. On Activation Request submit, choose a method to send the activation request to SEAGULL and click Next.
14 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
18. After the activation request finishes, click Next on the submission screen.
19. Depending on the type of activation request, locate the seagull.saf file and copy it to the iSeries IFS directory of the iSeries where the 5250 Gateway install resides.
The default is SEATRA in the IFS Root directory.
20. On the screen indicating the activation was successful, click Next.
21. On the Activation result screen, click Finish.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 15
Deployment Option 1 - Install the Transidiom Server on iSeries
Installing the Seagull Transidiom AIS for iSeries
1. On the Welcome screen, choose Server from the Options Menu, and then choose Server for iSeries to start the InstallShield setup program.
2. On the Welcome screen, Click Next.
16 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
3. On Software License Agreement, click Yes.
4. On Installation Procedure, choose Automatic Installation and click Next.
5. On Choose Destination Location, enter the name of a folder to store temporary files and click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 17
Deployment Option 1 - Install the Transidiom Server on iSeries
6. On FTP Connection settings, complete the following fields to connect to the iSeries where the AIS resides and click Ok.
TCP/IP Address
User Name
7. On Transidiom Application Integration Server for iSeries installation, click Ok.
8. On Setup Complete, click Finish.
18 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
Installing the JD Edwards World Components for iSeries
1. On the Welcome screen, choose Service Enablement from the Options Menu, and then choose Install A9.1 Service Enablement to start the InstallShield setup program.
2. On License Agreement, click Yes.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 19
Deployment Option 1 - Install the Transidiom Server on iSeries
3. On Setup Type, choose Transidiom is installed on the iSeries and click Next.
4. On Choose Destination Location, enter the location for a temporary folder where you can download and configured files.
5. On Setup Type, choose one of the application servers and click Next.
If you run web services on an application server, choose either the Oracle Application Server or WebSphere Application Server.
20 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
6. On Service Enablement Configuration Transidiom Host, enter the host IP address or system name for the AIS server in the following field:
Transidiom Host
7. Enter the sockets port number in the following field.
The default Transidiom sockets port number is 1208.
Transidiom Port
8. Enter the Gateway port number in the following field and click Next.
The default Gateway port number is 400.
Gateway Port
9. On Transidiom Destination Directories, enter the directory names from the iSeries on which the 5250 Gateway and the Transidiom AIS reside in the following fields and click Next.
The default folders for these are SEATRA for the Gateway and SEAAIS for the AIS.
5250 Gateway
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 21
Deployment Option 1 - Install the Transidiom Server on iSeries
10. On Service Enablement Configuration iSeries Server, enter the name or IP Address of the iSeries where the World A9.1 release resides and click Next.
iSeries Server
11. On the Service Enablement Configuration Proxy User, complete the following fields for the proxy user and click Next.
Name
Password
Deployment Option 1 - Install the Transidiom Server on iSeries
12. On Service Enablement Configuration Environment, enter the name of the environment on the iSeries in the following field:
Environment Name
13. Enter the A9.1 object library on the iSeries in the following field:
Object Library
14. Enter the library that contains the F0094 file in the following field and click Next.
F0094 Library
The library that typically contains the F0094 file is JDEUSER.
15. On Service Enablement Configuration Connection Information, enter the maximum number of AS400 connections in the following field:
Max Connections
16. Enter the maximum wait time, in seconds, in the following field:
Max Wait Time
17. Enter the number of prefilled connections to setup for processing transactions through the JD Edwards World Java API and click Next.
Prefilled Connections
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 23
Deployment Option 1 - Install the Transidiom Server on iSeries
18. On InstallShield Wizard Complete, verify that the Upload the Service Enablement iSeries Components option is set and click Finish.
19. On FTP Connection settings, complete the following fields with the iSeries information, including a user with QSECOFR authority to start the iSeries install and click OK.
TCP/IP Address
User Name
24 JD Edwards World, A9.1
Deployment Option 1 - Install the Transidiom Server on iSeries
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 25
Deployment Option 2 - Install the Transidiom Server on Windows
Deployment Option 2 - Install the Transidiom Server on Windows
This deployment option is a three step process. You must install all of the following:
Seagull Transidiom 5250 Gateway for Windows
Seagull Transidiom AIS for Windows
JD Edwards World Service Enablement Components
Installing the Seagull Transidiom 5250 Gateway for Windows
1. On the Welcome screen, choose Gateway from the Options Menu, and then choose 5250 Gateway for Windows to start the InstallShield setup program.
2. On the Welcome screen, click Next.
26 JD Edwards World, A9.1
Deployment Option 2 - Install the Transidiom Server on Windows
3. On License Agreement, choose I accept the terms in the license agreement and click Next.
4. On Customer Information, complete the following fields by entering information about your users and click Next.
User Name
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 27
Deployment Option 2 - Install the Transidiom Server on Windows
5. On Destination Folder, click Next.
6. On Select Port, accept the default port and click Next.
7. On Select Host Address, enter the host system name or IP address for the iSeries in the following field and click Next.
Host
Deployment Option 2 - Install the Transidiom Server on Windows
8. On Setup Type, choose Typical and click Next.
9. On Change Program Menu Folder, accept the default menu folder and click Next.
10. On Ready to Install the Program, click Install.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 29
Deployment Option 2 - Install the Transidiom Server on Windows
11. On InstallShield Wizard Completed, choose Launch Registration Wizard now and click Finish.
12. On Welcome to the SEAGULL Registration Wizard screen click Next.
13. On Select installation machine, choose This machine and click Next.
14. On Registration information, complete the following fields:
e Contact full nam
Deployment Option 2 - Install the Transidiom Server on Windows
Company
15. Enter 45B9DEF303F34FF6F3DC in the following field and click Next.
Installation key
16. On Activation Request submit, choose a method to send the activation request to SEAGULL and click Next.
17. After the activation request finishes, click Next on the submission screen.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 31
Deployment Option 2 - Install the Transidiom Server on Windows
18. On the screen indicating the activation was successful, click Next.
19. On Activation result, Click Finish.
Installing the Seagull Transidiom AIS for Windows
1. On the Welcome screen, choose Server from the Options Menu, and then choose Server for Windows to start the InstallShield setup program.
32 JD Edwards World, A9.1
Deployment Option 2 - Install the Transidiom Server on Windows
2. On the Welcome screen click Next.
3. On License Agreement, choose I accept the terms in the license agreement and click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 33
Deployment Option 2 - Install the Transidiom Server on Windows
4. On Customer Information, complete the following fields by entering information about your users and click Next.
User Name
Organization
5. On Choose Destination Location, accept the default folder for installation and click Next.
6. On Select Java Runtime Environment, choose the Java Runtime Environment to use with the AIS and click Ok.
34 JD Edwards World, A9.1
Deployment Option 2 - Install the Transidiom Server on Windows
7. On Change Program Menu Folder, accept the default and click Next.
8. On Ready to Install the Program, click Install.
9. On InstallShield Wizard Completed screen, click Finish.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 35
Deployment Option 2 - Install the Transidiom Server on Windows
Installing the JD Edwards World Service Enablement Components
1. On the Welcome screen, choose Server Enablement from the Options Menu, and then choose Install A9.1 Service Enablement to start the InstallShield setup program.
2. On License Agreement, click Yes.
36 JD Edwards World, A9.1
Deployment Option 2 - Install the Transidiom Server on Windows
3. On Setup Type, choose Transidiom on the PC and click Next.
4. On Choose Destination Location, enter the folder where the Seagull programs reside and click Next.
The default is C:\Program Files\SEAGULL\.
5. On Choose Destination Location, enter a temporary folder where you can download and configure files.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 37
Deployment Option 2 - Install the Transidiom Server on Windows
6. On Setup Type, choose one of the application servers and click Next.
If you run web services on an application server, choose either the Oracle Application Server or WebSphere Application Server.
7. On Service Enablement Configuration Transidiom Host, enter the host IP address or system name for the AIS server in the following field:
Transidiom Host
8. Enter the sockets port number in the following field.
The default Transidiom port number is 1208.
Transidiom Port
9. Enter the Gateway port number in the following field and click Next.
The default Gateway port number is 1289.
Gateway Port
Deployment Option 2 - Install the Transidiom Server on Windows
10. On Service Enablement Configuration iSeries Server, enter the host IP address or system name for the iSeries server where the World applications reside in the following field and click Next.
iSeries Server
11. On the Service Enablement Configuration Proxy User, complete the following fields for the proxy user and click Next.
Name
Password
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 39
Deployment Option 2 - Install the Transidiom Server on Windows
12. On Service Enablement Configuration Environment, enter the name of the environment on the iSeries in the following field:
Environment Name
13. Enter the A9.1 object library on the iSeries in the following field:
Object Library
14. Enter the library that contains the F0094 file in the following field and click Next.
F0094 Library
The library that typically contains the F0094 file is JDEUSER.
15. On Service Enablement Configuration Connection Information, enter the maximum number of AS400 connections in the following field:
Max Connections
16. Enter the maximum wait time, in seconds, in the following field:
Max Wait Time
Deployment Option 2 - Install the Transidiom Server on Windows
17. Enter the number of prefilled connections to setup for processing transactions through the JD Edwards World Java API and click Next.
Prefilled Connections
18. After the Gateway is installed on the Windows machine, the properties for the Gateway shortcut should be changed. This change points to the proper screen definition file. Right-click the 5250 Gateway in the Transidiom folder in the Start menu and select Properties. From Properties, change the Start In option to be the folder that the A9_1SOA.wwr file is in.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 41
Deployment Complete
Deployment Complete
Congratulations, you have completed the install of JD Edwards World A9.1 Service Enablement. The following components have been installed:
Transidiom Central on the local machine
Transidiom Gateway on either the local machine or the iSeries
Transidiom AIS on either the local machine or the iSeries
World A9.1 Service Enablement Transidiom scripts deployed on the either the local machine or the iSeries
World A9.1 Service Enablement Java application .ear file for either the Oracle Application Server (OAS) or the WebSphere Application Server (WAS). For OAS, the file is WorldServicesEnablement-A9.1-0.ear. For WAS, the file is WorldSOA_A91_websphereear.ear. You can locate the file on the local machine in the directory under: \JDE World Service Enablement\WORLDSOA_WEBSERVICES folder. Also, the .ear file is on the iSeries in the WORLDSOA_WEBSERVICES directory under the Root IFS directory.
World A9.1 Service Enablement Java API .jar file, along with supporting .jar files, is on the iSeries in the WORLDSOA_JAVA directory under the Root IFS directory. The system uses this in conjunction with the A9.1 Approvals Management system. See Appendix B – Approvals Management System for more information.
Source code for the services is in a Source folder in the install work folder. Source code is in the form of .zip files for use in Oracle’s JDeveloper or IBM’s WebSphere Development Studio Client (WDSC). Also available is source for the Service Enablement Transidiom scripts. See Appendix C – Source Code for more information.
42 JD Edwards World, A9.1
Appendices
Appendices
Transidiom – For configuration of Transidiom components, see the Transidiom documentation.
Service Enablement Components – Most of the configuration of the JD Edwards World A9.1 Service Enablement Java components occurs within the config.xml file. Following is an example:
The system configures most of the variable information during the install process. If you need to change the config.xml, you can either rerun the install process or change it when you install it in the application server. Following are the parts of the config.xml.
1. Transidiom host – the IP address for the machine where Transidiom is running.
2. Port – the port that the Transidiom instance is using.
3. iSeries address – the name of the iSeries machine on which A9.1 running.
4. MaxConnections – the maximum number of Java connections on the iSeries.
5. Environment – the name of the production A9.1 environment.
6. ObjectLibrary – the name of the library where the system stores World A9.1 objects.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 43
Appendices
7. F0094Library – the name of the library where the system stores the F0094 object. Typically this is JDEUSERS.
8. Connection maxWaitTime – maximum number of seconds to wait for the system to establish a Java connection to the iSeries.
9. Prefill Connections – the number of pre-filled Java connections to the iSeries. The system establishes this when you instantiate the Java API layer.
10. Proxy User – the user id for the proxy user. The system uses this to establish the Java to iSeries connections.
11. Proxy password -- the password for the proxy user. The system uses this to establish the Java to iSeries connections.
12. SaleOrder, PurchaseOrder and JournalEntry processingVersion – the DREAM Writer versions of the EDI (Z-File) batch programs the system uses for processing those services. JD Edwards World recommends that you do not change these.
13. Defaults PID and JOBN – the defaults for the PID and JOBN fields in the Z-Files the system uses for Sales Order, Purchase Order and Journal Entry EDI processing.
14. Debug – Enter ‘true’ or ‘false’. Determines the amount of data feedback the Java API layer sends out.
TCP/IP Domain Configuration – For Transidiom to work efficiently, the TCP/IP domain search priority should be set to “*LOCAL”. You can set the TCP/IP domain search priority by entering the Change TCP/IP Domain command, CHGTCPDMN, on the iSeries command line.
Appendix B – Approvals Management System The Service Enablement design supports the new JD Edwards World A9.1 Approvals Management system. During the install, the system transfers the Service Enablement Java API .jar file, along with supporting .jar files, using FTP to the iSeries to the WORLDSOA_JAVA directory under the Root IFS directory. The system also transfers config.xml and you can find this in the WORLDSOA_JAVA\com\jdedwards\world\connection directory.
To run the Service Enablement Java API layer natively on the iSeries, the Java JVM must be running at the 1.4 level. One way to ensure that the Java JVM level is set correctly is to set the QIBM_RPG_JAVA_PROPERTIES.
To specify options in the QIBM_RPG_JAVA_PROPERTIES environment variable, you code the options in a string, one after the other, which you separate with any character that does not appear in any of the options. You then end the string with the separator character. For example, if you want to specify the options:
java.version=1.4
os400.stderr=file:stderr.txt
Appendices
Then you add the environment variable using the following command:
ADDENVVAR ENVVAR(QIBM_RPG_JAVA_PROPERTIES) VALUE('-Djava.version=1.4;-Dos400.stderr=file:stderr.txt;')
If the options string is not valid, Java may reject one of the options. Message JVAB55A appears in the joblog indicating which option was not valid.
Another way to set the JVM level is through the use of the SystemDefault.properties file which is either in the current user’s home directory (/home/username) or in the directory /QIBM/UserData/Java400.
Appendix C – Source Code During the install process, the system loads the source code for the Service Enablement Java API layer in the install work directory. This includes two Java source .zip files as well as a .zip file with the Transidiom script files.
The first Java source .zip file includes the World SOA Project, which is an Oracle JDeveloper project. Developers use the JDeveloper tool for the Service Enablement project. Also in the project is a Web Services Deployment configuration to create the .ear files.
The second Java source .zip file includes an IBM WDSC workspace and World SOA Workspace. JD Edwards World Development mainly used the IBM WDSC workspace to create the .ear files to use with WebSphere Application Server.
The Transidiom .zip file includes the Service Enablement Transidiom project. You can modify and enhance this with the use of Seagull’s 5250 Connector Builder product.
Appendix D – Deploying .ear files to Application Servers Following are basic instructions for deploying the JD Edwards World Service Enablement .ear application files to either the Oracle Application Server 10.1.3 (OAS) or the WebSphere Application Server 6.1 (WAS). You can also use WebSphere Application Server Express edition. See either the Oracle or WebSphere Application Server documentation for detailed instructions and deployment options on deploying the .ear files.
Deploying to Oracle Application Server
1. Start your Oracle Application Server.
2. Login to OAS Enterprise Manager. The default is the following: http://machine.name:8888/em.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 45
Appendices
3. On the OC4J: home page, click the Applications tab and then click Deploy.
4. On Deploy: Select Archive, click Deploy.
5. Click Browse to access the location for the Archive Location on the local host.
46 JD Edwards World, A9.1
Appendices
6. On Choose File, locate the WORLDSOA_WEBSERVICES folder in your install directory. Choose the WorldServicesEnablement-A9.1-0.ear file and click Open.
7. On Deploy: Select Archive, click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 47
Appendices
8. On Deploy: Application Attributes, complete the following field and click Next.
Application Name.
9. . On Deploy: Deployment Settings, click Deploy.
48 JD Edwards World, A9.1
Appendices
Deploying to WebSphere Application Server
1. Start your WebSphere Application Server.
2. Login to WAS Administration Console. The default is the following: http://machine.name:port/ibm/console.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 49
3. On Integrated Solutions Console Welcome, open the Applications option and choose Enterprise Applications.
The system displays the Enterprise Applications.
4. On Enterprise Applications, click the Install button.
5. On Preparing for the application installation, choose Local file system and then click Browse to locate the file.
50 JD Edwards World, A9.1
Appendices
6. On Choose File, open the WORLDSOA_WEBSERVICES folder in your install directory, choose the WorldSOA_A91_WebsphereEAR.ear file and click Open.
7. On Preparing for the application installation, click Next.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 51
Appendices
8. On Install New Application, accept the default values and click Next at the bottom of the screen.
9. On Install New Application, verify the correct server is set for the module, if multiple servers are running, and click Next.
52 JD Edwards World, A9.1
Appendices
10. On Install New Application, click Finish at the bottom of the screen.
11. On Integrated Solutions Console Welcome, choose Save directly to the master configuration.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 53
Appendices
12. On Enterprise Applications, choose WorldSOA_A91_WebsphereEAR application and click Start.
13. On Enterprise Applications, the system displays the message that the application has started successfully.
54 JD Edwards World, A9.1
Appendices
Appendix E – Scheduling Transidiom Application Startup There are several different methods you can use for the system start a job autonomously. Your system administrator should dictate this for each site as well as the existing environment.
To automatically start the Transidiom 5250 Gateway and AIS, you can use a job scheduler entry. For the 5250 Gateway, the following two screens are an example entry.
Service Enablement Installation and Configuration Guide (Revised - March 28, 2007) 55
Appendices
For the AIS, the following two screens are an example entry.
Note: The starting time for the AIS should be after the 5250 Gateway.
56 JD Edwards World, A9.1
Overview
Deployment Option 1 - Install the Transidiom Server on iSeries
Installing Seagull Transidiom 5250 Gateway for iSeries
Installing the Seagull Transidiom AIS for iSeries
Installing the JD Edwards World Components for iSeries
Deployment Option 2 - Install the Transidiom Server on Windows
Installing the Seagull Transidiom 5250 Gateway for Windows
Installing the Seagull Transidiom AIS for Windows
Installing the JD Edwards World Service Enablement Components
Deployment Complete
Appendix C – Source Code
Appendix E – Scheduling Transidiom Application Startup