13 Install and Configure Axway B2Bi

This chapter describes the steps required to install and configure the Axway B2Bi EDI (Electronic Data Interchange) Gateway so it can operate correctly with Argus Interchange.

Note:

Either B2B or Axway B2Bi is required for E2B reports exchange. You can choose any one of the software, as required.

You may install EDI Gateway and Interchange Service in any order.

13.1 Create an Axway B2Bi Database Instance

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

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

  3. Connect to the Axway B2Bi instance created in Step 2.

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

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

    • Grant CREATE PROCEDURE

    • Grant CREATE SESSION

    • Grant CREATE TABLE

    • Grant CREATE VIEW

    • Grant UNLIMITED TABLESPACE (Optional)

    • Grant CREATE SEQUENCE

    • Alter user Axway B2Bi DB User default tablespace USERS.

    • Grant CONNECT

    • Grant RESOURCE

13.2 Install Axway B2Bi

For more information, see the Axway B2Bi installation documentation.

13.3 Configure Axway B2Bi

  1. Log in to a client computer.

  2. From the browser, go to (Sender or Receiver) http://<AxwayB2BiServer>:6080/ui/.

  3. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  4. In the Getting Started screen, hover over the Trading Configuration icon and select Recent Communities > Manage Trading Configuration from the menu.

  5. In the Pick a community screen, click Add a community.

  6. In the Choose the source screen:

    1. Click Next to continue.

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

    3. Enter the parameters.

    4. Click Yes to add a certificate.

      Note:

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

    5. Click Finish.

  7. In the Add a certificate screen, click Create a self-signed certificate and click Next.

  8. In the Enter the certificate information screen, click Next.

  9. In the Review request screen, click Next.

  10. In the View certificate details screen:

    1. Check Make this the default encryption certificate.

    2. Check Make this the default signing certificate.

    3. Click Finish.

  11. Hover over the Trading Configuration icon, from the drop-down menu, select the recent Communities > <community>.

  12. In the Summary screen, click the Setup up a pickup for receiving messages from partners.

  13. In the Choose message protocol screen, select the EDIINT AS2 (HTTP) option and click Next.

  14. In the Choose HTTP transport type screen, click Next.

  15. In the Configure URL screen, click Next.

  16. In the Exchange Name screen, enter the Exchange Name and click Finish.

  17. In the Summary screen, click Application Delivery and add an application delivery.

  18. In the Choose transport protocol screen, select the File system option and click Next.

  19. In the Configure the file system settings screen, click Next.

  20. In the Exchange Name screen, enter the Exchange Name and click Finish.

  21. Go to the Summary Page and click Configure the settings for application delivery.

  22. In the Select application delivery screen, select Name, enter Friendly Name, and click Finish.

13.3.1 Configure Axway B2Bi for Binary File Transmission

You can configure transmission for binary files such as PMDA zip files and E2B attachments.

To configure Axway B2Bi for binary file transmission:

  1. Log in to a client computer.

  2. From the browser, go to (Sender or Receiver): http://<AxwayB2BiServer>:6080/ui.

  3. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  4. In the Getting Started screen, hover over the Trading Configuration icon and from the drop-down menu, select Recent Communities > <community>.

  5. In the Summary screen, click the Application Pickup icon and add an application pickup.

  6. In the Choose transport protocol screen, click File system option and click Next.

  7. In the From address and To address screens, click Next.

    Address must be determined by either message attribute configuration or by protocol address only.

  8. In the Configure the file system settings screen, on the Sender's Axway B2Bi Server, locate Common/Out folder and create the following folder structure:

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

  9. In the Exchange Name screen, enter the Exchange Name and click Finish.

  10. In the Change this application pickup exchange screen, click the Message attributes tab.

  11. In the Message attribute directory mapping tab:

    1. The system moves them to the Selected attributes list.

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

    3. Locate the Available Attributes list.

    4. Click the From address tab.

  12. Click To address tab, select the Address determined by message attribute configuration option or by protocol address only and click Save Changes.

  13. On the Sender's Axway B2Bi 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 B2Bi GUI the Application Pickup folder will show up only ..\common\out.

  14. For incoming binary transmissions, repeat steps 5 - 8 for Application Delivery.

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

