IBM E02HRLL-G - WebSphere Partner Gateway..., Administration Manual

Page 1: ...WebSphere IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide Version 6 2...

Page 2: ...Advanced Edition product number 5724 L68 and to all subsequent releases and modifications until otherwise indicated in new editions When you send information to IBM you grant IBM a nonexclusive right...

Page 3: ...synchronous target time out 23 Managing interactions and document definitions 23 Managing XML formats 24 Large file support 25 Enabling or disabling actions 25 Managing handlers 25 Importing a handle...

Page 4: ...g the processing of documents from the destination queue 87 Viewing destination details 88 Changing destination status 88 Chapter 10 Analyzing document flows 89 Document Analysis tool 89 Viewing the s...

Page 5: ...2 SQLCODE 289 error 162 SQLCODE 1225 error 162 SQL 0964C Transaction log full error on the BCGMAS database 162 IBM service log unreadable 163 WebSphere Application Server informational messages 163 In...

Page 6: ...e 2 183 Document processing when the database goes down 183 java lang NoClassDefFoundError with reprocessDbLoggingErrors bat 184 Recovery process when queue and disk is full or unavailable 184 Workflo...

Page 7: ...al partners have to complete a configuration process to connect to the hub community Once connected external partners can exchange electronic business documents with the internal partner Refer to WebS...

Page 8: ...onventions This document uses the following conventions Table 1 Typographic conventions Convention Description Monospace font Text in this font indicates text that you type values for arguments or com...

Page 9: ...cumentation available with this product includes comprehensive information about installing configuring administering and using WebSphere Partner Gateway Enterprise and Advanced Editions You can downl...

Page 10: ...cheduler v Ability to federate into an existing WebSphere Application Server cell v Support for Secure File Transfer Protocol SFTP v CPP CPA Editor for ebXML Message Service ebMS v Enhancements Improv...

Page 11: ...g one application server called server1 As simple mode system does not use Deployment Manager the mechanics of starting and stopping the WebSphere Partner Gateway components are similar to usage of We...

Page 12: ...s and concepts regarding the way that the Deployment Manager operates Distributed topology terms and concepts v The system consists of one or more nodes v The WebSphere Deployment Manager is an applic...

Page 13: ...from the command line but other administration tasks cannot be performed until the Deployment Manager is available again The most common administration task that is performed is starting and stopping...

Page 14: ...WebSphere Partner Gateway server by running the startServer script located in the WebSphere Parnter Gateway Install Dir wasND Profiles bcgprofile bin directory on the computer where the server was in...

Page 15: ...ng servers prior to starting the WebSphere Partner Gateway component servers Starting all the servers using the Deployment Manager About this task 1 Confirm that the node agent is running for each nod...

Page 16: ...rforming the next step 2 Select the messaging cluster bcgmasCluster and click Stop Stopping the individual servers on each computer About this task If you do not want to stop all servers in each clust...

Page 17: ...docmgr The names shown here are the installation default names Be aware that during installation the installer might have chosen different names and you must use these names instead of the default nam...

Page 18: ...cgmas server and any of the WebSphere Partner Gateway component servers installed make sure that the node agent s are running 2 Start each WebSphere Partner Gateway server by running the startServer s...

Page 19: ...evious step until you have stopped all the servers you want to stop 7 Wait until the servers have stopped before stopping the messaging servers 8 Select the bcgmas server messaging you want to stop an...

Page 20: ...14 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 21: ...d For optimum viewing use a minimum screen resolution of 1024 x 768 To log in to the Community Console follow these steps 1 Type the following URL in the location field of any Web browser http hostnam...

Page 22: ...e procedure under Logging in to the Community Console on page 15 v Help Opens the online help for WebSphere Partner Gateway Note If you do not see a help window after clicking help check to make sure...

Page 23: ...Submitted Synchronous data flow No icon is displayed for asynchronous transactions Upload map View a previously sent original document when there is a duplicate document event View details View group...

Page 24: ...rom the Community Console When you finish using the Community Console click Logout at the top right side of any Console window The system logs you out and returns you to the Console Login window 18 IB...

Page 25: ...tion Environment on page 40 Managing password policy You can set up a password policy for the hub community if you want to use values other than those set by the system as defaults The password policy...

Page 26: ...here Application Server for use by the component applications You can use the WebSphere Application Server admin console to modify the data sources To configure the database connections used by the co...

Page 27: ...to Critical most serious Debug Low level system operations and support Visibility and use of the debug information are subject to the permission level of the user Info Successful system operations Th...

Page 28: ...dation Errors on page 114 Managing receivers The Receiver List window is used to view and edit existing receivers details and enable disable or delete receivers Viewing and editing receiver details Ab...

Page 29: ...is configured separately through managed application to allow or limit the number of HTTP connections To modify the values of Max sync time out and Max sync connection 1 Navigate to Receiver creation...

Page 30: ...ny of the channels 6 Click OK to delete the interaction along with its corresponding channels To find out where document definitions are being used follow these steps WHERE USED icon displays informat...

Page 31: ...ing the large file processing option on a document family the following limitations are placed on the expressions used in the XML formats that are stored in the family 1 Only simple element paths that...

Page 32: ...pears in the list of available handlers Deleting a handler About this task To delete a handler follow these steps 1 Click Hub Admin Hub Configuration Handlers 2 On the HandlersList page click the Dele...

Page 33: ...ation map Deleting validation maps About this task Use this procedure to delete validation maps 1 Click Hub Admin Hub Configuration Maps Validation Maps The validation maps currently in the system are...

Page 34: ...you can define specific envelopes to be used for certain exchanges you can set up control numbers that are assigned to the various parts of an interchange and you can set connection profiles so that...

Page 35: ...Hub Configuration EDI Envelope Profile 2 Click the Delete icon next to the Envelope profile name that you want to delete Enveloper About this task Use the Enveloper page to view and edit the Lock and...

Page 36: ...the applicable information in the following profile attribute fields v Connection Profile Name an unique name identifier for the new profile This is the only required field v Description a brief desc...

Page 37: ...e next to Interchange to indicate the number you want to use to initialize control number generation for interchanges 6 Type or change the value next to Group to indicate the number you want to use to...

Page 38: ...red by all of the hub component instances there might be times when component instances require their own configuration and not use the shared configuration data To handle this situation the component...

Page 39: ...ion DocMgr Administration Alert Engine within the WebSphere Partner Gateway console The attributes are v bcg alertNotifications mailHost v bcg alertNotifications mailFrom v bcg alertNotifications mail...

Page 40: ...programming interface API calls instead of using the Community Console to perform certain tasks To change the setting of the administration API follow these steps 1 Click System Administration Feature...

Page 41: ...ime for the DAE instance that polls the synchronous message s directory for example sync_in folder under Common The default value is 3 seconds v In Signal folder type a value in seconds representing t...

Page 42: ...to aid in configuring the product If a CPA has not been provided the product can be configured manually There are two ways to upload a CPA from the Document Definition page or from the Hub Admin page...

Page 43: ...sent in the CPA Non prepopulated attributes Attribute values are set at connection level during the upload of the CPA Some attributes however do not have pre populated values The following is the list...

Page 44: ...you are using the XML encryption you can use the following algorithms 1 3 des cbc 2 aes 128 cbc 3 aes 192 cbc 4 aes 256 cbc If you are using the using SMIME encryption you can use the following algor...

Page 45: ...g Content Validation routing object attribute the content validation over payload XML can be altered By default Content Validation is enabled Using non repudiation logging About this task WebSphere Pa...

Page 46: ...V8 2 is installed and running 3 WebSphere Transformation Extender server must have access to the WebSphere Partner Gateway common file system 4 Copy the dtxpi jar from the WebSphere Transformation Ext...

Page 47: ...Follow these steps to view and edit partner profiles 1 Click Account Admin 2 Click Search 3 Click the View details icon next to the partner whose details you want to view 4 On the Partner Details wind...

Page 48: ...ormation required for destination setup In Table 4 the boxes marked with an X require configuration information boxes marked with the letter O are optional See Table 5 on page 43 for the destination p...

Page 49: ...ck Online or Offline in the Access column to change the access of a destination 3 Click Enabled or Disabled in the Status column to change the status of a destination 4 Click the View details icon to...

Page 50: ...s placed in the lock request queue when it is denied a lock request Number of Threads Number of threads allocated for routing a document Default value is 3 This parameter is available to users who are...

Page 51: ...e information as required then click Save Viewing destination Where used About this task To view the details of where all a particular destination is employed use the following procedure 1 Click Accou...

Page 52: ...ut requiring the user to define the retry parameters explicitly The number of transport retries bcg delivery gwTransportMaxRetries and the time interval between retries bcg delivery gwTransportRetryIn...

Page 53: ...value of 120 seconds from the Connection time out value specified 2 Console Gateway retry 1 of 3 The Delivery Manager checks the Console Gateway level retries If it is greater than 0 then the deliver...

Page 54: ...Manager waits for the specified Console interval of 20 seconds before starting Console Gateway retry 3 of 3 a The HTTP Destination Sender sends the request but does not get the response within the con...

Page 55: ...r signed by a Certifying Authority 120 seconds Item 1 on page 47 Console Gateway Connection timeout Item 1 subtotal 120 seconds 20 seconds Item 2 on page 47 Console Gateway Interval Console retry 1 of...

Page 56: ...ce once for the Digital Signature and again for the Encryption certificate However if the certificate is used for Digital Signature and for SSL Client then the corresponding check boxes can be set in...

Page 57: ...f the configuring process used with the certpath related properties bcg CRLDir This property contains the name of the directory where the CRLs are stored The default value is WebSphere Partner Gateway...

Page 58: ...roperties field to false as follows D com ibm security enableCRLDP false Setting HTTP Proxy host and port for CRL DP Set the following Java Virtual Machine properties in the Generic JVM Properties fie...

Page 59: ...to disable 3 Click the Edit icon to edit certificate details 4 For Status select Disabled 5 Click Save Note When a primary certificate is disabled the corresponding secondary certificate is made prim...

Page 60: ...and routing functions such as validation checking for encryption and retry count To increase the efficiency when creating connections the attributes for a new connection are inherited from the B2B cap...

Page 61: ...ns on page 56 v Using the system s Advanced Search facility to specify additional search criteria including Business ID initiating and receiving packages and protocols and initiating and receiving doc...

Page 62: ...t Note To create a new connection the Source and Target must be unique 4 Click Search to find the connections that match your criteria 5 To activate a connection click Activate The Console displays th...

Page 63: ...e Document type used by the Target Connection Status Enables the search for enabled and disabled connections 4 Click Search The system finds the connections that match your criteria Changing connectio...

Page 64: ...ctivating a connection To disable or deactivate a connection click the Deactivate icon in the Enabled column The connection display color changes to gray indicating that the connection has been disabl...

Page 65: ...usion status Send All Notifications is selected by default Editing the exclusion list About this task There might be times when you must edit the Exclusion List For example you might want to restrict...

Page 66: ...60 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 67: ...erface is provided so the migration utility can be started using a script 2 An API is provided so user written Java programs can invoke the migration utility See the WebSphere Partner Gateway Programm...

Page 68: ...tracted by the utility Configuration data can be exported for the following items in a system v Enveloper schedules v Event codes v Transport and operation modes v Handler definitions metadata only us...

Page 69: ...create a zip file with the XML file in the root directory for the zip file The directories are as follows The routing objects are in a file called RoutingObjects zip within the RoutingObjects director...

Page 70: ...ta v d is the debug level from 1 to 5 where 5 provides the most debug output The d argument is optional and can be omitted If it is omitted only errors are logged v r is the root path where exported d...

Page 71: ...nt Admin Partner Destinations Manage Transport Types DestinationTypeInfo Account Admin Partner Destinations create destination Operation Mode is represented by DestinationTypeInfo HandlerInfo Hub Admi...

Page 72: ...in the list ContactInfo Account Admin Partner Contacts ContactInfo represents each contact in the list PartnerAddressInfo Account Admin Partner Addresses PartnerAddressInfo represents each address in...

Page 73: ...s sets used in the connections GroupInfo Account Admin Partners Groups GroupInfo represents each group in the list UserInfo Account Admin Partners Users UserInfo represents each user in the list FTPUs...

Page 74: ...figuration All or None f User configuration All or None g FTP user configuration All or None h Certificates All or None i Error flow configuration All or None j Archiver configuration All or None 2 Gl...

Page 75: ...referring to any other configured entity in the system Independent items are the configurable items that do not have any dependency before importing them into the target system Other configuration typ...

Page 76: ...routing objects of the source system has association with any of the profiles or maps the runtime behavior may not be as expected If the routing objects of the source system do not have any associati...

Page 77: ...ting object import is not performed then B2B capabilities will not be imported 5 Connection Connection is the most complex dependent item Connection import is dependent on routing object import intera...

Page 78: ...Handler Attributes 7 Fixed Workflow 8 Actions 9 Proxy Configuration 10 Envelope Profiles 11 Connection Profiles 12 Validation Maps 13 Transform Maps 14 EDI FA Maps 15 Targets 16 XML format family 17 R...

Page 79: ...ation for each object The newly configurable item is created when the utility is executed An existing configurable item is updated when the utility is executed v Only partner migrations and connection...

Page 80: ...74 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 81: ...aged authentication mechanism To enable the container managed authentication mechanism set the bcg ldap containerauth property value to True in the WebSphere Partner Gateway console then configure the...

Page 82: ...tion under the following circumstances v The LDAP server stops or permanently goes down v Container based authentication was chosen when installing WebSphere Partner Gateway but the LDAP server is not...

Page 83: ...tion Server to authenticate users in the LDAP server 1 Install the IBM Tivoli Directory server Follow the instructions in the installation guide that comes with IBM Tivoli Directory server Installatio...

Page 84: ...ications and infrastructure 18 In the right pane of the page click Security Configuration Wizard The wizard opens to step 1 of 4 for configuration 19 For step 1 select Enable application security and...

Page 85: ...member of this role 1 Start the WebSphere application server that has the Console application deployed 2 Select Applications Enterprise Applications and then click BCGConsole 3 On the right side of th...

Page 86: ...80 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 87: ...index htm Enabling tunneling IPv6 over IPv4 The IPv6 protocol cannot be used throughout the entire Internet so you must encapsulate IPv6 packets within IPv4 and tunnel through networks where only IPv4...

Page 88: ...in to the WebSphere Application Server Admin console 2 Go to Servers Application servers and select server 3 Select each server and change the java net preferIPv4Stack property using the following pr...

Page 89: ...s 3 Click the Editing publishing info properties icon 4 Type the IPv6 address of the local workstation where the hub is running in the bcg router ipv6 address property Note If more than one instance o...

Page 90: ...84 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 91: ...t documents from the queue Note If you are implementing an FTP Scripting Destination with an interval or calendar schedule documents may stay in this queue for an extended period until that interval o...

Page 92: ...Sort search results by Partner default or Destination Name Refresh Turn refresh on or off default Minimum Queued Minimum number of documents in a destination queue The default is 1 Direction Click Asc...

Page 93: ...nt by the system Direction Click Ascend to display documents starting with the oldest time stamp or beginning of the alphabet or Descend to display documents starting with the most recent time stamp o...

Page 94: ...arch screen 5 Click Search in Queued Documents Search The Destination details and a list of queued documents are displayed Changing destination status About this task To place a destination online or...

Page 95: ...ents processed by the system within a specific time period and can be viewed printed and saved exported to send to other staff members You can customize this report to view information based on specif...

Page 96: ...rom the Document Analysis Search window select the search criteria from the lists Table 14 describes the values that you can specify to determine which documents are displayed Table 14 Document search...

Page 97: ...troubleshoot the flow of your business documents The report displays the volume of documents processed by the system within a specific time period This report can be viewed printed and saved exported...

Page 98: ...the Document Volume Report About this task 1 Click Tools Document Volume Report The system displays the Document Volume Report Search window 2 Select the search criteria from the lists 3 Click Search...

Page 99: ...turned see Web Server result codes Pinging ebMS partners About this task From the Test Partner connection page you can ping ebMS partners This means that you can send a ping message to a partner and i...

Page 100: ...g one of the returned URLs v 302 Moved Temporarily The requested resource resides temporarily under a new URL Redirection to a new URL The original page has moved This is not an error most browsers in...

Page 101: ...that the client must first authenticate itself with a proxy HTTP 1 0 does not provide a means for proxy authentication v 408 Request Time Out The client did not produce a request within the time the...

Page 102: ...rdue searches that were removed from the resulting reports will be ignored by later searches Therefore removed records are not displayed in later reports Records can be removed from a report by select...

Page 103: ...document type of the transaction Target Trading Partner The partner that sent the transaction Target Package The target package of the transaction Target Protocol The target protocol of the transactio...

Page 104: ...ted Transaction report Viewing EDI Rejected Transaction reports Depending on the search criteria selected on the EDI Rejected Transaction Search page the search result is displayed in the EDI Rejected...

Page 105: ...of files deleted Number of files deleted by all users using delete command Uploaded Bytes Total number of bytes uploaded Downloaded Bytes Total number of bytes downloaded Current logins Displays exis...

