IBM E02HRLL-G - WebSphere Partner Gateway... Скачать руководство пользователя страница 24

Table 2. Community Console Icons (continued)

Icon

Icon name

Where used

Logging off from 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

IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide

Содержание E02HRLL-G - WebSphere Partner Gateway...

Страница 1: ...WebSphere IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide Version 6 2...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 20: ...14 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 66: ...60 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 71: ...nt Admin Partner Destinations Manage Transport Types DestinationTypeInfo Account Admin Partner Destinations create destination Operation Mode is represented by DestinationTypeInfo HandlerInfo Hub Admi...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 80: ...74 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 86: ...80 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 90: ...84 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 134: ...128 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 154: ...148 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 194: ...188 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 228: ...222 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 230: ...RoleClassificationCode 0 To partner Role toRole 0 PartnerRoleDescription 0 PartnerDescription 0 BusinessDescription 0 GlobalBusinessIdentifier 0 To partner Business ID toRole 0 PartnerRoleDescription...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 258: ...252 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 267: ......

Страница 268: ...Printed in USA...

Отзывы: