Skip Headers

Oracle® Argus Safety Installation Guide Release 7.0.1 E26221-02 |
| Contents

Previous | Next |

# 6 Installing and Configuring EDI Gateway

This chapter describes the steps required to install and configure the Axway Synchrony EDI Gateway so it can operate correctly with Interchange. This chapter includes instructions on the following topics:

- Creating an Axway Synchrony Database Instance

- Installing Axway Synchrony Interchange

- Starting the Axway Synchrony Server

- Configuring Axway Synchrony Interchange

- Configuring Axway Synchrony for Binary File Transmission

- Configuring Axway Synchrony Community

- Adding a Node

- Configuring Axway Synchrony Certificates

- Configuring EVENTS.XML

- Testing Communication

Note: You can install EDI Gateway and Interchange Service in any order.

## Creating an Axway Synchrony Database Instance

Use the following procedure to create an Axway Synchrony database instance.

To create a database instance for Axway Synchrony:

1. Log on to the database server as an Admin user.

2. Create a blank Axway Synchrony instance, if it does not already exist.

3. Connect to the Axway Synchrony Instance created in Step 2.

4. Create an Axway Synchrony DB User identified by the Axway Synchrony DB password.

5. Provide the following grants to the Axway Synchrony DB user:

   - Grant CREATE PROCEDURE

   - Grant CREATE SESSION

   - Grant CREATE TABLE

   - Grant CREATE VIEW

   - Grant UNLIMITED TABLESPACE (Optional)

   - Grant CREATE SEQUENCE

   - Alter user Axway Synchrony DB User default tablespace USERS.

   - Grant connect, resource, unlimited tablespace to Axway Synchrony DB User.

## Installing Axway Synchrony Interchange

Before starting and configuring Axway Synchrony Interchange, you must install Axway Interchange. For more information, see the Axway Interchange installation documentation.

## Starting the Axway Synchrony Server

Use the following procedure to start the Axway Synchrony Server.

To start the Axway Synchrony Server:

1. Log on to the computer as an Admin user.

2. Go to the Services directory for the local machine.

3. Locate the GatewayInterchageService for the local machine.

4. Double click to display the GatewayInterchageService Properties dialog box.

5. When the system opens the GatewayInterchageService Properties dialog box:

   - Click Start to start the service if the Service Status is not Started.

   - Once Service Status is set to Started, Click OK to close the dialog box.

     An alternative way of starting the Axway Synchrony server is to use the Command Prompt.

6. To use the Command Prompt to start the Axway Synchrony Server:

   - Select Start=> Programs=> Axway Synchrony=> Start Server.

     The system displays the Start Server dialog box.

     Note: The first time you perform this task, the system creates tables in the database. This dialog is different on subsequent executions. Do not close this dialog box until the system displays Server Startup Complete.

## Configuring Axway Synchrony Interchange

Use the following procedure to configure Axway Synchrony Interchange.

To configure Axway Synchrony Interchange:

1. Log on to a client computer.

2. Open Internet Explorer.

3. Go to the following URL: (Sender or Receiver) http://<Axway SynchronyServer>:6080/ui/.

4. When the system opens the Axway Synchrony Login window:

   - Click Login.

   - Type the Axway Synchrony Password in the Password field.

   - Type the Axway Synchrony User ID in the User ID field.

5. When the system opens the Getting Started window:

   - Place the mouse over the Trading Configuration icon.

   - Select Recent Communities=> Manage Trading Configuration from the menu.

6. When the system opens the Pick a community window:

   - Click Add a community.

7. When the Add community wizard opens the Choose the source window:

   - Click Next >> to continue.

   - Click the Manually create a new community profile option button.

   - Type the name of the Community in the Community name field.

   - Click Finish.

   - Type the routing ID in the Routing ID field.

   - Type the e-mail address in the E-mail address field.

   - Type the phone number in the Phone number field.

   - Type the contact name in the Contact name field.

   - Click Yes to add a certificate.

     Note: This information is entered for both the sender and the receiver, but initially for the sender.

8. When the wizard opens Add a certificate window:

   - Click Next >> to continue.

   - Click Create a self-signed certificate.

9. When the wizard opens the Enter the certificate information window:

   - Click Next >> to continue.

10. The wizard opens the Review request window:

    - Click Next >> to continue.

11. When the wizard opens the View certificate details window:

    - Click Finish.

    - Click Make this the default encryption certificate.

    - Click Make this the default signing certificate.

12. When the wizard opens the Pick a community window:

    - Click the community name link for the newly created community.

13. When the Summary window opens:

    - Click the Set up a delivery exchange for picking up messages from partners link.

14. When the Choose message protocol window opens:

    - Click Next >> to continue.

    - Click the EDIINT AS2 (HTTP) option button.

15. When the Choose HTTP transport type window opens:

    - Click Next >> to continue.

16. When the Configure URL window opens:

    - Click Finish.

17. When the Summary window opens:

    - Click the Set up a delivery exchange for routing received messages to integration link.

18. When the Choose transport protocol window opens:

    - Click Next >> to continue.

    - Click the File system option button.

19. When the Configure the file system settings window opens:

    - Click Finish.

    - Type the Axway Synchrony Password in the Password field.

20. When the Summary window opens, repeat steps 1 - 20 to set up the Receiver Axway Synchrony.

## Configuring Axway Synchrony for Binary File Transmission

This section provides a procedure for configuring transmission for binary files such as PMDA zip files and E2B attachments.

To configure Axway Synchrony for binary file transmission:

1. Log on to a client computer.

2. Open the following URL (Sender or Receiver): http://<Axway SynchronyServer>:6080/ui.

3. When the Axway Synchrony Login window opens:

   - Type the Axway Synchrony Password in the Password field.

   - Click Login.

   - Type the Axway Synchrony User ID in the User ID field.

4. When the Getting Started window opens:

   - Place the mouse over the Trading Configuration icon.

   - Select Recent Communities=> <community> from the menu.

5. When the Summary screen opens:

   - Click the Integration Pickup icon.

6. When the Pick an integration pickup exchange window opens:

   - Click the Other (Plaintext) from File system link.

7. When the Change this integration pickup exchange window opens:

   - Click the Message attributes tab.

8. When the Message attribute directory mapping tab opens:

   - The system moves them to the Selected attributes list.

   - Select From routing ID and To routing ID and click Add.

   - Locate the Available Attributes list.

   - Click the From address tab.

9. When the From address tab opens:

   - Click the To address tab.

   - Click the Address determined by message attribute configuration option button.

   - Click Save Changes.

10. When the To address tab opens:

    - Click the Address determined by message attribute configuration option button.

    - Click Save Changes.

11. On the Sender's Axway Synchrony Server, locate Common/Out folder and create the following folder structure:

    Common\Out\Sender's Routing ID\Receiver's Routing ID

    Note: This completes the folder configuration for outgoing binary transmissions. Since binary file transmission configuration is based on these folder names, each combination of Sender and Receiver Routing ID must be unique for binary file transmission to different trading partners. The Binary file should be dropped in the RECEIVER's Routing ID Folder which is the last folder. Although in the Axway Synchrony GUI the Integration Pickup folder will show up only ..\common\out.

12. For incoming binary transmissions, repeat steps 5 - 8 for Integration Delivery.

    Repeat steps 1 - 12 for setting up the Receiver Axway Synchrony.

## Configuring Axway Synchrony Community

Configuring the Axway Synchrony Community includes the following:

- Registering with the Axway Synchrony Community

- Adding a Partner to the Axway Synchrony Community

### Registering with the Axway Synchrony Community

Use the following procedure to register with the Axway Synchrony Community.

To register with the Axway Synchrony Community:

1. Open this URL: http://<Receiver Axway SynchronyServer>: 6080/ui/.

2. When the Axway Synchrony Login window opens.

   - Type the Axway Synchrony Password in the Password field.

   - Type the Axway Synchrony User ID in the User ID field.

   - Click Login.

3. When the Getting started window opens:

   - Place the mouse over the Trading Configuration icon.

   - Select Recent Communities=> <community> from the menu.

4. When the Summary page opens:

   - Click the Export the receiver's community's profile link at the bottom of the page.

5. Save the file to your local hard drive and close the Save dialog.

