Deployment Wizard Reference
Whether you are creating a new deployment or modifying an existing one, use the information in this section to provide valid information for the parameters.
Provide Information about the Host
Except for the Instance Name, this section requires information from the BusinessConnect host that allows you to connect to their BusinessConnect deployment:
Parameter
|
Description
|
Instance Name
|
This can be any name you choose to identify this BusinessConnect Remote deployment. Consider it a small opportunity for creativity if you like.
|
Client Partner
|
The name used for your partner profile on the BusinessConnect host system. This is some form of your company name.
|
Protocol Standard
|
The types of documents you will exchange with your BusinessConnect host. These are the supported document types:
- Simple Documents document type that is not limited to an industry protocol standard. BusinessConnect host processes documents of this category without business logics according to the industry protocol standards. With this setting, BusinessConnect Remote software provides transport connectivity for secure document exchange with the BusinessConnect host.
- EDI ASC/X12 Documents EDI standard from American National Standards Institute (ANSI). The Accredited Standards Committee (ASC) develops and maintains the X12 standards.
- EDI UN/EDIFACT Documents UN/EDIFACT is the United Nations rules for Electronic Data Interchange for Administration, Commerce, and Transport. It is the international messaging standard for EDI. Organizations that choose to trade globally use the UN/EDIFACT standard.
- TRADACOMS Documents TRADACOMS is a UK based standard, designed for domestic trade. TRADACOMS first standard was release in 1982, a number of years before EDIFACT appeared.
|
Sever Host
|
The destination host name or IP address for the TIBCO BusinessConnect host server.
|
Server Type
|
HTTP or HTTPS.
|
Host Port
|
The port number for the TIBCO BusinessConnect host server.
|
Provide Security Credential Files
To conduct B2B ecommerce securely, both business partners must have valid and up-to-date (not expired) security credentials. This section describes the key parameters in the BusinessConnect Remote deployment wizard.
Copy your key files into the following directory:
bcremote_home
\keys
This is the default location:
C:\tibco\bcremote\5.0\keys
Provide the names and passwords for the files as described here
 |
You can use one key file for all of these purposes if you desire.
|
:
Parameter
|
Description
|
Signing Key File and Password
|
The file name of your key for signing the documents you send to the BusinessConnect host.
|
Decryption Key File and Password
|
The file name of your key for decrypting the documents you receive from the BusinessConnect host.
|
SSL Identity File and Password
|
The file name of your Private Key Identity for decrypting data on the incoming secure socket layer (SSL).
|
 |
All passwords are safely encrypted when you save the deployment configuration.
|
Configure Outbound Document Exchange
This information is stored as part of your partner profile in the BusinessConnect host system. If you set up your own partner profile using TIBCO BusinessConnect Partner Self Service, you may have already specified this information. Otherwise, the BusinessConnect host set these options for you. In either case, you can either click Next to leave the settings as they are or modify the current settings.
Parameter
|
Description
|
Sign
|
Check the checkbox if you want to digitally sign the documents you send to the BusinessConnect host.
If you check this checkbox, provide a signing key file as described in Provide Security Credential Files.
|
Encrypt
|
Check the checkbox if you want to encrypt the documents you send to the BusinessConnect host.
Each time you launch BusinessConnect Remote, the BusinessConnect Remote server downloads the latest host certificate necessary for encrypting the outbound documents.
|
Compress
|
Check the checkbox if you want to compress the documents you send to the BusinessConnect host.
|
Compress Order
|
If you checked both the Sign and the Compress checkboxes, specify whether you want to compress documents before or after signing. The default value is "After signing."
|
Receipt
|
If you want the BusinessConnect host to send a receipt to acknowledge your request to send a document, you can specify whether BusinessConnect should digitally sign the receipt. These are the options:
- None Do not send a receipt. This is the default.
- Sync Signed – Return a signed receipt when the packaged outbound message is processed.
- Sync Unsigned – Return an unsigned receipt when the packaged outbound message is processed.
|
Configure Outbound File Poller
The outbound file poller monitors the outbox folder for new documents. You can configure these aspects of the outbound file poller or click Next to leave the current settings as they are:
Parameter
|
Description
|
Polling Interval (seconds)
|
By default, the file poller checks for new files in the outbox folder every 60 seconds.
|
Delete on Transmission
|
Check the checkbox to instruct BusinessConnect Remote software to delete the document from the outbox folder after it successfully sends the document to the BusinessConnect host. The default is unchecked.
|
Socket Timeout (seconds)
|
As soon as BusinessConnect Remote software attempts to send a document to the BusinessConnect host, it begins waiting for a response from the BusinessConnect host. The value of this parameter determines how long BusinessConnect Remote software should wait for the response before timing out. The default is 120 seconds.
|
Max Thread Pool Size
|
BusinessConnect Remote software can work on multiple tasks related to outbound-document processing simultaneously. The value of this parameter determines how many outbound-document processing tasks BusinessConnect Remote software can work on at one time. The default is 5.
|
File pattern
|
By default, the file poller detects all files in the outbox. The pattern to detect all files is this: *.* . You can change the file pattern to detect some subset of the files. For example, this file pattern detects Microsoft Excel spreadsheets that begin with "po_": po_*.xls .
|
Configure Inbound Listener
The inbound listener detects documents arriving from the BusinessConnect host. You can configure these aspects of the inbound listener or click Next to leave the current settings as they are:
Parameter
|
Description
|
Listening Port Override
|
Information stored in the BusinessConnect host system includes the port number on which BusinessConnect Remote should listen for documents arriving from the host. You can override that port number by providing a different port number here.
|
Max Thread Pool Size
|
BusinessConnect Remote software can work on multiple tasks related to inbound-document processing simultaneously. The value of this parameter determines how many inbound-document processing tasks BusinessConnect Remote software can work on at one time. The default is 5.
|
Configure Document History
BusinessConnect Remote software stores the following information about both incoming and outgoing documents in the history folder:
The best way to view this information is through the BusinessConnect Remote console. BusinessConnect Remote periodically generates HTML reports of this information for archiving and periodically purges stale information from the history folder. After stale information is purged it is no longer available through the console but is available in the archived reports.
 |
The business documents themselves are stored in the sent folder not the history folder. Purging of the history folder has no impact on the documents in the sent folder.
|
You can specify how often BusinessConnect Remote software purges the information the history folder and how often it generates and archives the HTML reports. Click Next to accept the default values.
Parameter
|
Description
|
Auto Purge Document History
|
Select a value from the drop-down list to specify which information BusinessConnect Remote software will delete based on the age of the information. These are the options:
- More than 2 weeks old
- Older than 30 days
- Older than 60 days
- Older than 90 days
The default is Older than 30 days.
After BusinessConnect Remote software deletes the history information, the documents themselves are no longer accessible through the BusinessConnect Remote console. You can still access them from the sent folder, however, and you can still access document history through the document history reports. (See next.)
|
Auto Archive Document History
|
Select a value from the drop-down list to specify how frequently BusinessConnect Remote software archives information in the history file as HTML reports. These are the options:
The default is Daily.
BusinessConnect Remote software stores the reports here:
bcremote_home \reports
This is the default location:
C:\tibco\bcremote\5.0\reports
|
Configure the Server
These options affect the BusinessConnect Remote server. Click Next to accept the default values:
Parameter
|
Description
|
JVM Max Heap Size (MB)
|
The maximum heap size for the Java virtual machine in megabytes. The default is 512MB.
This parameter controls how efficiently BusinessConnect Remote software processes concurrent requests. If this parameter is set to a value that is too high, it wastes system resources. If it is too low, the system runs out of memory and exits abnormally.
|
Client Console Access Port
|
The listening port number for the console access to this deployment instance. When you launch the console and attempt to connect to the server, this port number appears in the connection dialog. The default value is ‘8881’
|
Password
|
You can set a password for the console here, but it is optional. If you set a password here, each time you launch the console, BusinessConnect Remote will require the password before connecting.
|
Save the Deployment Configuration
All the information you provided to the BusinessConnect Remote deployment wizard gets saved in a configuration file. The BusinessConnect Remote deployment wizard prompts you for a file name and location.
Name the file bcremote-
instanceName
.tra
.
Store the file here:
bcremote_home
\deployments
This is the default location:
C:\tibco\bcremote\5.0\deployments
TIBCO BusinessConnect™ Remote User’s Guide
Software Release 5.0,
July 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com
|