Page 106: ...n the user last accessed this connection If this is blank it means that the user has only logged in and not issued any command yet Client Address The client IP from which the user has logged in 100 IB...

Page 107: ...cument Most types of documents are resent multiple times so when a document fails and generates an event you can use this information to investigate and correct the problem preventing similar failures...

Page 108: ...ntervention by support personnel Searching for events About this task 1 Click Viewers Event Viewer Check boxes for Event severity are organized from left to right and Debug is located on the left in t...

Page 109: ...ils About this task 1 Click Viewers Event Viewer 2 Select the search criteria from the lists 3 Click Search 4 From the displayed list of events click the View details icon next to the event you want t...

Page 110: ...escribe how to connect deliver validate and reply to data They do not interact with the content of the document only the transport AS2 and AS3 create a wrapper around a document so that it can be tran...

Page 111: ...documents in which the Partner is the Target or Source partner only AS Source Business ID Business identification number of the source partner defined in the AS header Payload Source Business ID Busi...

Page 112: ...state Sort by Sort results by v Target Timestamp v Source Document Definition v Target Document Type v Message ID v MDN Status v Document ID The default is Target Timestamp Descend or Ascend Descend d...

Page 113: ...led unsupported MIC algorithms 5 Optional Click the Document details icon to view more information about the document RosettaNet Viewer RosettaNet is a group of companies that created an industry stan...

Page 114: ...lphabet first Ascend displays either the oldest time stamp or the end of the alphabet first The default is Descend Results Per Page Specifies the number of results displayed per page 3 Click Search Th...

Page 115: ...ature is located at the bottom of the raw document rno file and the size of the raw document exceeds 100K or the signature is present after the first 100K of the rno file the signature will not be sho...

Page 116: ...of a document definition falling below Package and Protocol Original File Name The initial name assigned to the file Document ID Created by the source partner Criteria can include asterisk wildcard Re...

Page 117: ...en until the transaction is complete including request and acknowledgment or request and response Viewing document details events and raw documents About this task 1 Click Viewers Document Viewer The...

Page 118: ...ignature is located at the bottom of the raw document rno file and the size of the raw document exceeds 100K or the signature is present after the first 100K of the rno file the signature will not be...

Page 119: ...rios will assist you in locating this information v Viewing EDI document source transactions v Viewing EDI document target transactions v Locating the source interchange for an EDI transaction on page...

Page 120: ...displays the Document Viewer Search window 2 Select the search criteria from the lists 3 Click Search The system displays a list of documents 4 Click the View details icon next to the Document ID 5 C...

Page 121: ...d FreeFormText The data element is the third validation error since this field requires a minimum of six characters John xml version 1 0 encoding UTF 8 DOCTTYPE Pip3 A7PurchaseOrderUpdateNotifion SYST...

Page 122: ...client server before it interfaced with the backend system There are two basic types of documents that administrators can re send v In documents are those that come into WebSphere Partner Gateway eit...

Page 123: ...may be in the transformation Out document failures in BPE can be Fixed outbound workflow failures Packaging of the message can fail while encrypting or signing the message because of incorrect certifi...

Page 124: ...plays the ebMS Viewer Search screen 2 Select the search criteria from the lists Value Description Start Date and Time The date and time that the process was initiated End Date and Time The date and ti...

Page 125: ...to view The system displays details and associated documents for the selected process including the Conversation Status The Conversation status indicates what process is next for example Waiting for...

Page 126: ...us feature is enabled 1 Click Viewers ebMS Viewer The system displays the ebMS Viewer Search window 2 Type or select the applicable search criteria 3 Click Search The system displays a list of process...

Page 127: ...ort personnel To initiate the test the internal partner uploads a test document This feature only accepts RNIF v2 0 DTD based PIP it is not compatible with RNIF 1 1 The test document must be a Rosetta...

Page 128: ...header must be your own Business ID The system uses the to Business ID to find the correct connection The following is an example of the from and to Business IDs in a test document lines that are not...

Page 129: ...as the default RN PS partner and RN PS Manager destination for the internal partner External partner Set up an HTTP sink destination for the partner just as you did for the internal partner RosettaNe...

Page 130: ...r security properties by navigating to System Administration DocMgr Administration Security b Click the Modify icon to place the screen into edit mode c Change the value of the bcg certs vtp Certifica...

Page 131: ...document to verify that it was processed correctly it is an open document pending response Examine your internal application to verify that the document was received and processed correctly Use a tex...

Page 132: ...o and destination sections of the process requiring a response document change VTP_OWNER to VTP_TP or change VTP_TP to VTP_OWNER and make the appropriate changes to the receiver s URL See Table 36 for...

Page 133: ...en document About this task 1 Click RosettaNet Partner Simulator View Document Type 2 Click Remove next to the displayed document The document is deleted from the system Chapter 12 Simulating producti...

Page 134: ...128 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 135: ...can view and modify the archiver task v Archiver runtime tasks on page 132 list of runtime activities that occur while archiving v Archiver reports on page 133 view the status of each archiver task v...

Page 136: ...not be edited Status Status of the task displayed in non editable mode which can be any one of the following values v Scheduled by default the status is scheduled It means that the task is scheduled t...

Page 137: ...ackup in case of DB2 ORACLE_HOME oradata ORACLE_SID dbBackup in case of Oracle Note You need to provide a fully qualified path where the database user has write permissions Purging Schedule Daily Week...

Page 138: ...ed by the system 2 The configuration is read and the appropriate data is archived to the backup locations 3 The common file system is cleaned up and data is purged from the database tables Here is the...

Page 139: ...or an error event and the alert will be generated when that particular error occurs v The Archiver Task will stop further scheduling and you have to manually reset the configuration for the archiver a...