6. Click the Logout button in the upper right corner of the page.

### Adding a Partner to the Axway Synchrony Community

Open Internet Explorer.

To add a partner to the Axway Synchrony Community:

1. Open the following URL: http://<Sender Axway SynchronyServer>: 6080/ui/.

2. When the Axway Synchrony Login window opens:

   - Type the Axway Synchrony User ID in the User ID field.

   - Type the Axway Synchrony Password in the Password field.

   - Click Login.

3. When the Getting started page opens:

   - Place the mouse over the Trading Configuration icon.

   - Select Recent Communities=> <community> from the menu.

4. When the Summary page opens.

   - Click the Add a Partner to this community link.

5. When the Partner Wizard opens the Choose the source window:

   - Click Next >>to continue.

   - Click the Import the profile information from a file option button.

6. When the wizard opens the Enter profile path page:

   - Click Finish.

   - Click Browse to navigate to the saved file.

7. When the Successful profile import page opens:

   - Click Close.

     Note: If you receive a summary where the Routing ID is not displayed, you must add the sender's Routing ID manually as in Steps 9 --

8. When the Summary page opens:

   - Click the Partners menu item and select the newly imported partner.

   - Place the mouse over the Trading Configuration icon.

   - Click Set up a routing ID.

9. When the Change routing IDs page opens:

   - Click Add.

   - Type the partner (sender) routing ID in the Routing ID field.

   - Verify that the partner does not have a routing ID.

     The system adds the new routing ID to the page.

   - Place the mouse over the Trading Configuration icon.

   - Select Recent Communities=> <community> from the menu.

10. When the Summary page opens:

    - Select the sender partner.

11. When the Summary: Sender page opens:

    - Click the Default delivery exchange link.

12. When the Change this delivery exchange page opens:

    - Verify that the URL is correct and that the correct routing ID for the send is appended to the end of the URL.

    - Click the HTTP Settings tab.

#### Registering the Receiver's Community on the Sender Server

Repeat the procedures in sections Creating an Axway Synchrony Database Instance and Starting the Axway Synchrony Server to register the Receiver's community on Sender Server.

## Adding a Node

Use the following procedure to add a node.

To add a node:

1. Open Internet Explorer.

2. Go to the following URL: http://< Sender Axway SynchronyServer>:6080/ui/.

3. When the Axway Synchrony Login window opens:

   - Type the Axway Synchrony User ID in the User ID field.

   - Type the Axway Synchrony Password in the Password field.

   - Click Login.

4. When the Getting started page opens.

   - Click the System Management icon to open the System Management page.

5. When the System Management page opens:

   - Click Add a node.

6. When the Add a node page opens:

   - Click Add.

   - Select the machine to add the node to from the Computer name drop-down list.

   - Click the Trading Engine option button.

7. When the System management page opens with the newly created node:

   - Click Start to start the node.

     The system updates System management page.

     The status of the node changes to Starting.

     The system updates the System management page.

   - Click Home.

     The status of the node changes to Running.

8. When the Welcome page opens:

   - Verify that the node status is Running.

9. Repeat the preceding steps to set up the Receiver Axway Synchrony.

## Configuring Axway Synchrony Certificates

You can configure Axway Synchrony Certificates on the following:

- Configuring Receiver Axway Synchrony Certificates

- Configuring Sender Axway Synchrony Certificates

### Configuring Receiver Axway Synchrony Certificates

Use the following procedure to configure Axway Synchrony Certificates on the Receiver Axway SynchronyServer.

To configure Axway Synchrony Certificates on the Receiver Axway Synchrony Server:

1. Open Internet Explorer.

2. Go to the following URL: http://< Receiver Axway SynchronyServer>:6080/ui/.

3. When the Axway Synchrony Login page opens:

   - Type the Axway Synchrony User ID in the User ID field.

   - Type the Axway Synchrony Password in the Password field.

   - Click Login.

4. When the Getting Started page opens:

   - Place the cursor on the Trading Configuration icon.

   - Select Manage trading configurations from the menu.

5. When the Pick a community page opens:

   - Click the Community name.

6. When the Summary page opens:

   - Click the Certificates link.

7. When the Pick a certificate page opens:

   - Click the Certificate listed on the Personal certificates tab.

     Note: Click the Trusted root certificates tab to verify that no certificates exist for the Sender or Receiver Axway Synchrony. Skip this section if a valid trusted root certificate already exists in the Name section on the Trusted root certificates tab.

8. When the View certificate page opens:

   - Locate the Or pick a task section and click Export this certificate.

9. When the Choose the format you want to use for the certificate export page opens:

   - Click Export certificate.

   - Click the Include all certificates in the certification path if possible check box.

   - Click the Cryptographic Message Syntax Standard PKCS #7 option button.

10. Save the file to the Sender's local hard drive and click Logout in the upper right corner of the page.

### Configuring Sender Axway Synchrony Certificates

Use the following procedure to configure Axway Synchrony Certificates on the Sender Axway SynchronyServer.

To configure Axway Synchrony Certificates on the Sender Axway Synchrony Server

1. Open Internet Explorer.

2. Go to the following URL: http://< Sender Axway SynchronyServer>:6080/ui/.

3. When the Axway Synchrony Login page opens:

   - Click Login.

   - Type the Axway Synchrony Password in the Password field.

   - Type the Axway Synchrony User ID in the User ID field.

4. When the Getting Started page opens:

   - Place the cursor on the Trading Configuration icon.

   - Select Manage trading configurations from the menu.

5. When the Pick a community page opens:

   - Click the Community name.

6. When the Summary page opens:

   - Click the Certificates link.

7. When the Pick a certificate page opens:

   - Click the Trusted root certificates tab.

     Note: It is possible that the Trusted Root Certificates for the Receiver Axway Synchrony Server may already be on the Sender Axway Synchrony Server

8. When the list of trusted root certificates opens.

   - Click the Add a trusted root certificate link.

     Note: It is possible that the Trusted Root Certificates for the Receiver Axway Synchrony Server may already be on the Sender Axway Synchrony Server

9. When the Add a certificate page opens in a new window:

   - Click Next >> to continue.

10. When the Locate the certificate file page opens:

    - Click Browse to locate the P7B certificate file saved for the Receiver Axway Synchrony Server.

    - Click Next >> to continue.

11. When the View certificate details page opens:

    - Click Finish.

12. When the Pick a certificate page opens in the original window:

    - Click the Trusted root certificates tab.

13. When the list of Trusted root certificates opens:

    - Verify that the certificate you added appears on the list.

14. Log out of the Sender Server.

    Repeat the preceding steps to register the Sender's certificate on the Receiver Server as a Trusted Root Certificate.

## Configuring EVENTS.XML

Use the following procedure to configure EVENTS.XML.

To configure EVENTS.XML

1. Log on to a client computer.

2. Using Windows Explorer, go to the local directory containing the Argus Safety installation files and navigate to ..\DBInstaller\Cyclone.

3. Locate and double-click the cyclone_schema_Oracle11g.bat file to open a DOS command prompt window.

4. When the Oracle SQL+ window opens:

   - Type the Axway Synchrony instance in the TSNAMES entry.

   - Type the Axway Synchrony DB User Name in the Axway Synchrony User Name.

   - Type the Axway Synchrony Schema User in the [USERS].

   - Type the Axway Synchrony User Password in the Password for User Axway Synchrony_USER.

5. When SQL+ connects to the specified database:

   - Enter the log file name in log file name.

   - Enter the log directory name in Directory.

Once the process is complete, the SQL+ window and DOS command prompt window close.

1. Log on to the Receiver Server.

2. Using Windows Explorer, navigate to <Axway Synchrony Install Folder>\build\conf folder\.

3. Backup the Events.xml file and rename it Events.xml.bak.

4. Right-click the Events.xml file and select Edit to display Notepad.

5. Locate the <EventRouters> section and add the following code:

   <EventRouter id="ARGUS Events" class = "com.cyclonecommerce.relsys.router.GetEventInfo" active="true">

   <Parameters file="../logs/ARGUS.log" rollOnStart= "true" autoFlush="true" maxFileSize="2M" maxBackupFiles="5"/>

   <MetadataProcessorListRef ref="Messaging"/>

   <EventFilterRef ref="ARGUS"/>

   </EventRouter >