13.3.2 Configure Axway B2Bi Community

13.3.2.1 Register with the Axway B2Bi Community

  1. From the browser, go to http://<Receiver Axway B2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter Axway B2Bi User ID and Password, and click Login.

  3. In the Getting started screen, hover over the Trading Configuration icon and from the drop-down menu, select Recent Communities > <community>.

  4. In the Summary screen, click Export this community as a partner profile at the bottom of the page.

  5. Enter the password and save the file to your local hard drive and close the Save dialog box.

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

13.3.2.2 Add a Partner to the Axway B2Bi Community

  1. From the browser, go to http://<Sender AxwayB2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  3. In the Getting Started screen, hover over the Trading Configuration icon and select Recent Communities > <community> from the menu.

  4. In the Summary screen, click the Add a Partner to this community link.

  5. In the Choose the source screen, select the Import the profile information from a file option and click Next.

  6. In the Enter profile path screen, click Browse to navigate to the saved file, enter the same password used at the time of exporting this community as a partner profile, and click Finish.

  7. In the Successful profile import screen, 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 listed from Steps 9 - 12.

  8. In the Summary screen:

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

    2. Click the Routing IDs icon.

  9. In the Routing IDs screen:

    1. Click Add.

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

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

      The new routing ID is added to the page.

    4. Hover over the Trading Configuration icon.

    5. Select Recent Communities > <community> from the menu.

  10. In the Summary screen, select the sender partner.

  11. In the Summary: Sender screen, click the Default delivery exchange link.

  12. In the Change this delivery exchange screen, click the HTTP Settings tab, and verify that the URL is correct and that the correct routing ID for the send is appended to the end of the URL

13.3.2.3 Register the Receiver's Community on the Sender Server

Repeat the procedures of the Section 13.1, "Create an Axway B2Bi Database Instance".

13.3.3 Add a Node

  1. From the browser, go to http://<Sender Axway B2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  3. In the Getting started screen, click the System Management icon.

  4. In the System Management screen, click Add a Trading engine node.

  5. In the Add a node screen:

    1. Click Add.

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

    3. Click the Trading Engine option.

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

    • Click Start to start the trading engine node.

      The system updates System management page.

      The status of the node changes to Starting.

      The system updates the System management page.

      The status of the node changes to Running.

  7. Click Home and verify that the node status is Running.

  8. Repeat the procedure to set up the Receiver Axway B2Bi.

13.3.4 Configure Axway B2Bi Certificates

13.3.4.1 Configure Receiver Axway B2Bi Certificates

  1. From the browser, go to http://<Receiver Axway B2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  3. In the Getting Started screen, hover over the Trading Configuration icon and select Manage trading configurations from the menu.

  4. In the Community screen, click the Community name.

  5. In the Summary screen, click the Certificates link.

  6. In the Certificate screen, 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 B2Bi.

    Skip this section if a valid trusted root certificate already exists in the Name section on the Trusted root certificates tab.

  7. In the View certificate screen, in the General tab, locate the Related task section and click Export this certificate.

  8. In the Choose the format you want to use for the certificate export screen, retain the default configurations.

    1. Click Export certificate.

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

    3. Select the Include all certificates in the certification path if possible checkbox.

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

13.3.4.2 Configure Sender Axway B2Bi Certificates

  1. From the browser, go to http://<Sender Axway B2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  3. In the Getting Started screen, hover over the Trading Configuration icon and select Manage trading configurations from the menu.

  4. In the Community screen, click the Community name.

  5. In the Summary screen, click the Certificates link.

  6. In the Certificate screen, click the Trusted root certificates tab and click the Add a trusted root certificate link.

    Note:

    It is possible that the Trusted Root Certificates for the Receiver Axway B2Bi Server may already be on the Sender Axway B2Bi Server.

  7. In the Add a certificate screen, click Next.

  8. In the Locate the certificate file screen, click Browse to locate the P7B certificate file saved for the Receiver Axway B2Bi Server and click Next.

  9. In the View certificate details screen, click Finish.

  10. In the Pick a certificate screen, click the Trusted root certificates tab.

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

  12. Log out of the Sender Server.

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

13.3.5 Configuring EVENTS.XML