Page 140: ...LG_STACKTRACE LG_EVENT LG_ACK LG_CHAIN LG_EDI_FA_RECONCILE LG_ENVELOPE_INCLUSION State Engine BP_RNSTATEHDRAUDITLOG BP_RNMSGDIGEST BP_SPONSOR_STATE BP_RNSTATEDTL BP_RNSTATEHDR BP_AS_STATE_DTL BP_AS_S...

Page 141: ...se Archive Location directory This location will be searched for the files backed up from the NONREP folder during archiving The default value will be taken from latest configuration for the archiver...

Page 142: ...1 or later 1 Use the bcgDBNonRepImport script to import the table data into LG_MSG_ARCHIVE table 2 Run the archiver from the console This will create the database export files in the format supported...

Page 143: ...w link will be disabled 2 The server starts to execute the task If the Copy option is selected while configuring the data gets copied to the specified location Stopping a running archiver task Here ar...

Page 144: ...Restore functionality will be restricted on the following versions v Oracle 9i does not support export or import through database calls You need to perform export and import of database data using the...

Page 145: ...here Partner Gateway are described in this section SystemOut log and SystemErr log Log messages are written whenever an application writes to the standard output stream or standard error stream Applic...

Page 146: ...ployed under the path WebSphere Partner Gateway install dir wasND profiles profile name logs server name Managing the log files means controlling the amount of disk space they can use Some way of limi...

Page 147: ...ssages for the server v You can change the format used for the log messages Both of the formats provide the message that the application writes The difference between the basic and advanced formats is...

Page 148: ...here Partner Gateway install dir wasND profiles profile name logs server name This is the same default directory where the log files are written Table 39 Simple mode trace configuration Application Tr...

Page 149: ...onsole by clicking on Servers Application servers in the left pane to list the server names in the right pane 2 View the details of the server that you want to configure by selecting the server name i...

Page 150: ...changes to configuration before saving For a complete description of these features see the WebSphere Application Server documentation Setting log detail levels When problems occur services and suppor...

Page 151: ...tree views are only a fraction of all the packages and classes that make up WebSphere Partner Gateway applications You might be asked to obtain tracing for classes that are not in these lists If you c...

Page 152: ...mponents Z A placeholder to indicate that the type was not recognized Integrated FTP Server logging This section describes the integration of success and failure event messages for the FTP Server acti...

Page 153: ...v 226 Transfer complete v 550 Invalid paths v 550 Permission denied v 425 Can t open data connection v 426 Data connection error v 551 Error on output file Once the document is successfully uploaded t...

Page 154: ...148 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 155: ...ies The IP Restrictor allows you to restrict access to FTP Server using IP addresses Click Add to add new IP address IP address can be specified with wild cards namely and The order of the rules is im...

Page 156: ...using FTP user management page v Search for FTP users across partners based on the required search criteria v Edit FTP user information v Create a new FTP user which creates FTP user in the hub opera...

Page 157: ...also provides example scenarios considering different installation and deployment topologies Note The commands mentioned in this chapter is not case sensitive Limitations While automatically updating...

Page 158: ...bcgChangeDataSource bat sh with new Host name IP address and Port number as the input parameters that is bcgChangeDataSource bat sh New IP Hostname PORTNUMBER This executable is available in the fold...

Page 159: ...r of database Refer to the appropriate section for detailed steps to change the host name and port number of database Ensure that you backup the configuration files before making any significant chang...

Page 160: ...DMGR profile as described below a In Machine B where deployment manager is installed execute bcgChangeDmgrHostname bat sh with new Host name IP address as the input parameter for example bcgChangeDmgr...

Page 161: ...ute bcgChangeDmgrHostname bat sh with new Host name IP address as the input parameter for example bcgChangeDmgrHostname bat 9 1 1 1 The executable is available in the folder Installation directory of...

Page 162: ...bcgChangeDataSource bat 9 1 1 2 55880 Ensure that you provide new host name IP address and new port number of the application database that is installed on Machine A b In Machine C where WebSphere Par...

Page 163: ...the first 1000 records only on page 165 v Console does not start after a server restart on page 165 v FTPScripting Receiver receives StringIndexOutofBoundsException on page 166 v Receiver Failure to r...

Page 164: ...s on page 181 v Servers fail to start after applying fixes on page 181 v Correcting the shortcut ports for WebSphere Application Server on page 182 v Avoiding duplicate document delivery when there is...

Page 165: ...sing streams rather than as byte arrays For example if RAM size is 512 MB then the value of bcg maximumFileSizeForByteArrays property can be set to 20 MB All documents of size greater than 20 MB will...

Page 166: ...ail with the error OutOfMemory The OutOfMemory error is the result the working memory not being sufficient for the Websphere Partner Gateway to route the documents in bulk Therefore it is recommended...

Page 167: ...vailable to the database agent for sort processing To correct this situation decrease the value of the SORTHEAP parameter for the database that you created for WebSphere Partner Gateway Contact your d...

Page 168: ...error A DB2 error code 289 indicates that the database has run out of space on the file system Check with the database administrator about adding additional capacity on the database sever Alternativel...

Page 169: ...he service log is not in the default directory you must fully qualify the service log file name This showlog command produces output in Common Base Event XML format For more examples of Showlog script...

Page 170: ...to database name 2 db2 v reorgchk update statistics on table all 3 db2 connect reset Note Ensure that you stop all Websphere Partner Gateway components before starting this procedure You should also...

Page 171: ...ick Save EDI reports export the first 1000 records only The export function of the 2 EDI Reports FA Overdue and Rejected Transactions exports the first 1000 records only in order to minimize unexpecte...

Page 172: ...e is displayed Unable to update the Receiver Config file java io IOException A file or directory in the path name does not exist This error occurs when the WebSphere Partner Gateway Receiver is starti...

Page 173: ...lication Server Admin Console b Go to Environment Shared Libraries c Look for BCG_RCVR_USEREXISTS and BCG_ROUTER_USEREXITS d Edit the shared library information in these attributes and ensure that the...

Page 174: ...You will not be able to create and save any destination of that transport type For example tns2 AttributeName URI tns2 AttributeName should not be used Resolving WebSphere Partner Gateway errors BCG2...

Page 175: ...he router log should now be clear of the error and the router CPU usage should go back to normal Creating File directory destination on a drive other than C If a WebSphere Partner Gateway File Directo...

Page 176: ...eiver logs bcgreceiver v Document manager logs are in C IBM WPG bcghub was profiles bcgdocmgr logs docmgr 3 In the each folder check the SystemErr log This file should have the time stamp of the lates...

Page 177: ...taBinding Utility warning Error in the element JMS IBM PutApplTypeMsg Class BCGPackagingHeaders does not have a feature named JMS IBM PutApplType 11 1 05 14 14 07 426 PST 00000080 SystemOut O com ibm...

Page 178: ...character set on Oracle 1 Connect to the oracle database 2 Select NLS_CHARACTERSET from v nls_parameters 3 The value returned should be AL32UTF8 Verify this on your Oracle systems There is not a dire...

Page 179: ...tent Types attribute by adding the new content type Ensure that the content type values are separated by a comma Note It is recommended not to change these content type values unless advised Fixing BC...

Page 180: ...Tools Command Line Processor 2 Connect to the database using the command DB2 connect to bcgapps user username using password 3 Increase the buffer size using the command DB2 alter bufferpool buff32k...

Page 181: ...o be provided For self signed certificates revocation check is not being done See Configuring the certpath related properties on page 51 for more information Returning document volume report search in...

Page 182: ...m another location 7 Verify that the shared libraries are associated with each WebSphere Partner Gateway application To verify a On the WebSphere Application Server Admin console Applications page cli...

Page 183: ...r target xml 5 logs portdef props b Edit Installed_path bcghub receiver lib config bcg_receiver properties Note The port number can also be changed using the WebSphere Application Server Admin Console...

Page 184: ...ndshake fails because no certificate received This problem occurs during the SSLHandShake between a partner and WebSphere Partner Gateway when you are sending to a partner using SSL with Client Authen...

Page 185: ...processing 2 1 07 14 04 40 546 EST 00000088 ExceptionUtil E CNTR0020E EJB threw an unexpected non declared exception during invocation of method onMessage on bean BeanId BCGBPE ejb bcgBpeEJB jar BPEM...

Page 186: ...all of the follow objectives are met v Graceful recovery v No document loss v No duplicate document processing v No performance degradation after restart v No hung documents Fixing WebSphere MQ messa...

Page 187: ...ade to WebSphere Partner Gateway v6 2 the AS Viewer in the Community Console will show an unknown state for the MDN Status on AS transactions that occurred prior to the upgrade This is a limitation of...

Page 188: ...is updated for example when a service pack is installed the caching data must be updated The updating of the cache is supposed to occur the first time a command is issued in a profile after a service...

Page 189: ...eption No more data to read from socket To resolve this issue install the Oracle 10g version of the JDBC driver This driver alleviates known incompatibilities between Oracle 9i and the WebSphere Appli...

Page 190: ..._INSTALL_HOME Receiver temp In this case the Hub will trigger an event 103205 with the following description Receiver Processing halted due to following reason failed to process target With Queue and...

Page 191: ...Management Report Searching product specific information and so on ISA tool allows the customers to find necessary information required for analyzing the problem and managing the service requests Refe...

Page 192: ...actions this attribute has all the content types that are excluded from canonicalization To resolve the issue add application pkcs7 mime content type to excludedContentTypesForCanonicalization propert...

Page 193: ...ue depth is large enough so that it does not overflow See Appendix C component specific system attributes on page 223 for the list of attributes used to manage queue overflow Generating summary data A...

Page 194: ...188 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 195: ...nitialized please correct the problem and restart the service error reason 2 Critical BCG103201 Hub Owner State Engine Error Error Reason 0 Error This event is generated when a unrecoverable system oc...

Page 196: ...lure Document failed transformation due to 0 Error This event is generated because of a failure during document transformation BCG200006 Protocol Transformer Input File Failure Protocol transformer in...

Page 197: ...cessor Critical This event is generated when a packager is not available for an outbound document BCG210008 IP Address Validation Failure From IP address is not in the partner profile 0 Error This eve...

Page 198: ...he system failed to parse EDI routing information BCG210019 Synchronous Operation not Supported on this Connection Synchronous Operation not Supported on this Connection Error This event is generated...

Page 199: ...d when the system is unable to contact the database server during duplicate processing BCG210052 Duplicate Document Received This document appears to be a duplication of a document sent on 2 Error Thi...

Page 200: ...ute set to Yes BCG230004 Validation Internal Error 0 Critical This event is generated because of an internal system failure during validation processing BCG230006 Validation Database Error 0 Critical...

Page 201: ...ettaNet state Critical This event is generated when the unpackager encounters database communication errors when updating the RosettaNet state BCG240013 Partner Certificate Did Not Match Signer Name s...

Page 202: ...und Critical This event is generated when a valid certificate is not found When this event is displayed neither the primary nor the secondary certificate is valid The certificates might be expired or...

Page 203: ...0 Error This event is generated when AS signature validation fails BCG240412 AS State Engine DB Failure AS State Engine DB error 0 Critical This event is generated when the AS state engine database f...

Page 204: ...D 1 Error BCG240600 AS State Engine Error AS State Engine Error 0 Critical This event is generated when the RosettaNet State Engine encounters a system error BCG240601 AS Retry Failure AS Attribute ma...

Page 205: ...er files in 0 reject and oversize folders for document 1 Error BCG281002 Console Resend Document Already In Queue Console resend document already in queue 0 Critical BCG310002 EDI Transaction Envelope...

Page 206: ...valid input for component 0 Missing required property 1 Error BCGEDICM0004 Invalid Property Value Invalid input for component 0 Value 1 is invalid for property 2 Error BCGEDICM0005 Unsupported Charact...

Page 207: ...ent An internal error occurred The object passed to component 0 was missing or invalid Error BCGEDICM0102 Class Load Failure A dynamically configured class could not be loaded Configuration key 0 Clas...

Page 208: ...Exception Details 0 Error BCGEDIEM0109 The temporary directory value provided for the receiver component is null The temporary directory value provided for the receiver component is null Error BCGEDI...

Page 209: ...Parser Exception Occurred while trying to serialize the AbsDocument Error BCGEDIEM0203 Exception occurred while serializing AbsDocument Exception Occurred while trying to serialize the AbsDocument Err...

Page 210: ...Total groups greater than number allowed by control number mask Error BCGEDIEV0054 Multiple Interchanges Error The 0 deenveloper detected an error Multiple interchanges were detected but not allowed...

Page 211: ...eption caught when reading script Error BCGEDIFT0117 Unexpected Exception Parsing FTP Script Unexpected exception caught while parsing FTP Script Contact your system administrator Further details abou...

Page 212: ...a Socket Is Null Data Socket is null Error BCGEDIFT0211 Load Private Key Failed Could not load private key file from filename 0 Alias not found Error BCGEDIFT0212 Client Certificate Validation Failed...

Page 213: ...ta Syntax 0 Dictionary 1 Document 2 Exception text 3 Error BCGEDIMD0002 Metadata Control String Invalid The metadata control string is invalid or is compiled for a different version Syntax 0 Dictionar...

Page 214: ...etadata Read Failed An attempt to get the metadata for the message failed Error BCGEDIUP0118 Character Encoding Error Error encoding 0 into character set 1 Error BCGEDIUP0021 Unable to Identify Input...

Page 215: ...t file data is not supported The character set was 0 Error BCGEDIUP0042 Unsupported Record Found An unsupported record was found processing C and D records The character C D or Z was expected in the f...

Page 216: ...has child nodes other than RECORD LOOP Error BCGEDIUP0109 Missing Record Name in Node NULL or empty RecordName found in RECORD node Error BCGEDIUP0110 Error Getting Metadata Information Unable to get...

Page 217: ...ess a control string instruction The control string instruction was 0 the instruction stream offset was 1 and the map name was 2 Error BCGEDIUT0023 Output Document Creation Failed An attempt to create...

Page 218: ...0 is invalid or was compiled for a different version Error BCGEDIUT0403 Global Variable Not Found The global variable 0 was not found The map control string 1 could not be loaded Error BCGEDIUT0404 Gl...

Page 219: ...ing trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Element type 8 value 9 effective length 10 defined maximum length 11 Error BCGEDIVA0003 Data Element T...

Page 220: ...er 4 5 receiving trading partner id qualifier 6 7 control numbers 8 Error BCGEDIVA0012 Failed Exclusive E Condition Failed exclusive E condition the standard defines items 0 as mutually exclusive but...

Page 221: ...ent name 1 segment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Error BCGEDIVA0016 Composite Data Element Maximum Repetitions Exceed...

Page 222: ...gment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Element type 8 value 9 Error BCGEDIVA0032 Invalid Real Numeric Element Invalid re...

Page 223: ...ier 5 6 control numbers 7 Repetition number 8 maximum defined repetitions 9 Error BCGEDIVA0050 Too Many Elements or Unexpected Element in Segment Too many elements or unexpected element in segment ele...

Page 224: ...g partner id qualifier 2 3 receiving trading partner id qualifier 4 5 control numbers 6 Repetition number 7 maximum defined repetitions 8 Error BCGEDIVA0101 Transaction Set or Message Control Numbers...

Page 225: ...trading partner id qualifier 4 5 control numbers 6 Error BCGEDIVA0152 Functional Group Trailer Missing or Invalid Functional group trailer missing or invalid functional control number 0 sending tradin...

Page 226: ...e count interchange header control number 0 sending trading partner id qualifier 1 2 receiving trading partner id qualifier 3 4 Value from trailer 5 actual number received 6 Error BCGEDIVA0211 Duplica...

Page 227: ...ry 0 document type 1 syntax 2 Error BCGEDIVA0994 Empty Transaction Set or Message EDI transaction set or message is empty Error BCGEDIVA0995 Fatal Parser Error Fatal parser error encountered Error BCG...

Page 228: ...222 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 229: ...edence over the value configured in the WebSphere Partner Gateway Console For detailed information about WebSphere environment variables see the WebSphere Application Server documentation To create a...

Page 230: ...RoleClassificationCode 0 To partner Role toRole 0 PartnerRoleDescription 0 PartnerDescription 0 BusinessDescription 0 GlobalBusinessIdentifier 0 To partner Business ID toRole 0 PartnerRoleDescription...

Page 231: ...ata connection class Class that handles the Data connection bcg ftp config listeners default data connection idle time Connection idle time in seconds bcg ftp config listeners default data connection...

Page 232: ...clientauth data connection class Class that handles the Data connection bcg ftp config listeners clientauth data connection idle time Connection idle time in seconds bcg ftp config listeners clientau...

Page 233: ...e Description bcg config ftpserver FTPSerializeFileInterval It is the interval in milliseconds after which the accumulated events are serialized to the file system bcg config ftpserver eventPersistThr...

Page 234: ...AS state engine Table 59 on page 239 v Attributes used to configure the business process engine BPE Table 60 on page 239 v Attributes used to configure processing of signals Table 61 on page 240 v Att...