6. Add the following section in the Events.xml file in the <EventFilters> section:

   <EventFilter id="ARGUS">

   <OrFilter>

   <EventFilterRef ref="Message Milestones"/>

   <EventLevelFilter level="Warning"/>

   <EventLevelFilter level="Error"/>

   <EventLevelFilter level="High"/>

   </OrFilter>

   </EventFilter>

   In order to re-enable logging to the MESSAGEEVENTSNAPHOTS table, the following event filter needs to be un-commented in the events.xml. This used to be enabled by default in Axway Synchrony versions prior to Axway Synchrony v5.4.

   <EventRouter id="Message Events to Database" class=class="com.cyclonecommerce.events2.router.PersistenceRouter" active="true" priority="2147483647">

7. Copy the ArgusRouter.jar file from Argus [local directory] \ SUPPORT \ Axway Synchrony \ Axway Synchrony 5x to Axway Synchrony directory: <Axway Synchrony Install Folder>\build\jars\.

8. The following file ”<Axway Interchange Installation Path>\Synchrony\Interchange\conf\jvmArguments.xml” on the cyclone server must be edited to add the ArgusRouter.jar file entry, as displayed in the following image:

   Description of the illustration axway.gif

9. Open Internet Explorer.

10. Open the following URL: http://<Receiver Axway SynchronyServer>: 6080/ui/.

11. When the Axway Synchrony Login page opens:

    - Type the Axway Synchrony User ID in the User ID field.

    - Click Login.

    - Type the Axway Synchrony Password in the Password field.

12. When the Getting started page opens:

    - Place the cursor on the Trading Configuration icon.

    - Select Recent Communities=> Community from the menu.

13. When the Summary page appears.

    - Click the Integration Pickup icon.

14. When the Pick an integration pickup exchange page opens:

    - Click the link in the Type column.

15. When the Change this integration pickup exchange page opens:

    - Click the Inline Processing tab.

16. When the Inline processing rules appear:

    - Type com.cyclonecommerce.relsys.router.GetMessageInfo in the Class name field. in the Class name field.

    - Enter Relsys Argus in the Parameter field.

    - Enter GetMessagesInformation in the Description field.

17. Click Save changes.

18. When the Pick an integration pickup exchange page opens.

    - Click Logout.

19. Repeat the preceding steps for the Sender Server.

## Testing Communication

Use the following procedure to test communication for Axway Synchrony Interchange.

To test communication for Axway Synchrony Interchange:

1. From the Sender Axway Synchrony Server, configure an XML file to transmit from the Sender server to the Receiver server.

   Note: The file must be an E2B file that contains the correct routing IDs for the sender and the receiver.

2. Ensure that the Axway Synchrony servers on both sender and receiver are running.

3. Drop the E2B XML file into the out bound folder of the Axway Synchrony Sender server.

4. Log on to a machine where Axway Synchrony is installed.

5. Open Internet Explorer.

6. Open this URL: http://<Sender Axway SynchronyServer>:6080/ui/.

7. When the Axway Synchrony Login page opens:

   - Click Login.

   - Type the Axway Synchrony Password in the Password field.

   - Type the Axway Synchrony User ID in the User ID field.

8. When the Getting started page opens:

   - Place the cursor on the Message Tracker icon.

   - Select Message Searches=> All Messages from the menu.

     When the Search results page opens verify that the transmission is in progress by locating the Custom Search section and clicking Find until Delivered appears on the screen.

     Note: The system does not display this screen if it has already transmitted the file.

9. After the system transmits the file it opens the Search results for page:

   - Click Logout.

10. Go to the Axway Synchrony Receiver server and verify that the E2B file has been received.

11. To verify that the file has been transmitted:

    - Log in to the receiver Axway Synchrony server.

    - Select the All Messages option.

    - View the message payload.

12. Compare the E2B file on the receiving machine (payload version displayed) with the file from the sending machine. These files should be identical.

13. Repeat the preceding steps to verify delivery on the Receiver Server.

    Verify that the E2B XML file is configured with proper routing IDs for both the send and the receiver before dropping the file into the Axway Synchrony outbound folder.