To configure Event.xml on Client machine:

  1. Log in to a client computer.

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

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

  4. In the Oracle SQL+ screen:

    1. Enter the Axway B2Bi instance in the TSNAMES entry.

    2. Enter the Axway B2Bi DB User Name in the Axway B2Bi User Name.

    3. Enter the Axway B2Bi User Password in the Password for User Axway Synchrony_USER.

    4. Enter the Axway B2Bi Schema User in the [USERS].

  5. When SQL+ connects to the specified database, enter the Directory name and the log file name.

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

To configure Event.xml on Receiver machine:

  1. Log in to the Receiver Server.

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

  3. Take a backup of the Events.xml file and rename it Events.xml.bak.

  4. Right-click the Events.xml file and select Edit to display it in 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>

  7. Copy the ArgusRouter.jar file from Argus local directory: \SUPPORT\AxwayB2Bi\2.3.1 to Axway B2Bi directory: <Axway B2Bi Install folder>\Interchange\jars\.

  8. From the browser, go to http://<Receiver Axway B2BiServer>:6080/ui/.

  9. In the Getting Started screen, hover over the Trading Configuration icon and from the drop-down menu select Recent Communities > Community.

  10. In the Summary screen and click the Application Pickup icon.

  11. In the Application pickup exchange screen, click the link in the Name column.

  12. Click the Inline Processing tab.

  13. In the Inline processing rules screen, enter the following parameters:

    1. Class name—com.cyclonecommerce.relsys.router.GetMessageInfo

    2. Parameter—Relsys Argus

    3. Description—GetMessagesInformation

  14. Click Save changes.

  15. When the Pick an integration pickup exchange screen appears, click Logout.

  16. Repeat the preceding steps for the Sender Server.

13.3.6 Configure Message Processing Settings

  1. From the browser, go to http://<Sender Axway B2BiServer>:6080/ui/.

  2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  3. In the Getting Started screen, hover over the Trading Configuration icon and select Recent Communities > <community> from the menu.

  4. In the Summary screen, click the Application Pickup icon.

  5. In the Application pickup exchange screen, click a link in the Name column.

  6. Click the Advanced tab and from Message processing, select Limited - only use message handler and collaboration settings.

  7. In the Getting Started screen, hover over the Trading Configuration icon and select Recent Communities > <community> from the menu.

  8. In the Summary screen and click the Trading Pickup icon.

  9. In the Trading pickup exchange screen, click a link in the Name column.

  10. Click the Advanced tab, and from Message processing, select Limited - only use message handler and collaboration settings.

  11. Go to <AxwayB2Bi Install folder>\B2Bi, and execute the following command to stop the server:

    ./B2Bi stop

  12. Go to <AxwayB2Bi Install Folder>\B2Bi, and execute the following command to start the server:

    ./B2Bi start

  13. To verify that the Trading engine node in Running state and the Integration engine node in Started state, and the Trading engine node is assigned to the Integration engine node:

    1. From the browser, go to http://<Sender Axway B2BiServer>:6080/ui/

    2. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

    3. In the Getting started screen, click the System Management icon.

    Note:

    If the Trading engine node is not in Running state then click Start.

13.4 Test Communication

  1. From the Sender Axway B2Bi 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. Make sure that the Axway B2Bi servers on both sender and receiver are running.

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

  4. Log in to a machine where Axway B2Bi is installed.

  5. From the browser, go to http://<Sender Axway B2BiServer>:6080/ui/.

  6. In the Axway B2Bi Login screen, enter the Axway B2Bi User ID and Password, and click Login.

  7. In the Getting started screen, hover over the Message Tracker icon and select the Message Searches > All Messages from the menu.

    From the Search results screen, verify that the transmission is in progress by locating the Custom Search section and click Find until Delivered appears on the screen.

    Note:

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

  8. When the file is transmitted successfully, click Logout.

  9. Go to the Axway B2Bi Receiver server and verify that the E2B file has been received.

  10. To verify that the file has been transmitted:

    1. Log in to the receiver Axway B2Bi server.

    2. Select the All Messages option.

    3. View the message payload.

  11. Compare the E2B file on the receiving machine (payload version displayed) with the file from the sending machine.

    These files should be identical.

  12. To verify delivery on the Receiver Server, repeat the procedure.

    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 B2Bi outbound folder.