Deploying to webMethods Cloud Container
No subtopics in thissection
Cloud deployment is the process of deploying user-created packages and configurations that reside within on-premise runtimes or repositories to webMethods Cloud Container. Using Software AG Designer you can seamlessly deploy your on-premise Integration Server packages and configuration assets to solutions present on webMethods Cloud Container.
Note: In the webMethods Cloud Container context, configuration assets are limited to Integration Server and Universal Messaging configurations.
Note: During the deployment of Integration Server or Universal Messaging assets and configurations, the latest version of assets and configurations stored in Git repository will take precedence. In order to retain the older assets and configurations, you must select those assets and configurations during deployment. Additionally, assets and configurations that have already been deployed are automatically selected by default for subsequent deployments. However, this guidance does not apply to packages.
Software AG Designer allows you to deploy the Integration Server packages or configuration assets that you have created, verified, and tested on on-premise Integration Server or Universal Messaging to webMethods Cloud Container. When you initiate the deployment from Software AG Designer, Integration Server packages and configuration assets are built from Integration Server respectively, and are published to an asset repository present in Software AG Designer.
After performing variable substitutions to make the on-premises configuration data compatible for webMethods Cloud Container, you can publish the packages and configurations from the asset repository to a remote repository provisioned for the tenant on webMethods Cloud Container.
Platform Manager plug-ins for Integration Server and Universal Messaging continuously monitor the remote repository on webMethods Cloud Container. When a fresh deployment is detected, Platform Manager plug-ins deploy the Integration Server packages and configuration assets to respective runtime instances on webMethods Cloud Container.
The following figure provides a high-level basic overview of the process involved in deploying on-premises Integration Server packages and configuration assets to webMethods Cloud Container.
Installation Information
No subtopics in thissection
Install the following products into a different directory or on a different machine, using the Software AG Installer:
- webMethods Asset Build Environment
- Service Development in Software AG Designer with Local Version Control System Integration feature and webMethods Unit Test Framework.
- webMethods Integration Server with webMethods Unit Test Framework.
- Software AG Universal Messaging. All child nodes except Enablement for Cloud Foundry and webMethods Broker to UM Migration Utility.
If you want to use an external RDBMS for webMethods Integration Server, install webMethods Database Component Configurator on any machine on the same network as your database server, create the database components for webMethods Integration Server, and then connect webMethods Integration Server to the database components.
For detailed instructions, see the following document:
- Installing Software AG Products document.
- If you are using Software AG Installer to install, see the Using Software AG Installer document.
- If you are using Command Central to install, see the Software AG Command Central Help.
webMethods Cloud Container Approaches
No subtopics in thissection
Choose the following approaches to publish user-created packages and configurations to a solution created in webMethods Cloud Container. See the Creating Solution section in the webMethods Cloud Container help for information on how to create a solution in webMethods Cloud Container.
Using Software AG Designer
Package Navigator: Use the Package Navigator view in Software AG Designer to deploy webMethods Integration Server packages and configuration assets to webMethods Cloud Container.
Asset Repository: Use the Asset Repository view in the Service Development perspective of Software AG Designer to deploy webMethods Integration Server packages and configuration assets to webMethods Cloud Container.
Landscape Navigator(Deprecated): Use the Landscape Navigator view in the Service Development perspective of Software AG Designer to deploy customized configuration templates to webMethods Cloud Container. Export the configurations into a Software AG Designer configuration project and then build and deploy this project to webMethods Cloud Container. For continuous integration purposes, these projects can be stored in a Version Control System (VCS) location, built through webMethods Asset Build Environment, and then deployed to webMethods Cloud Container.
Note: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container.
Connecting to webMethods Cloud Container
Configuring a Connection to webMethods Cloud ContainerAdding a Connection ConfigurationEditing a Connection ConfigurationRemoving a Connection ConfigurationUsing Designer you can deploy your on-premises Integration Server packages and configuration assets to webMethods Cloud Container. Before deploying the packages and configuration assets, you must configure a connection to webMethods Cloud Container.
Before you configure a connection to webMethods Cloud Container, ensure that the following criteria are met:
- A valid URL exists to connect to webMethods Cloud Container.
- A valid user account is created on webMethods Cloud Container.
- The global variables (mycloud.username, and mycloud.password) that are set for webMethods.io B2B in Integration Server must be deployed to webMethods Cloud Container using Software AG Designer, either in stand-alone mode or along with the relevant packages.
Configuring a Connection to webMethods Cloud Container
You need to provide specific information in Designer for initiating a connection to webMethods Cloud Container. Designer saves this information in a connection configuration. You can add, edit, and update connection configurations in Designer.
Adding a Connection Configuration
Using Designer you can add connections to different instances of webMethods Cloud Container.
To add a connection configuration for webMethods Cloud Container
In Designer, select Window > Preferences.
In the preferences navigation tree, select Software AG > webMethods Cloud Container.
Click Add.
In the Add connection configuration dialog box, enter the following information:
Field Description Name The name to use for the webMethods Cloud Container connection configuration.
Note: The name cannot contain control characters, special characters, and characters outside of the basic ASCII character set, such as multi-byte characters.URL URL of the webMethods Cloud Container host to which Designer is to connect. For example, https://mysubdomain.container.webmethodscloud.com
User The user name for an account on webMethods Cloud Container. Password The password for the specified User. Save password (in the Eclipse secure storage) Indicates whether the password for the specified user account should be saved in Eclipse secure storage. webMethods Cloud Container uses this password from the Eclipse secure storage whenever user authorization is required. If you want to save the password in Eclipse secure storage, select this check box. If you decide not to save the password in Eclipse secure storage, you must specify your password each time your user authorization is required for connecting to webMethods Cloud Container. To verify whether webMethods Cloud Container can be accessed by using the specified information, click Test.
To store the connection configuration details, click OK. A connection configuration is added to the Connections page with the specified details. The first connection configuration that you create is automatically marked as default. This default configuration is indicated with a check mark on the Connections page. Designer always uses the default connection configuration for webMethods Cloud Container. If there are multiple connections configured, you can select the connection that you want to make it as default.
Editing a Connection Configuration
You can edit a connection configuration for webMethods Cloud Container if there are any changes in the configuration values.
To edit a connection configuration for webMethods Cloud Container
In Designer, select Window > Preferences.
In the preferences navigation tree, select Software AG > webMethods Cloud Container.
Click Edit.
Enter new values in the connection configuration fields you want to change.
In the Edit Connection Configuration dialog box, click OK.
In the Connections page, click OK.
Removing a Connection Configuration
You can remove connection configurations for webMethods Cloud Container one at a time from the Connections page.
To remove a connection configuration for webMethods Cloud Container
In Designer, select Window > Preferences
In the preferences navigation tree, select Software AG > webMethods Cloud Container.
Select the webMethods Cloud Container connection configuration you want to remove.
Click Remove. Designer prompts you to confirm that you want to remove the selected connection configuration.
Click OK.
Deployable Assets and Configurations
Deployable assets and configurations for webMethods Integration ServerJSON Document Type PropertiesDeployable assets and configurations for webMethods CloudStreamsDeployable configurations for Software AG Universal MessagingWorking with Trading Networks Built-In Services on webMethods Cloud Containerwm.tn: submitWithAttachmentsWorking with EDI and EDIINT Built-In Services on webMethods Cloud Containerwm.b2b.editn:recordToBizDocwm.EDIINT.doc:getDocFromMDNwm.EDIINT.doc:relatePayloadwm.EDIINT.doc:getRelatedDocwm.EDIINT.util:decodeAS2IDwm.EDIINT.util:isLastMDNSuccesswm.EDIINT.util:parseURIwm.EDIINT.rules:setProcessInfowm.EDIINT.util:CRLFwm.EDIINT.util:checkJSSEConfigwm.EDIINT.util:getProcessPayloadIfMDNNotSentDeployable assets and configurations for webMethods Integration Server
Configuration/Asset Type | Asset/Configuration |
---|---|
ACLs | Configuration |
Groups | Configuration |
Consumer Web service endpoint alias | Configuration |
Extended Settings * | Configuration |
Global Variables | Configuration |
JMS aliases | Configuration |
JNDI aliases | Configuration |
Keystores | Configuration |
Provider Web service endpoint alias | Configuration |
Resources Settings * | Configuration |
SMTP settings * | Configuration |
Truststores | Configuration |
Users | Configuration |
webMethods messaging | Configuration |
Flow Service | Asset |
Java Service | Asset |
Map Service | Asset |
OData Service | Asset |
Adapter Service | Asset |
.NET Service | Asset |
C Service | Asset |
Adapter Notification | Asset |
Document Type | Asset |
Flat File Dictionary | Asset |
Flat File Schema | Asset |
JMS Trigger | Asset |
REST API Descriptor | Asset |
REST Resource | Asset |
Schema | Asset |
Specification | Asset |
Web Service Descriptor | Asset |
webMethods Messaging Trigger | Asset |
XML Document Type | Asset |
XSLT Service | Asset |
JSON Document Type | Asset |
* Restart Required |
JSON Document Type Properties
You can view the JSON document type properties from the JSON schema section of the properties view. When you deploy a JSON document type from Integration Server, the constraints applied to the elements and attributes are preserved as part of the validation under the JSON schema section.
Property | Description |
---|---|
Schema | Displays the version of the JSON Schema standard to which the schema conforms. |
ID | Displays a URI for the schema, and the base URI that other URI references within the schema are resolved against. |
Title | A title for a JSON document type or field represented by the JSON schema. |
Description | Description of a JSON document type or field. |
Read only | This property corresponds to the readOnly JSON schema annotation. It indicates if the value (of the selected field or document) is managed by Integration Server. |
Write only | This property corresponds to the writeOnly JSON schema annotation. It determines if the selected field or document is retrieved from Integration Server. |
Validations | Specifies the requirements for successful validation of JSON schema. Validation keywords differ based on the data type used in the JSON schema. |
Deployable assets and configurations for webMethods CloudStreams
Note: You cannot deploy the webMethods CloudStreams runtime assets such as database that you have created, verified, and tested to webMethods Cloud Container.
Configuration/Asset Type | Asset/Configuration |
---|---|
CloudStreams Connector Services | Asset |
CloudStreams Connection | Asset |
OAuth token | Asset |
Streaming | Asset |
CloudStreams Provider Packages | Asset |
Subscriber | Asset |
* Restart Required |
Deployable configurations for Software AG Universal Messaging
Configuration Type | Asset/Configuration |
---|---|
Channels | Transient |
Simple | |
Reliable | |
Persistent | |
Mixed | |
Off-Heap | |
Paged | |
JNDI Connection Factories | Connection Factory>Shared Durable Type |
TopicConnection Factory>Shared Durable Type | |
Queue Connection Factory | |
XA Connection Factory | |
JNDI Destinations | Topic |
Queue | |
Queues | |
Simple | |
Reliable | |
Persistent | |
Mixed | |
Off-Heap | |
Paged | |
* Restart Required |
Working with Trading Networks Built-In Services on webMethods Cloud Container
webMethods Cloud Container supports the following Trading Networks services. For complete details of service parameters of each of these Trading Networks services, see webMethods Trading Networks Built-In Services Reference.
Trading Networks Folder Name | Supported Trading Networks Services |
---|---|
dictionary | wm.tn.dictionary:getContactTypes |
wm.tn.dictionary:getFieldDefinitions | |
wm.tn.dictionary:getFieldGroups | |
wm.tn.dictionary:getIDTypes | |
doc | wm.tn.doc.xml:bizdocToRecord |
wm.tn.doc.xml:recordToBizdoc | |
wm.tn.doc:changeStatus | |
wm.tn.doc:createNewEnvelope | |
wm.tn.doc:getContentPart | |
wm.tn.doc:getDeliveryContent | |
wm.tn.doc:getEvents | |
wm.tn.doc:getSenderReceiver | |
wm.tn.doc:persist | |
wm.tn.doc:relateDocuments | |
wm.tn.doc:resubmit | |
wm.tn.doc:resubmits | |
wm.tn.doc:setAttribute | |
wm.tn.doc:sign | |
wm.tn.doc:updateAttributes | |
wm.tn.doc:updateComments | |
wm.tn.doc:updateSystemAttributes | |
wm.tn.doc:verify | |
wm.tn.doc:view | |
wm.tn.doc:viewAll | |
wm.tn.doc:viewAs | |
docattr | wm.tn.docattr:list |
wm.tn.docattr:listTypesForAttribute | |
doctype | wm.tn.doctype:list |
wm.tn.doctype:view | |
log | wm.tn:log |
profile | wm.tn.profile:getExtendedFields |
wm.tn.profile:getExternalID | |
wm.tn.profile:getExternalIDs | |
wm.tn.profile:getHostProfile | |
wm.tn.profile:getInternalID | |
wm.tn.profile:getInternalIDsForUser | |
wm.tn.profile:getProfile | |
wm.tn.profile:getProfileMappings | |
wm.tn.profile:getProfileSummaries | |
wm.tn.profile:getProfileSummary | |
wm.tn.profile:getUserProfiles | |
wm.tn.profile:getUserProfilesSummaries | |
wm.tn.profile:getUsersForPartner | |
queuing | wm.tn.queuing:getQueuedTask |
wm.tn.queuing:getRegisteredQueues | |
wm.tn.queuing:listQueuedTasks | |
wm.tn.queuing:queueDocument | |
wm.tn.queuing:updateQueuedTask | |
rec | wm.tn.rec:ActivityLogEntry |
wm.tn.rec:Address | |
wm.tn.rec:BizDocAttribute | |
wm.tn.rec:BizDocContentPart | |
wm.tn.rec:BizDocContentPartCriteria | |
wm.tn.rec:BizDocEnvelope | |
wm.tn.rec:BizDocErrorSet | |
wm.tn.rec:BizDocType | |
wm.tn.rec:BizDocTypeSummary | |
wm.tn.rec:Contact | |
wm.tn.rec:Corporation | |
wm.tn.rec:Delivery | |
wm.tn.rec:DeliveryServiceOutput | |
wm.tn.rec:ExternalID | |
wm.tn.rec:Field | |
wm.tn.rec:FieldMetaData | |
wm.tn.rec:PreProcessingFlags | |
wm.tn.rec:ProcessingService | |
wm.tn.rec:Profile | |
wm.tn.rec:ProfileSummary | |
wm.tn.rec:ReliableProcessingService | |
wm.tn.rec:ReliableServiceOutput | |
wm.tn.rec:Task | |
wm.tn.rec:TPA | |
wm.tn.rec:TpaError | |
reroute | wm.tn:reroute |
route | wm.tn.route:containsRuleName |
wm.tn.route:getAnyTask | |
wm.tn.route:getFirstMatch | |
wm.tn.route:getLastChangeID | |
wm.tn.route:getRule | |
wm.tn.route:list | |
wm.tn.route:load | |
wm.tn.route:mergeFlags | |
wm.tn.route:preroute | |
wm.tn.route:route | |
wm.tn.route:routeBizdoc | |
security | wm.tn.security:getSSLKeyAndChain |
submit | wm.tn:submit |
task | wm.tn.task:getAnyTask |
wm.tn.task:getTaskStatus | |
wm.tn.task:removeTask | |
wm.tn.task:restartTask | |
wm.tn.task:stopTask | |
tpa | wm.tn.tpa:getTPA |
util | wm.tn.util:longToSqlTimestamp |
wm.tn.util:stringListToDateList | |
wm.tn.util:stringListToDoubleList | |
wm.tn.util:stringToDate | |
wm.tn.util:stringToDouble |
The details of the service are listed as follows:
Folder Name | Supported Services |
---|---|
submit | wm.tn: submitWithAttachments |
wm.tn: submitWithAttachments
Submits the document along with headers and attachments to webMethods.io B2B.
Input Parameters
data | Document - Contains the input data to submit to webMethods.io B2B | |
Parameter | Description | |
contentType | String Content type of the data that is submitted. | |
inputContent | Object Content that is submitted. | |
readContentAs | String Format of the inputContent. Valid values are: - bytes inputContent is of byte array format. - string inputContent is of String format. |
|
encoding | String (Optional) Character set in which the document is encoded. | |
TN_parms | Document (Optional) An Integration Server document (IData object) that you can use to provide parameters that govern how webMethods.io B2B recognizes and processes a document. | |
attachments headers | Document (Optional) Headers you can include on your inputContent. | |
Document List (Optional) Attachments to send along with inputContent. | ||
Parameter | Description | |
Name | String Content part name of the attachment. | |
contentType | StringContent type of the attachment data that is submitted. | |
inputContent | Object Content to be submitted. | |
readContentAs | String Format of the inputContent. Valid values are: - bytes inputContent is of byte array format. - string inputContent is of String format. |
|
encoding | String (Optional) Character set in which the document is encoded. | |
otherHeaders | Document (Optional) headers you can include on your attachment content. |
Output Parameters
bizdoc | Document(Optional) The document that webMethods.io B2B receives (the content passed in the ‘data’ input) which is formatted as an Integration Server document (IData object). For the structure of bizdoc, see wm.tn.rec:BizDocEnvelope service in webMethods Trading Networks Built-In Services Reference. |
Working with EDI and EDIINT Built-In Services on webMethods Cloud Container
webmethods Cloud Container supports the following EDI and EDIINT services.
For complete details of service parameters of each of these EDI services, see webMethods Module for EDI Built-In Services Reference .
webMethods Cloud Container Package | Supported Services | Description |
---|---|---|
WmEDIforTNStub | wm.b2b.editn:bizdocToRecord | Returns an webMethods Integration Server document that represents the EDI document based on the input BizDocEnvelope. |
wm.b2b.editn:ediPartnerIDToTNPartnerID | Retrieves the webMethods Trading Networks internal ID of the partner. | |
wm.b2b.edi:generateX12TA1 | Generates an outbound functional acknowledgment (TA1) for an X12 interchange envelope. | |
wm.b2b.editn:getICDetail | Accepts EDI data containing multiple EDI envelopes and extracts Interchange and Group header information from each of the envelopes. | |
wm.b2b.editn:getTransactionSetDetail | Converts a TransactionInfoSet object to a transaction record. | |
wm.b2b.editn:trackEDIdocs | Scans the input EDI data to add the interchange/group to the EDITRACKING table, which is a module-specific table in the Trading Networks database. | |
wm.b2b.editn:validateEnvelope | Validates the EDI envelope and adds entries to the Trading Networks activity log for the validation errors encountered in the EDI envelope. | |
wm.b2b.editn:validateTransaction | Validates the EDI document and adds entries to the Trading Networks activity log for the validation errors encountered in the EDI document. | |
wm.b2b.editn:wrapData | Inserts a character string at a fixed length position to form fixed length data. This service is used to create wrap data to send to a mainframe system. | |
wm.b2b.editn.crossRef:getEnvInfo | Obtains interchange sender/receiver pair information from the EDIEnvelope table, which is a module-specific table in the Trading Networks database. | |
wm.b2b.editn.doc:listTransactionTypes | Returns a list of all Trading Networks document types for EDI transaction sets that exist on the server as well as the instance ID query associated with that Trading Networks document type, if one exists. | |
wm.b2b.edi.eancom:generateAUTACK | Generate an AUTACK message manually. | |
wm.b2b.edi.eancom:processAUTACK | To process an AUTACK message manually. | |
wm.b2b.editn.TPA:getEDITPAData | Retrieves the EDITPA data for a specified sender and receiver. | |
wm.b2b.edi.tradacoms.doc:getContentPart | Returns a Trading Networks bizDocEnvelope content part object that represents the requested content part. | |
wm.b2b.edi.tradacoms.doc:getDocumentPartInfo | Returns information about the detail messages in a TRADACOMS file that is contained in a Trading Networks bizDocEnvelope. | |
wm.b2b.edi.tradacoms.doc:getFFSchemaNames | Returns the names of the flat file schemas that can be used to parse the parts of a TRADACOMS file. | |
wm.b2b.edi.tradacoms.doc:isFileEnvelope | Determines whether a BizDocEnvelope contains a TRADACOMS file document. | |
wm.b2b.editn.util.reprocess:listInSequenceDoc | Retrieves a list of EDI documents that contained out-of-sequence control numbers when they were originally received, but now the control numbers are in sequence due to the arrival of other EDI documents. | |
wm.b2b.editn.util.reprocess:listUnprocessDoc | Retrieves a list of EDI documents that were not processed due to a validation error. | |
wm.b2b.editn.util.reprocess:nextInSequenceDoc | Determines whether another EDI document with an out-of-sequence control number exists and can be processed because the specified document has been processed. | |
wm.b2b.editn.batch:getControlNumber | Gets the current control number from the EDIControlNumber table, which is a module-specific table in the Trading Networks database that Module for EDI uses to manage control numbers. | |
wm.b2b.editn.util.reprocess:validateControlNumber | Determines whether the specified control number is the one expected for the specified sender/receiver pair. |
The details for the below services are listed as follows:
webMethods Cloud Container Package | Supported Services | Description |
---|---|---|
WmEDIforTNStub | wm.b2b.editn:recordToBizDoc | Converts Integration Serverdocument to wm.tn.rec: BizDocEnvelope. |
WmEDIINTStub | wm.EDIINT.doc:getDocFromMDN | Retrives the internal ID of the original EDIINT document when the internal ID of the MDN is given. |
wm.EDIINT.doc:relatePayload | Relates two business documents. | |
wm.EDIINT.doc:getRelatedDoc | Retrieves the related document based on the inputs you specify. |
wm.b2b.editn:recordToBizDoc
Converts Integration Server document to wm.tn.rec: BizDocEnvelope.
Input Parameters
boundNode | Document Integration Server document containing EDI message. |
EDIFFSName | String The fully-qualified flat file schema name that represents the corresponding EDI document. |
Segment_terminator | String (Optional) The segment terminator character that the service append to the end of each record. |
Field_separator | String (Optional) The field separator that the service insert between each field for each segment. |
encoding | String (Optional) Character set in which the document is encoded. |
Output Parameters
bizdoc | Document(Optional) The document that webMethods.io B2B receive (the content passed in the ‘data’ input) formatted as an Integration Server document (IData object). For the structure of bizdoc, see wm.tn.rec:BizDocEnvelope. |
wm.EDIINT.doc:getDocFromMDN
Retrives the internal ID of the original EDIINT document when the internal ID of the MDN is given.
Input Parameters
MDNDocInternalld | String .Internal ID of the MDN. |
Output Parameters
EDIINTDocInternalld | String. Internal ID of the EDIINT document. |
wm.EDIINT.doc:relatePayload
Relates two business documents.
Input Parameters
bizdoc | Object. The document must be an instance of com.wm.app.tn.doc.BizDocEnvelope . |
payloadBizdoc | Object. The document must be an instance of com.wm.app.tn.doc.BizDocEnvelope . |
envelopeDocuments | Document. List EDI envelope documents. |
payloadType | String Type of payload. For relating EDI documents, the value should be EDI. |
persistMultipleDocEnvelope | String. It is used only when payloadType value is ‘EDI’. Valid values are: - true. Relate bizdoc and payloadbizdoc. - false. Do not relate bizdoc and payloadbizdoc. |
Output Parameters
EDIINTDocInternalID | String - Internal ID of the EDIINT document. |
wm.EDIINT.doc:getRelatedDoc
Retrieves the related document for the given inputs.
Input Parameters
documentId | String. Message-ID of the document. |
userStatusStartWith | String. User status of the related document that needs to be retrieved. |
relationship | String. (Optional) Type of relationship. |
Output Parameters
bizdoc | Object (Optional) The document must be an instance of com.wm.app.tn.doc.BizDocEnvelope. |
hasRelationship | Object - Indicates whether there exists a document for the given inputs. Valid values are: - true. If there is a related document for the given inputs. - false. If there is no related document for the given inputs. |
wm.EDIINT.util:decodeAS2ID
Decodes the input AS2 identifier by performing the following four operations:
- Remove trailing spaces
- Remove quotes
- Remove escape characters
- Validate the final updated AS2 identifier
Input Parameters
id | String AS2 Identifier that requires decoding. |
Output Parameters
newId | String Decoded AS2 Identifier. |
wm.EDIINT.util:isLastMDNSuccess
Verifies if the input EDIINT document has received a successful MDN.
Input Parameters
originalbizdoc | Object EDIINT document. |
Output Parameters
lastMDNSuccess | String Indicates whether the input EDIINT document has received a successful MDN back. - true. If EDIINT document has received a successful MDN. - false. If EDIINT document has not received any successful MDN. |
wm.EDIINT.util:parseURI
Creates a URL by parsing, validating, and extracting URI elements from the input ‘URIString’.
Input Parameters
URIString | String URI from which the URI elements are extracted. |
Output Parameters
protocol | String Protocol extracted from the URI. |
user | String Username extracted and decoded from the URI. |
pass | String Password extracted and decoded from the URI. |
host | String Hostname extracted from the URI. |
port | String Integer port extracted from the URI. |
path | String Path extracted from the URI. |
URL | String URL created from all the extracted URI elements. |
wm.EDIINT.rules:setProcessInfo
Changes user status and sets the message for specific transaction based on the bizdoc object.
Input Parameters
thebizdoc | Object. The document must be an instance of com.wm.app.tn.doc.BizDocEnvelope |
newstatus | Picklist Valid options are: IGNORED , WARNING , ERROR, DONE, WAITMDN, SENDINGMDN, PAYLOAD |
briefmessage | String Message will display in activity log. |
fullmessage | String Complete message to display in activity log. |
entryType | String Types of messages are: error, message and warning. |
relatedDocId | String Document id of related document. |
relatedConversationId | String Conversation id of related document. |
wm.EDIINT.util:CRLF
Generates an output carriage return and line feed.
Input Parameters
CRLF | String Variable contains “\r\n” |
wm.EDIINT.util:checkJSSEConfig
Returns Integration Server property value of useJSSE.
Output Parameters
useJSSE | StringValid values are: - true. Indicates JSSE is used. - false. Indicates JSSE is not used. |
wm.EDIINT.util:getProcessPayloadIfMDNNotSent
Returns value of EDIINT property wm.EDIINT.processPayloadIfMDNNotSent.
Output Parameters
processPayload | StringValid values are: - true. Indicates payload will be processed. - false. Indicates payload will not be processed. |
Deploying Packages and Configuration Assets to webMethods Cloud Container
Checking the Deployment StatusUsing Software AG Designer, you can deploy Integration Server packages and configuration assets to webMethods Cloud Container.
Before deploying packages and configuration assets to webMethods Cloud Container, ensure the following:
- Designer is configured to connect to webMethods Cloud Container using the webMethods Cloud preference page. For information on configuring a connection to webMethods Cloud Container, see the Connecting to webMethods Cloud Container section.
- Software AG Designer is configured to connect to Command Central. Use the Landscape Navigator view to connect to Command Central. For more information on the Landscape Navigator view and connecting to Command Central, see Using Landscape Navigator to View Runtime Configurations.
- Command Central is connected to Integration Server and Universal Messaging instances.
Note: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container. - If you want to deploy Integration Server packages and configurations or Universal Messaging configurations to webMethods Cloud Container, configure Designer to connect to Integration Server or Universal Messaging
To deploy assets to webMethods Cloud Container
Note: The following procedure explains how to deploy packages and configuration assets only to webMethods Cloud Container. If you want to deploy, refresh,or remove the packages and configuration assets from webMethods Cloud Container, use the Asset Repository view in Software AG Designer.
In the Package Navigator view, select the Integration Server package that you want to deploy to webMethods Cloud Container.
Right-click the package and click Deploy to Cloud.
In the Publish Assets to Cloud dialog box, select the package to deploy. You can select multiple packages. If you want to publish the configuration assets along with the selected Integration Server package, select Include runtime configurations, click Next, and go to step 4. Otherwise, click Next and go to step 5. Designer fetches the configuration data from Command Central.
In the Confirm selected configurations dialog box, select the configuration that you want to deploy and clickNext.
In the Integration Server package variable substitution dialog box, select the package and edit the value of the property that you want to modify before deploying to cloud. Click Next.
In the Select Cloud Solution dialog box, select the solution on webMethods Cloud Container to which you want to deploy the assets and click Finish. Designer deploys the assets and configurations to a remote repository provisioned for the tenant on webMethods Cloud Container.
Checking the Deployment Status
After you deploy the assets to the webMethods Cloud Container, you can check the deployment status.
To check the deployment status
In the Service Development perspective of Software AG Designer, select Window > Show View > Other.
In the Show View dialog box, select Software AG Service Development>Deployment Status.
Click Open. Software AG Designer displays the Deployment Status view with the current deployment status of the assets.
Deploying Adapter for webSphereMQ Assets
No subtopics in thissection
To deploy webMethods MQ Adapter related driver jars to webMethods Cloud Container, you can select the core MQ adapter package WmMQAdapter from Software AG Designer, which will deploy the contents only from <webM\_Home\>\\Integration Server\\instances\\<instance\_Name\>\\packages\\WmMQAdapter\\code\\jars
folders.
To enable the assets such as Adapter Connections, Listeners and Listener Notifications on webMethods Cloud Container, ensure that you set the State After Deployment value to enable during deployment from Software AG Designer. The state of the assets must be disabled in on-premises before deploying to webMethods Cloud Container to ensure that the on-premises Integration Server messages from IBM WebSphereMQ server are not processed. To deploy webMethods MQ Adapter and asset packages to webMethods Cloud Container, see Deploying Packages and Configuration Assets to webMethods Cloud Container.
Notes:
- To connect to an on-premises IBM WebSphereMQ server using VPN, you must substitute the serverName to IP address of the server, as the hostname of the server cannot be resolved.
- Keep all driver jars in
<webM\_Home\>\\Integration Server\\instances\\<instance\_Name\>\\packages\\ WmMQAdapter\\code\\jars\\static
folder and then deploy to webMethods Cloud Container. - Set the proper package dependency between adapter asset packages and the core Adapter package.
Limitations:
Two way SSL connections are not supported.
Deploying Adapter for JDBC Assets
No subtopics in thissection
To deploy Adapter for JDBC related driver jars and TypeMapping configurations to webMethods Cloud Container solutions, you can select the core JDBC adapter package WmJDBCAdapter from Software AG Designer, which will deploy the contents only from <webM\_Home\>\\Integration Server\\instances\\<instance\_Name\>\\packages\\WmJDBCAdapter\\code\\jars
and <webM\_Home\>\\Integration Server\\instances\\<instance\_Name\>\\packages\\WmJDBCAdapter\\config
folders.
To enable the assets such as Adapter Connections and Polling Notifications on webMethods Cloud Container, ensure that you set the State After Deployment value to enable during deployment from Software AG Designer. The state of the assets such as Adapter Connections and Polling Notifications must be disabled from on-premises before deploying to webMethods Cloud Container to ensure that the on-premises Integration Server records are not processed. To deploy Adapter for JDBC and asset packages to webMethods Cloud Container, see Deploying Packages and Configuration Assets to webMethods Cloud Container.
Notes:
- To connect to an on-premises database using VPN, you must substitute the serverName to IP address of the server, as the hostname of the server cannot be resolved.
- Keep all driver jars in
<webM\_Home\>\\Integration Server\\instances\\<instance\_Name\>\\packages\\WmJDBCAdapter\\code\\jars\\static
folder and then deploy to webMethods Cloud Container. - Set the proper package dependency between adapter assets packages and the core Adapter package.
Limitations
- You can use only Type 4 JDBC drivers for webMethods Cloud Container.
- Kerberos authentication is not supported.
- Two way SSL connections are not supported.
Debugging Services in webMethods Cloud Container
How do I debug Integration Server(s) Services for webMethods Cloud Container?webMethods Cloud Container allows you to connect your on-premise Software AG Designer to the Integration Server(s) running in a container as part of solution landscape.
How do I debug Integration Server(s) Services for webMethods Cloud Container?
You can debug Integration Server services using Cloud Service Development perspective in Designer. The experience is similar to the way you debug services using Designer.
To debug the services in webMethods Cloud Container
Open the Cloud Service Development perspective in Designer and configure a connection to webMethods Cloud Container.
The default configuration is indicated with a check mark on the connections page. Designer always uses the default connection configuration for webMethods Cloud Container. If there are multiple connections configured, you can select the connection that you want to make it as default.
View the tenant details in the Cloud Explorer view and connect to the webMethods Cloud Container server. The Cloud Explorer view displays the contents of the webMethods Cloud Container to which Designer is currently connected. Click Connect to Server to log in. Designer will list all active solutions available for that selected tenant. Further, the solution displays all the packages available for the selected Integration Server in webMethods Cloud Container.
The following image displays a side-by-side comparison of two services.
Execute the services in webMethods Cloud Container using Designer. In Designer you can select services and execute them by clicking Run > Debug As > Debug Configurations.
Asset Repository
No subtopics in thissection
Asset Repository is a binary repository that provides components for managing user assets . Asset Repository enables the process of repository-based deployment, in which runtime servers pull assets from a repository. You can build Integration Server packages and configuration assets and add to the repository making the assets available for deployment to webMethods Cloud Container. Asset Repository is installed along with Software AG Designer using the Software AG Installer.
The Asset Repository view in Software AG Designer allows you to build, deploy, refresh, remove, or retract the assets.
Opening the Asset Repository View
No subtopics in thissection
To open the Asset Repository view
In the Service Development perspective of Designer, select Window > Show View > Other.
In the Show View dialog box, select Software AG Service Development>Asset Repository.
Click OK.
Building Packages and Assets in Asset Repository View
No subtopics in thissection
If the Asset Repository view does not already display the list of Integration Server packages and configuration assets, you can build them.
To build packages and configuration assets
In Asset Repository view, click the View Menu button .
Select Build.
The Asset Repository view displays all the newly created Integration Server packages and configuration assets.
Deploying Packages and Assets from Asset Repository View
No subtopics in thissection
You can deploy Integration Server package or configuration assets using the Asset Repository view.
To deploy packages and configuration assets from Asset Repository View
In Asset Repository view, select the Integration Server package or configuration assets that you want to deploy to webMethods Cloud Container.
Right-click the package and click Deploy to Cloud.
In the Publish Assets to Cloud dialog box, select the package to deploy. If you want to publish the configuration assets along with the selected Integration Server package, select Include runtime configurations, click Next, and go to step 4. Otherwise, click Next and go to step 5.
In the Confirm selected configurations dialog box, select the configuration that you want to deploy and clickNext. Designer fetches the configuration data from Software AG Command Central.
In the Integration Server package variable substitution dialog box, select the package and edit the value of the property that you want modify before deploying to cloud. Click Next.
In the Select Cloud Solution dialog box, select the solution on webMethods Cloud Container to which you want to deploy the assets and click Finish. Software AG Designer deploys the assets and configurations to a remote repository provisioned for the tenant on webMethods Cloud Container.
Retracting Packages and Assets
No subtopics in thissection
Using Designer you can retract Integration Server packages, configuration assets, or both from webMethods Cloud Container.
To retract packages and configuration assets
In Asset Repository view, select the Integration Server package or configuration assets that you want to retract.
Right-click and select Retract. Designer retracts the packages and configuration assets from webMethods Cloud Container.
Deleting Packages and Assets
No subtopics in thissection
You can delete Integration Server packages or configuration assets from the Asset Repository view and from webMethods Cloud Container. You can do this to remove packages and configuration assets with incorrect variable substitution or remove old versions of them from webMethods Cloud Container.
To delete packages and configuration assets
In Asset Repository view, select the Integration Server package or configuration assets that you want to delete.
Right-click and select Remove. Software AG Designer removes the Integration Server packages or configuration assets from the Asset Repository view and webMethods Cloud Container.
Deploying Command Central Assets to webMethods Cloud Container (Deprecated)
No subtopics in thissection
Command Central can export configuration properties for Software AG run-time components as YAML templates. Configuration properties are exported as Command Central composite assets using Software AG Designer, stored in the Landscape Asset Repository, and deployed to product instances, running on webMethods Cloud Container.
Note: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container.
For information about the Software AG products you need to install for webMethods Cloud Container, see the Deploying to webMethods Cloud Container section.
To create Command Central assets and deploy them to webMethods Cloud Container, in Designer:
Connect to Command Central.
Select and export the configurations to be deployed.
Edit the YAML configurations.
Deploy the assets to webMethods Cloud Container.
For more information about deploying assets, see the Deploying to webMethods Cloud Container section.
Using Landscape Navigator to View Runtime Configurations (Deprecated)
No subtopics in thissection
Note: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container.
Using Landscape Navigator view, you can connect to Command Central and view the list of registered installations and runtime instances. For more information about connecting to Command Central, see the Creating Command Central Definitions section.
What Does the Landscape Navigator View Contain? (Deprecated)
Creating a Command Central DefinitionEditing a Command Central DefinitionDeleting a Command Central DefinitionNote: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container.
You use Landscape Navigator view and Configuration Browser views to display the list of installations that are registered in Command Central. The available run-time instances are listed in the view for each installation and these available run-time instances are available for deploy to webMethods Cloud Container.
Landscape Navigator view provides an option to connect to a local or remote Command Central server. To view the contents of installations that are registered in Command Central, you must configure a connection to Command Central and then establish a connection.
You can find Landscape Navigator and Configuration Browser views under the Windows > Show View > Other > Software AG Command Central.
Command Central definitions create the connection between Designer and Command Central. The definition for a server contains the connection information needed to establish a connection with the Command Central server.
Creating a Command Central Definition
On the Landscape Navigator toolbar, click .
In the New Command Central Connection dialog box, enter the details for connecting to the Command Central server as described in following table:
Field Description Connection name The connection name. Command Central Location Choose one of the following options to specify the location:
- URL: The URL for Command Central connection. For example,https://[Command_Central_host]:[Command_Central_port]/cce
- Installation Directory: The local Software AG product installation directory where Command Central is installed.Under Authentication, enter the details as described in the following table:
Field Description Username Username to use for authentication on the Command Central. Password The password to use for authentication on the Command Central. Connection timeout (s): The maximum seconds Designer waits for response from Command Central. Click Save password. Designer stores the password in Eclipse secure storage location.
Click Test Connection to ping the Command Central server and to verify that the connection is working.
Click Finish. Designer refreshes the Landscape Navigator view and displays the new connection.
Editing a Command Central Definition
If there are changes in the associated Command Central server that require you to update the server definition, edit the Command Central connection properties. For example, to add or edit the username and password, you must edit the Command Central Connection page to reflect that change.
To edit a Command Central definition
Open the Landscape Navigator view.
Select the connection you want to edit.
Right-click the connection and select Edit Command Central Connection.
Edit the connection properties as needed.
Deleting a Command Central Definition
To delete a Command Central definition
Open the Landscape Navigator view.
Select the connection that you want to delete.
Right-click the connection and select Delete Command Central Connection.
Click Yes to confirm the deletion from the view.
Designer offers a detailed view of run-time specific configuration in Configuration Browser view. Designer retrieves information about a specific run-time component selected in Landscape Navigator.
The following table describes the runtime component information that is displayed in the Configuration Browser view.
Name | Description |
---|---|
Name | Display name of the configuration instance. |
Id | Id of the runtime instance. |
Product | Product to which the runtime instance belongs. |
Category | Configuration category to which the runtime instance belongs. |
Deployable | Whether or not the asset is deployable to webMethods Cloud Container. |
Description | Description of the configuration instance. |
Browsing Runtime Instances and Configurations (Deprecated)
No subtopics in thissection
Note: Command Central usage for Integration Server and Universal Messaging configuration deployment is deprecated. It is recommended to use the Integration Server or Universal messaging to deploy assets and configurations to webMethods Cloud Container.
After you connect to Command Central, you can use the Landscape Navigator view to browse the registered installations, for available runtimes and corresponding configurations.
When you expand an installation node, you can view the list of the runtime instances in that installation. You can also view the name and the runtime status as ONLINE, UNKNOWN, FAILED, OFFLINE, and so on. Upon expanding the runtime instances, the list of configurations are displayed. You can view the configuration data for each configuration instance in the Properties view, under the Data tab.
Deploying Customized Configuration to webMethods Cloud Container (Deprecated)
No subtopics in thissection
Using Designer you can deploy customized configuration templates to webMethods Cloud Container. You can use Landscape Navigator view to export the configuration into a Designer configuration project. Designer can be used to build and deploy this project to webMethods Cloud Container. For continuous integration purpose, these projects can be stored in Version Control System location and built through Asset Build Environment and deployed to webMethods Cloud Container.
The following figure depicts the processes involved in exporting deployable configurations.
You can export one or more runtime configurations to a YAML template file or as a deployable asset. You can export only deployable configurations. Deployable configurations are those configurations that can be deployed to webMethods Cloud Container. Configuration Browser view lets you identify these deployable configurations assets in the list with the icon.
You can export deployable configuration from a runtime instance as YAML template within a configuration project. For more information about configuration projects, see Using Configuration Project. This YAML template can be manually edited and build as deployable asset. Alternatively, you can export configurations as deployable asset, which can be readily deployed to cloud solutions.
To export a configuration
On the Landscape Navigator view , select one or more configurations from a runtime to export.
Right-click and select Export Configurations.
Under Location, provide the following information for the configuration project: Project: The project name for configuration project. You can assign a project in either of the following ways:
- Browse and select an existing configuration template project.
- Specify a new configuration project resource. For more information about creating a new project resource, see Using Configuration Project.
In theName field, select a template name. The template contains the data for the selected configurations.
Under Format, select any one of the following values: YAML source: To export configurations to YAML template. You can manually edit and build YAML template as a deployable asset. Deployable Asset : To export configurations that are readily deployable for cloud solutions.
In the Parameterization field, type the name of a parameter used to identify parameterization. An identifier can include lowercase a-z, uppercase A-Z, digits, dollar sign, and underscore. An identifier cannot start with a digit and cannot include any other special characters.
Click Next. By default, Designer displays deployable configurations that are included for export.
Select the configuration contents to confirm the set of configurations to export.
Click Finish. The exported YAML template file will open in an editor. You can view the exported contents using the Project Explorer view.
The configuration project is used for adding, editing, and building configuration templates exported from Integration Server and Universal Messaging runtimes. This project is pre-configured to build with Asset Build Environment which is used to prepare a deployable configuration asset from YAML source.
Before you configure a project, specify the build path entries to be used as the default path. For more information on specifying build path entries, see the Build Path Preferences page in Designer.
To create a configuration project
In Designer, navigate to File > New > Project > SoftwareAG.
Under SoftwareAG element, select Asset Builder and click Configuration template.
Click Next. Designer displays New Configuration Project dialog box.
In the Project name field, type the new name for the project.
Clear the Use default location check box, to choose a different location. By default Designer uses the Workspace root location. For example, c: \[username]\workspace.
Click Browse adjacent to the Location field. Navigate to and select the location directory.
In the Project Settings, edit the default project structure preference to use for the source and output of builds.
Under Working sets, select check box Add project to working sets to specify a working sets.
Click Finish. Designer creates a configuration project.
Note: You can install third-party YAML editors such as YEdit for Syntax highlighting support.
Designer stores each configuration template as a YAML resource. A configuration template may contain multiple configuration types and corresponding instances from either Integration Server or Universal Messaging runtime. You can add or edit configuration types or instances in a configuration template exported from Landscape Navigator. Designer uses the default YAML editor, or the Eclipse text editor to load the template.
To add configuration type or instance to a template
On the Landscape Navigator view , select an existing configuration from a runtime.
In the Properties view, select Template tab. The Template tab displays the YAML source for the selected configuration.
Copy the required configuration data from the YAML source.
Append the data in the template. Designer internally validates the YAML content for syntactical correctness and produces Deployable Configuration Asset upon save.
To deploy configuration assets to webMethods Cloud Container
In Project Explorer view, select the configuration project that you want to deploy to webMethods Cloud Container.
Right-click the project and click Deploy Configurations to Cloud.
In the Configuration Templates dialog box, select the templates to deploy. Click Next.
In the Configuration Template Variable Substitution dialog box, select the template and edit the values of the property that you want to modify before deploying to cloud. Click Next.
In the Select Cloud Solution dialog box, select the solution on webMethods Cloud Container to which you want to deploy the assets and click Finish. Designer deploys the configurations assets to a remote repository provisioned for the tenant on webMethods Cloud Container.