Page 235: ...Entry Default value Possible settings Description bcg ldap containerauth False Boolean True or False When the Boolean value is set to True it indicates that the users are authenticated using the WebSp...

Page 236: ...ing containing either FileSystem or JMS Determines the document routing transport for moving documents internally from the receiver to the Document Manager bcg global common introduce document transpo...

Page 237: ...Integer CRLs and VTP certificates are reloaded periodically after this interval which is in milliseconds Despite its name including Rosettanet this attribute applies to all protocols bcg certs vtp Cer...

Page 238: ...ND Profiles bcgprofile logs bcgdocmgr The default name of the trace file is bcg_router log traceLevel Transformation 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Validat...

Page 239: ...MVanAckProcessor 0 Integer between 0 and 2 See the description for traceLevel All traceLevel EDIAckProcessor 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Utility 0 Integ...

Page 240: ...f characters that cannot be used in some of the fields that are configured using the console These are used for validation of partner login data and receiver and destination gateway data that is enter...

Page 241: ...ame The default setting has Internet Assigned Numbers Authority values for many of the most commonly used encodings bcg console help host localhost Host name or IP address The host name or IP address...

Page 242: ...Internal setting that affects inter component communications This is for IBM use only bcg oaq_log_q jms bcg queue datalogQ JNDI name Internal setting that affects inter component communications This i...

Page 243: ...is used to pass documents to the Document Manager Table 58 Attributes used to configure the alert engine Entry Default value Possible setting Description bcg alertQReceiver maxRetries 100 Integer Maxi...

Page 244: ...eply to address for alert notifications bcg alertNotifications mailEnvelopeFrom unknown unknown com e mail address The e mail address to use for replies in the event of an incorrect e mail addresses b...

Page 245: ...n folder bcg dae main maxfiles perPass 5 Integer Maximum number of files to process per main folder poll interval bcg docmgr channelCache maxSize 20 Integer When a document is processed a Partner Conn...

Page 246: ...s between directory scans bcg in_thread_count signal 2 Integer Number of inbound threads for signal router bcg inbound_files_per_pass signal 5 Integer Maximum number of files to pick up in a scan Tabl...

Page 247: ...hreadPoolMaxThreads 50 Integer Maximum size of the thread pool used by the delivery manager bcg delivery gatewayMaxThreads 20 Integer Maximum number of gateway threads bcg delivery gwTransportMaxRetri...

Page 248: ...IBM use only bcg jms topic factory jms bcg cf DOCMGRCF JNDI name Internal setting that affects inter component communications This is for IBM use only bcg jms jndi_factory com ibm websphere naming Wsn...

Page 249: ...e only bcg delivery queue jms bcg queue deliveryManagerQ JNDI name Internal setting that affects inter component communications This is for IBM use only bcg alertQueue queue jms bcg queue alertQ JNDI...

Page 250: ...content types will not be base64 encoded Wbipackaging_version 1 1 0 and 1 1 This is used for building the Backend Integration XML packaging transport envelope Version 1 0 is for version 4 2 2 FP1 and...

Page 251: ...t value is TRUE bcg rosettanet mimeBoundaryValidate FALSE String Boolean value TRUE or FALSE If this value is set to TRUE structural validation of mime multipart Rosettanet message is performed Defaul...

Page 252: ...nd_poll_interval 10000 Integer RosettaNet engine polling interval in milliseconds bcg rne in_thread_count 2 Integer Number of threads used by the RosettaNet engine to process inbound documents bcg rne...

Page 253: ...c2 40 Encryption algorithm used for RosettaNet messages This Property is applicable to all protocols Table 68 Attributes used to configure JMS for the receiver component Entry Default value Possible s...

Page 254: ...butes used to configure the directory names used by the receiver component Entry Default value Possible setting Description bcg receiver configpath Hub install root common receiver config String with...

Page 255: ...nerate the event notification documents bcg sponsor work_size 10 Integer Number of rows per pass that are fetched from the database for generating the event notification documents Table 74 Attributes...

Page 256: ...cause all incoming ebXML messages to be validated Table 76 Attributes used to configure the reliable messaging subcomponent of the Document Manager Entry Default value Possible setting Description bc...

Page 257: ...Default value Possible setting Description bcg archive maxThreads 4 Integer Archiving of files is multithreaded and a new property bcg archive maxThreads is introduced in WebSphere Partner Gateway 6 2...

Page 258: ...252 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Page 259: ...poration Licensing 2 31 Roppongi 3 chome Minato ku Tokyo 106 0032 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with lo...

Page 260: ...shed announcements or other publicly available sources IBM has not tested those products and cannot confirm the accuracy of performance compatibility or any other claims related to non IBM products Qu...

Page 261: ...n is provided to help you debug your application software Attention Do not use this diagnosis modification and tuning information as a programming interface because it is subject to change Trademarks...

Page 262: ...re Partner Gateway Enterprise and Advanced Editions includes software developed by the Eclipse Project www eclipse org 256 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration...

Page 263: ...sabling 53 managing 49 viewing and editing 52 Changing connection configurations 57 destination status 88 partner attribute values 57 the source or target destination 58 ClassNotFoundException 167 Col...

Page 264: ...ns report 99 FTP Statistics report 99 FTPScripting 166 G Generating summary data 187 H Handlers configuring content type 26 deleting 26 importing 26 managing 25 Hub administrator tasks 19 configuring...

Page 265: ...94 400 series 94 500 series 95 Web Server 93 Retries destination 46 transport 46 RosettaNet Viewer description 107 document processing details 108 search criteria 107 searching for processes 107 viewi...

Page 266: ...ument Manager 179 StringIndexOutofBounds 166 tab headings 183 TCPC0003E 176 threads hanging 179 VCBaseException 178 WebSphere Application Server shortcut 182 Typographic conventions 2 U Updating maps...

Page 267: ......

Page 268: ...Printed in USA...