Use this plugin to interact with an IBM WebSphere Server to:
-
Start and stop the server.
-
Manage applications within the server (start, deploy, undeploy, stop, or a custom task) using the provided WebSphere scripts in the bin directory under the installation home directory (wsadmin, startServer, or stopServer).
-
Run Jython scripts that are provided by the user or defined when a procedure is created.
Plugin version 3.1.0.2024041017 Revised on April 11, 2024
Integrated version
The plugin was tested on following WebSphere versions:
-
WAS and WASND 9.0 on Linux and Windows
-
WAS and WASND 8.5.5 on Linux and Windows
-
WAS and WASND 8.5.0 on Linux and Windows
-
WAS and WASND 8.0 on Linux and Windows
-
WAS 7.0 on Linux and Windows. Beginning with v2.4, we do not certify this plugin on the 7.0 version of WAS considering that this version is not actively supported by IBM since April 2018. For more information, refer to IBM Software withdrawal and service discontinuance statement.
Plugin configurations
Plugin configurations are sets of parameters that can be applied across some, or all, of the plugin procedures. They can reduce the repetition of common values, create predefined parameter sets, and securely store credentials. Each configuration is given a unique name that is entered in the designated parameter for the plugin procedures that use them.
Creating plugin configurations
To create plugin configurations in CloudBees CD/RO, complete the following steps:
-
Navigate to
. -
Select Add plugin configuration to create a new configuration.
-
In the New Configuration window, specify a Name for the configuration.
-
Select the Project that the configuration belongs to.
-
Optionally, add a Description for the configuration.
-
Select the appropriate Plugin for the configuration.
-
Configure the parameters per the descriptions below.
Configuration Procedure Parameters
Parameter | Description |
---|---|
Configuration Name |
Identifier of the configuration to create. i.e: myconfig |
WSAdmin Absolute Path |
Absolute path to wsadmin script. |
Connection Type |
Specifies type of connection to use to connect to the application server that you want to administer. |
WebSphere Host |
Hostname of the WebSphere Application Server to administer using wsadmin tool. For example: 10.200.1.234 or yourWSServer. |
WebSphere Connector Port |
Port of WebSphere Application server to which wsadmin should connect.Give the port number based on the type of connection you choose.For example, if you want to connect to application server using SOAP connection give the port number of SOAP connector of that server. |
Login as |
Credentials used to connect to WebSphere instance. |
Test Connection? |
Check if connection should be established during config creation to validate credentials. |
Test Connection Resource |
A resource which is used for the testing connection. |
Debug Level |
Debug level, higher debug level - more debug messages. Warning: on debug level 10 and more passwords will be revealed in a procedure logs. |
Plugin procedures
CreateEndToEndMailProvider
Creates a mail provider along with protocol provider and mail session.
This procedure creates mail provider with a protocol provider, a mail session and a custom property in the specified scope.
CreateEndToEndMailProvider Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Scope |
Specifies the scope in which the mail provider supports installed mail applications.For example, 'Cell=Cell01,Node=Node01,Server=server1' or 'Cell=Cell01,ServerCluster=testCluster' |
Mail Provider Name |
Specifies the name to be given to the new mail provider . |
Mail Provider Description |
Specifies the mail provider description. |
Isolate this mail provider? |
Specifies that this mail provider will be loaded in its own class loader. This allows the application server to load different versions or implementations of the same mail provider in the same Java Virtual Machine. Give each version or implementation of the mail provider a unique class path in following (Mail provider classpath) field that is appropriate for that version or implementation. |
Mail Provider Classpath |
Specifies the class path to a Java archive (JAR) file that contains the implementation classes for this mail provider. |
Custom Property Name |
Specifies the name of custom property to create. |
Custom Property Value |
Specifies the value to associate with this custom property of the resource. |
Protocol Provider Name |
Specifies the name to be given to the new protocol provider . |
Protocol Provider Class Name |
Specifies the implementation class of this protocol provider. |
Protocol Provider Type |
Specifies the type of protocol provider. Valid options are STORE(for incoming protocol provider) or TRANSPORT(for outgoing protocol provider). |
Mail Session Name |
Specifies the administrative name of the JavaMail session object. |
Mail Session JNDI Name |
Specifies the Java Naming and Directory Interface (JNDI) name for the resource, including any naming subcontexts. |
Category |
Optional string to use while classifying or grouping the resources. |
Enable Debug Mode? |
Select to print the interaction between mail application and mail server as well as the properties of this mail session to System.Out.log file. |
Mail Session Description |
Specifies optional description for mail session. |
Incoming Mail Server |
Specifies the host name server that is accessed when receiving mail. |
Incoming Mail Server Port |
Specifies the port of the server that is accessed when receiving mail. |
Incoming Mail Server Credentials |
Specifies the credential for the mail account when the incoming mail server requires authentication. |
Outgoing Mail Server |
Specifies the host name of server that is accessed when sending mail. |
Outgoing Mail Server Port |
Specifies the port of the server that is accessed when sending mail. |
Outgoing Mail Server Credential |
Specifies the user of the mail account when the outgoing mail server requires authentication. |
Enable Strict Internet Address Parsing? |
Specifies whether the recipient addresses must be parsed in strict compliance with RFC 822. |
CreateEndToEndMailProvider
To create a new mail provider along with protocol provider and mail session, do these steps:
-
Go to the CreateEndToEndMailProvider procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that OSGi application is deployed successfully:
In the CreateEndToEndMailProvider step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateMailSession
Creates a new JavaMail session using the wsadmin tool.
This procedure creates a JavaMail session object for default mail provider at specified scope.
CreateMailSession Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Scope |
Specifies the scope in which the mail session supports installed mail applications.For example, 'Cell=Cell01,Node=Node01,Server=server1' or 'Cell=Cell01,ServerCluster=testCluster' |
Mail Session Name |
Specifies the administrative name of the JavaMail session object. |
Mail Session Description |
Specifies optional description for mail session. |
Mail Session JNDI Name |
Specifies the Java Naming and Directory Interface (JNDI) name for the resource, including any naming subcontexts. |
Category |
Optional string to use while classifying or grouping the resources. |
Enable Debug Mode? |
Select to print the interaction between mail application and mail server as well as the properties of this mail session to System.Out.log file. |
Outgoing Mail Server |
Specifies the host name of server that is accessed when sending mail. |
Outgoing Mail Server Port |
Specifies the port of the server that is accessed when sending mail. |
Outgoing Mail Server Protocol |
Specifies the protocol to use when sending mail. |
Outgoing Mail Server Credential |
Specifies the user of the mail account when the outgoing mail server requires authentication. |
Return E-mail Address |
Represents the Internet email address that, by default, displays in the received message in the From or the Reply-To address. The recipient’s reply will come to this address. |
Incoming Mail Server |
Specifies the host name server that is accessed when receiving mail. |
Incoming Mail Server Port |
Specifies the port of the server that is accessed when receiving mail. |
Incoming Mail Server Protocol |
Specifies the protocol to use when receiving mail. |
Incoming Mail Server Credentials |
Specifies the credential for the mail account when the incoming mail server requires authentication. |
Enable Strict Internet Address Parsing? |
Specifies whether the recipient addresses must be parsed in strict compliance with RFC 822. |
Create Mail Session
To create a mail session for default mail provider, do these steps:
-
Go to the CreateMailSession procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that mail session is created successfully:
In the CreateMailSession step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
PublishWSDL
Publishes WSDL files in each web services-enabled module to the file system location
This procedure publishes WSDL files in each web services-enabled module to the file system location.
PublishWSDL Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the application of which to publish the WSDL file. i.e: 'webapp'. |
Location to publish WSDL file |
Filename and absolute path on the filesystem where published WSDL files should get stored.For example, 'C:/webservices/sampleWSDL.zip' |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar'. |
SOAP address prefixes |
Give SOAP address prefix in format "{{module {{binding partial-url}}}}" to customize the WSDL SOAP address for each module. For example, '{ {AddressBookJ2WB.war {{http http://localhost:9080}}} {StockQuote.jar {{http https://localhost:9443}}} }'. |
Additional Commands |
Additional commands to be entered for wsadmin. |
Publish WSDL
To publish WSDL files, do these steps:
-
Go to the PublishWSDL procedure.
-
Enter the following parameters:
CreateApplicationServer
(Applicable only for WebSphere Network Deployment installation.)
This procedure creates an Application Server identical to an existing Application Server or an Application Server definition which is part of a template. In addition it will synchronize nodes if checked.
CreateApplicationServer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Node Name |
Name of the node where application server is to be created. |
Server Name |
Name of application server to be created. |
Generate Unique Ports? |
By default ports generated during server creation will be created uniquely. If not checked ports in template will be used as is for server creation. |
Source Type |
Type of source which should be used for server creation. Select Template or Application Server. In case of template, application server template will be used for server creation, in case of Application Server, template will be created from existing application server and new server will be created from this template then. After successful creation template will be deleted. |
Source Template Name |
This parameter is applicable only when the source is a Template. Name of server template to be the source for a new server. |
Source Template Location |
The configuration Id that represents the location of a template. This parameter is applicable only when the source is a Template. |
Source Server Name |
Name of application server to be the source for a new server in format nodename:servername. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Create Application Server
To Create Application Server in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateApplicationServer step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteApplicationServer
(Applicable only for WebSphere Network Deployment installation.)
This procedure deletes an existing Application Server. In addition it will synchronize nodes if checked.
DeleteApplicationServer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Node Name |
Name of the node where application server to be deleted. |
Server Name |
Name of application server to be deleted. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Delete Application Server
To Delete Application Server in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteApplicationServer step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateApplicationServerTemplate
(Applicable only for WebSphere Network Deployment installation.)
This procedure creates a template of an existing Application Server.
CreateApplicationServerTemplate Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Node Name |
Name of the node where application server is located. |
Application Server Name |
Name of the application server the template will be based out of. |
Template Name |
Application server template name to be created. |
Template Location |
Specifies a configuration Id that represents the location to place the template. |
Template Description |
Description of application server template. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Create Application Server Template
To Create Application Server Template in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateApplicationServerTemplate step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteApplicationServerTemplate
(Applicable only for WebSphere Network Deployment installation.)
This procedure deletes an existing Application Server Template.
DeleteApplicationServerTemplate Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Template Name |
Application server template name to be deleted. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Delete Application Server Template
To Delete Application Server Template in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteApplicationServerTemplate step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateCluster
(Applicable only for WebSphere Network Deployment installation.)
Creates a new Application Server cluster.
This procedure creates a cluster, adds members to it, and can deploy an application in it using a Jython script.
CreateCluster Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of the new cluster. |
Prefer Local? |
Specifies whether enterprise bean requests are routed to the node on which the client resides whenever such a routing is possible. |
Create First Cluster Member? |
If not checked, empty cluster will be created |
First Cluster Member Creation Policy |
Controls how 1st cluster member is to be created Existing - use existing server as template Convert - convert existing server to 1st cluster member Template - use app server template to create 1st cluster member |
Source Template Name |
Name of server template to be the source for first cluster member. |
Source Server Name |
Name of application server to be the source for a new server in format nodename:servername. |
First Cluster Member Node |
Node name where first cluster member will be created. |
First Cluster Member Name |
Name of the server that will be created as a first cluster member. |
First Cluster Member Weight |
Weight of first cluster member. |
Generate Unique Ports for First Cluster Member? |
By default ports generated during for first cluster member creation will be created uniquely. If not checked ports in template will be used as is for server creation. |
Server Resources Promotion Policy |
Specifies how resources such as data sources are initially created in the cluster. Create settings at the cluster scope if the settings can be used across the entire cluster. Otherwise, create settings at the cluster member (server) level. Creating settings at the cluster scope reduces the amount of configuration that you maintain. Default is Cluster. |
Add Cluster Members? |
If checked, additional cluster members will be added right after cluster creation. |
Gen Unique Ports for Cluster Members? |
By default ports generated during cluster members creation will be created uniquely. If not checked ports in template will be used as is for server creation. |
Weight of Each Cluster Member |
Weight of each cluster member from list. |
Cluster Members List |
List of cluster members to be created in format NodeName:server1, NodeName2:server2. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Create Cluster
To Create Cluster in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateCluster step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteCluster
(Applicable only for WebSphere Network Deployment installation.)
Deletes an existing cluster using the wsadmin tool
This procedure delete the specified cluster.
DeleteCluster Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
The name of the cluster to delete. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Delete Cluster
To Delete Cluster in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteCluster step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
ExportApplicationServer
(Applicable only for WebSphere Network Deployment installation.)
This procedure exports the definition of an Application Server in an environment to an archive (with extension .car) in the filesystem, that can in turn be used import into another environment and create an identical server.
ExportApplicationServer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Node Name |
Name of application server node. |
Application Server Name |
Name of the application server to be exported. |
Archive |
Specifies the fully qualified path of the exported configuration archive. |
Export Application Server
To Export Application Server in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the ExportApplicationServer step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
ImportApplicationServer
(Applicable only for WebSphere Network Deployment installation.)
This procedure imports an Application Server from an Archive and creates an identical server in the environment the Archive is imported into.
ImportApplicationServer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Node Name |
Name of the Node in which the Application Server is to be Imported. |
Application Server Name |
Name of the Application Server to be created based on the server in the Imported Archive. |
Archive |
Specifies the fully qualified path of the configuration archive. |
Node Name in Archive |
Specifies the node name of the server defined in the configuration archive. Not required if there is only one Node in the Archive to be imported. If there are multiple nodes in the Archive, mention the node name of the Server to be imported. |
Server Name in Archive |
Specifies the name of the server defined in the configuration archive. Not required if there is only one Server in the Archive to be imported. If there are multiple servers in the Archive, mention the name of the Server to be imported. |
Core Group |
Specifies the core group name to which the server should belong. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Import Application Server
To Import Application Server in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the ImportApplicationServer step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
ListClusterMembers
(Applicable only for WebSphere Network Deployment installation.)
Lists all the members of cluster using wsadmin tool.
This procedure lists down all the members (application servers) of the cluster using a Jython script.
ListClusterMembers Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of the cluster of which members to list down. |
Output Property Path |
Property where cluster members list is to be stored. |
List Cluster Members
To List Cluster Members in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the ListClusterMembers step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
RemoveClusterMembers
(Applicable only for WebSphere Network Deployment installation.)
Removes list of application servers from existing cluster
This procedure removes specified application servers from the cluster using a Jython script.
RemoveClusterMembers Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of cluster from which to remove/delete the members. |
List of Cluster Members |
List of cluster members in the form Node01:server1, Node02:server2 to remove/delete from cluster. Important note: server will be not only removed from cluster, but also deleted. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Remove Cluster Members
To Remove Cluster Members in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the RemoveClusterMembers step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
SyncNodes
(Applicable only for WebSphere Network Deployment installation.)
Synchronizes active nodes.
Synchronizes Cell’s Deployment Manager config repository with nodes of the cell. By default, WebSphere nodes are configured for auto-sync. This procedure should be used for manual nodes synchronization. For example: New custom property for node was added, and configuration was saved. Next, to make it available on each server it should be propagated to all servers of the node by nodes synchronization.
SyncNodes Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
ConfigEJBContainer
Configures EJB container using the wsadmin tool
This procedure configures EJB container properites using a Jython script.
ConfigEJBContainer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Cell Name |
Name of cell to which EJB container belongs to. |
Node Name |
Name of node to which EJB container belongs to. |
Server Name |
Name of application server to which EJB container belongs to. |
Passivation Directory |
Specifies the directory into which the container saves the persistent state of passivated stateful session beans. This directory must already exist. It is not automatically created.Default is ${USER_INSTALL_ROOT}/temp. |
Cache Size |
Number of buckets in the active instance list within the EJB container.Input value range - greater than 0. The container selects the next largest prime number equal to or greater than the specified value.Default is 2053 |
Cleanup Interval |
Interval (in milliseconds)at which the container attempts to remove unused items from the cache.Default is 3000. Allowed range is 0 to 2147483647 |
Inactive Pool Cleanup Interval |
Specifies the interval at which the container examines the pools of available bean instances to determine if some instances can be deleted to reduce memory usage. |
Enable stateful session bean fail over using memory-to-memory replication? |
Specifies that failover is enabled for all stateful session beans installed in this EJB container.Replication domains must already exist to failover feature to work. |
Replication domain |
Specifies the replication domain in which HTTP sessions are replicated. |
Replication Mode |
The mode specifies whether data is only sent (client), only received (server), or both. Select client if sessions need to be replicated. Select server if sessions need to be stored. Select both client and server if sessions need to be replicated and stored. The default is both. |
Configure EJB Container
To Configure EJB Container, do these steps:
-
Go to the ConfigEJBContainer procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that EJB container is configured successfully:
In the ConfigEJBContainer step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateFirstClusterMember
(Applicable only for WebSphere Network Deployment installation.)
Creates the First Cluster Member of an existing cluster.
CreateFirstClusterMember Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of the new cluster. |
First Cluster Member Name |
Server Name of first cluster member. |
First Cluster Member Node |
Node Name of first cluster member. |
First Cluster Member Weight |
Weight of first cluster member. |
Generate Unique Ports for First Cluster Member? |
By default the port generated for first cluster member will be created uniquely. If this option is not checked, ports in template will be used as is. |
Server Resources Promotion Policy |
Specifies how resources such as data sources are initially created in the cluster. Create settings at the cluster scope if the settings can be used across the entire cluster. Otherwise, create settings at the cluster member (server) level. Creating settings at the cluster scope reduces the amount of configuration that you maintain. Default is Cluster. |
First Cluster Member Creation Policy |
Controls how first cluster member is created. The values mean the following. Existing - Use existing server Template - Use app server template to create first cluster member |
Source Template Name |
Name of server template to be the source for first cluster member. |
Source Server Name |
Name of application server to be the source for a new server in format nodename:servername. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Create First Cluster Member
To Create First Cluster Member in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateFirstClusterMember step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateClusterMembers
(Applicable only for WebSphere Network Deployment installation.)
Creates members under an existing cluster.
CreateClusterMembers Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
A name of the cluster where servers is to be created. |
Gen Unique Ports? |
Generate unique ports number if checked. |
Cluster Member Weight |
Weight of each cluster member |
List of Cluster Members |
List of cluster members. |
Sync Nodes? |
The syncNode command forces a configuration synchronization to occur between the node and the deployment manager for the cell in which the node is configured. |
Create Cluster Members
To Create Cluster Members in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateClusterMembers step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartApplicationServers
(Applicable only for WebSphere Network Deployment installation.)
This procedure starts one or more Application Servers that can be spread across nodes.
StartApplicationServers Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Server List |
List of Servers to be started. Provide them in this format : NodeName:ServerName. For example, Node1:Server1, Node2:Server2, Node3:Server3, or Node4:* to start all servers within Node4. |
Wait time |
Not Required. Time to wait until all servers are started. If not specified wait time will be treated as 0. |
Start Application Servers
To Start Application Servers in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StartApplicationServers step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StopApplicationServers
(Applicable only for WebSphere Network Deployment installation.)
This procedure stops one or more Application Servers that can be spread across nodes.
StopApplicationServers Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Server List |
List of Servers to be stopped. Provide them in this format : NodeName:ServerName. For example, Node1:Server1, Node2:Server2, Node3:Server3, or Node4:* to stop all servers within Node4. |
Wait time |
Not Required. Time to wait until all servers are stopped. If not specified wait time will be treated as 0. |
Stop Application Servers
To Stop Application Servers in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StopApplicationServers step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartCluster
(Applicable only for WebSphere Network Deployment installation.)
Starts cluster using wsadmin tool.
This procedure starts a cluster.
StartCluster Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of the cluster to be started. |
Timeout |
Specifies the waiting time before cluster start times out and returns an error. |
Start Cluster
To Start Cluster in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StartCluster step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StopCluster
(Applicable only for WebSphere Network Deployment installation.)
Stops cluster using wsadmin tool.
This procedure stops a cluster.
StopCluster Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Cluster Name |
Name of the cluster to be stopped. |
Timeout |
Specifies the waiting time before cluster stop times out and returns an error. |
Perform Ripple Start? |
If checked, all servers within cluster will be stopped one-by-one and then started. |
Stop Cluster
To Stop Cluster in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StopCluster step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartDeploymentManager
(Applicable only for WebSphere Network Deployment installation.)
This procedure starts the Deployment Manager in a WAS network deployment.
StartDeploymentManager Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
StartManager Location |
Absolute Physical path in Filesystem to location of startManager script i.e., /path/to/startManager.sh or startManager.bat |
Deployment Manager Profile |
Profile name of the DeploymentManager which needs to be started. If this is not provided StartManager will start the DeploymentManager which has the default profile. |
Log File Location |
Absolute Physical path in Filesystem to location of startManager.sh logs i.e., /path/to/startServer.log |
Timeout |
Specifies the waiting time before deployment manager start times out and returns an error. |
Additional Parameters |
This parameter can be used to either override defaults or pass Custom Properties. For example: -quiet, -nowait, -help. |
Start Deployment Manager
To Start Deployment Manager in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StartDeploymentManager step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StopDeploymentManager
(Applicable only for WebSphere Network Deployment installation.)
Stops Deployment Manager
StopDeploymentManager Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
StopManager Location |
Absolute Physical path in Filesystem to location of stopManager script i.e., /path/to/stopManager.sh or stopManager.bat |
Deployment Manager Profile |
Profile name of the DeploymentManager which needs to be stopped. If this is not provided StopManager will stop the DeploymentManager which has the default profile. |
Log File Location |
Absolute Physical path in Filesystem to location of stopManager.sh logs i.e., /path/to/stopServer.log |
Timeout |
Specifies the waiting time before deployment manager stop times out and returns an error. |
Additional Parameters |
This parameter can be used to either override defaults or pass Custom Properties. For example: -quiet, -nowait, -help. |
Stop Deployment Manager
To Stop Deployment Manager in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StopDeploymentManager step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartNode
(Applicable only for WebSphere Network Deployment installation.)
This procedure starts a WAS node and optionally starts all Application Servers in that Node.
StartNode Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
StartNode Location |
Absolute Physical path in Filesystem to location of startNode script i.e., /path/to/startNode.sh or startNode.bat |
Node Profile |
Profile name of the Node which needs to be started. If this is not provided StartNode will start the Node which has the default profile. |
Log File Location |
Absolute Physical path in Filesystem to location of startNode.sh logs i.e., /path/to/startServer.log |
Timeout |
Specifies the waiting time before node start times out and returns an error. |
Start all Application Servers? |
Start all application servers within node after nodeagent is started. |
Node Name to start Servers |
Name of the node where application servers needs to be started. |
Additional Parameters |
This parameter can be used to either override defaults or pass Custom Properties. For example: -quiet, -nowait, -help. |
Start Node
To Start Node in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StartNode step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StopNode
(Applicable only for WebSphere Network Deployment installation.)
This procedure stops a WAS node and stops the Application Servers in that Node based on the Stop Node policy.
StopNode Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
StopNode Location |
Absolute Physical path in Filesystem to location of stopNode script i.e., /path/to/stopNode.sh or stopNode.bat |
Node Profile |
Profile name of the Node which needs to be stopped. If this is not provided StopNode will stop the Node which has the default profile. |
Log File Location |
Absolute Physical path in Filesystem to location of stopNode.sh logs i.e., /path/to/stopServer.log |
Timeout |
Specifies the waiting time before node stop times out and returns an error. |
Node Stop Policy |
Policy that will be used for node stopping. It could be one of: Just Stop node agent, stop Spplication Servers, Save Node State. |
Additional Parameters |
This parameter can be used to either override defaults or pass Custom Properties. For example: -quiet, -nowait, -help. |
Stop Node
To Stop Node in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the StopNode step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartServer
Starts a WebSphere instance
This procedure starts a WebSphere instance or an application server using startServer.sh.
StartServer Parameters
Parameter | Description |
---|---|
StartServer Absolute Path |
Absolute path of the start server script, including filename and extension. i.e: 'startServer.bat' or '/path/to/startServer.sh' or 'C:\Program Files\IBM\WebSphere\AppServer\bin\startServer.bat'. |
Instance name |
The name of the instance of the server to be started. i.e: 'server01'. |
Additional Commands |
Additional commands to be entered for the startup of the server. |
StopServer
Stops a WebSphere instance
This procedure stops a WebSphere instance or an application server using stopServer.sh
StopServer Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Script Location |
Absolute path of the stop server script, including filename and extension. i.e: 'C:/Program Files/IBM/WebSphere/AppServer/bin/stopServer.bat', 'stopServer.bat', '/path/to/stopServer.sh' |
Instance Name |
Server instance name of the server to be stopped. i.e: 'server01'. |
Additional Commands |
Additional commands to be entered for stop the server. |
RunCustomJob
Runs a task using wsadmin
This procedure runs a task using wsadmin and the Jython code files.
RunCustomJob Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar'. |
Script File Absolute Path |
Path of a Jython script that will be run using wsadmin. i.e: '/path/to/scriptFile.jython' or 'c:/dir/scriptFile.jython'. |
Script File Source |
Indicates either if a script file route or an embedded script file will be provided. |
Script File |
Content of the script file to run if Embedded File is chosen in the Script File Source. |
Additional Commands |
Additional commands to be entered for wsadmin. |
ConfigureSession
Configures the session management properties for the deployed application.
This procedure configures the session management related properties for deployed application. For more information on each of the parameter, please refer to the WebSphere Knowledge Center Page.
ConfigureSession Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. /path/to/wsadmin.sh or wsadmin.bat. |
Application Name |
Name of the web application to configure. |
Enable SSL Tracking |
Specifies that session tracking uses Secure Sockets Layer (SSL) information as a session ID. Enabling SSL tracking takes precedence over cookie-based session tracking and URL rewriting. |
Enable Cookies |
Specifies whether to enable cookies. |
Enable URL Rewriting |
Specifies whether the session management facility uses rewritten URLs to carry the session IDs. If URL rewriting is enabled, the session management facility recognizes session IDs that arrive in the URL if the encodeURL method is called in the servlet. |
Enable Protocol Switching |
This option is only applicable when Enable URL rewriting is selected. This option specifies that the session ID is added to a URL when the URL requires a switch from HTTP to HTTPS or from HTTPS to HTTP. If rewriting is enabled, the session ID is required to go between HTTP and HTTPS. |
Max in-memory session count |
Specifies the maximum number of sessions to maintain in memory. |
Allow Overflow |
Specifies whether the number of sessions in memory can exceed the value specified by the Max in-memory session count property. This option is valid only in non-distributed sessions mode.. |
Enable Serialized Session |
If selected, concurrent session access in a given server is not permitted. |
Maximum Wait Time |
Specifies the maximum amount of time in seconds a servlet request waits on an HTTP session before continuing execution. The default is 5 seconds. Under normal conditions, a servlet request waiting for access to an HTTP session gets notified by the request that currently owns the given HTTP session when the request finishes. |
Access Session On Timeout |
Specifies whether the servlet is started normally or aborted in the event of a timeout. If you specify true, the servlet is started normally. If you specify false, the servlet execution aborts and error logs are generated. |
Invalid Timeout |
Specifies how long(in minutes) a session can go unused before it is no longer valid. |
Session Persistence Mode |
Specifies whether to enable session persistence mode. |
Configure Session Management for application
To Configure Session Management for application, do these steps:
-
Go to the ConfigureSession procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the cluster was created successfully:
In the ConfigureSession step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
MapSharedLibrary
Maps shared library.
This procedure maps shared library to already deployed application.
MapSharedLibrary Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Library Name |
Shared Library Name. |
Application Name |
Name of application to which shared library will be mapped. |
Map Shared Library to Application
To map shared library to application, do these steps:
-
Go to the MapSharedLibrary procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
In the MapSharedLibrary step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
ModifyApplicationClassLoader
Modify Application ClassLoader.
This procedure modifies ClassLoader of the deployed Application.
ModifyApplicationClassLoader Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Load Order |
The class-loader delegation mode, also known as the class loader order, determines whether a class loader delegates the loading of classes to the parent class loader. |
ClassLoader Isolation Policy |
Application class loaders load EJB modules, dependency JAR files, embedded resource adapters, and application-scoped shared libraries. Depending on the application class-loader policy, an application class loader can be shared by multiple applications (Single) or unique for each application (Multiple). The application class-loader policy controls the isolation of applications that are running in the system. When set to Single, applications are not isolated. When set to Multiple, applications are isolated from each other. |
Application Name |
Name of the existing web application, which ClassLoader should be modified. |
Modify Application’s ClassLoader
To modify Application’s ClassLoader do the following steps:
-
Go to the ModifyApplicationClassLoader procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
In the ModifyApplicationClassLoader step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StartApp
Start an application using wsadmin
This procedure starts an application using wsadmin. If the application is already running, a warning will be thrown.
StartApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the application to start. i.e: 'webapp'. |
Cluster Name |
Name of the cluster on which application is deployed. Not required in WebSphere Base Edition. |
Server Name |
Name of the server on which application is deployed. Specify server in the form Node=server. For e.g. Node01=Server1. Not required in WebSphere Base Edition. |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar'. |
Additional Commands |
Additional commands to be entered for wsadmin. |
Starting Applications
To start an application, do these steps:
-
Go to the StartApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that application was started successfully:
In the StartApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
StopApp
Stop an application using wsadmin
This procedure stops an application using wsadmin. If the application is already stopped, a warning will be thrown.
StopApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the application to stop. i.e: 'webapp'. |
Cluster Name |
Name of the cluster on which application is deployed. Not required in WebSphere Base Edition. |
Server Name |
Name of the server on which application is deployed. Specify server in the form Node=server. For e.g. Node01=Server1. Not required in WebSphere Base Edition. |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar'. |
Additional Commands |
Additional commands to be entered for wsadmin. |
Stopping Applications
To stop an application, do these steps:
-
Go to the StopApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the application was stoped successfully:
In the StopApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateJDBCProvider
Creates a JDBC Provider using the wsadmin tool
This procedure creates a JDBC provider using a Jython script.
CreateJDBCProvider Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
JDBC Provider Name |
Name of the JDBC Provider. |
JDBC Provider Description |
A description for the JDBC Provider. |
Cell Scope |
Parent object where the JDBC Provider will be created. This determines the visibility scope of the JDBC Provider. When the Cell Scope is provided, if the node and server scopes are not provided, then the scope will be the 'cell'; if the node is provided and the server not, then the scope will be the 'node'; if the server is provided and the node not, then the scope will be the 'server'. At least the Cell, the Node or the Server scope must be provided. i.e: 'wsaspluginNode01Cell'. |
Cluster Scope |
When the Cluster Scope is provided, then the scope will be the cluster. i.e: 'cluster1'. |
Node Scope |
When the Node Scope is provided, if the cell and server scopes are not provided, then the scope will be the 'node'; if the cell is provided and the server not, then the scope will be the 'node'; if the server is provided and the cell not, then the scope will be the 'server'. i.e: 'wsaspluginNode01'. |
Server Scope |
When the Server Scope is provided, then the scope will be the Node and the server always, even if the Node and the Cell Scopes are not provided. i.e: 'server1'. |
Implementation Class Name |
Java class name of the JDBC provider implementation. |
Driver Class Path |
A path for the resource provider classes. |
Creating a JDBC Providers
To create a JDBC provider, do these steps:
-
Go to the CreateJDBCProvider procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that JDBC provider was successfully created:
In the CreateJDBCProvider step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteJDBCProvider
Deletes a JDBC Provider using the wsadmin tool
This procedure deletes a JDBC provider using a Jython script.
DeleteJDBCProvider Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
JDBC Provider Name |
A unique name that identifies the JDBC Provider to delete in the WebSphere domain. |
Deleting JDBC Providers
To delete a JDBC provider, do these steps:
-
Go to the DeleteJDBCProvider procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the JDBC provider was deleted successfully:
In the DeleteJDBCProvider step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateDatasource
Creates a datasource using the wsadmin tool. The scope assigned to the datasource is provided by the JDBC Provider.
The procedure creates a datasource by using a Jython script.
CreateDatasource Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
JDBC Provider |
Name of an existing JDBC Provider. |
Datasource Name |
A unique name that identifies this Datasource in the WebSphere domain. |
Datasource Description |
A description for the datasource. |
JNDI Name |
The JNDI path to where this Datasource is bound. |
Statement Cache Size |
Specifies the number of statements that can be cached per connection. The application server caches a statement after you close that statement. |
Authentication Alias Name |
Provide the authentication data alias. |
Datasource Helper Class Name |
Provide the datasource helper class name. |
To create a datasource, do the following steps:
-
Go to the CreateDataSource procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the datasource was successfully created:
In the CreateDatasource step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteDatasource
Deletes a datasource using the wsadmin tool
This procedure deletes a datasource using a Jython script.
DeleteDatasource Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Datasource Name |
A unique name that identifies the datasource to delete in the WebSphere domain. |
Deleting Datasources
To delete a datasource, do these steps:
-
Go to the DeleteDatasource procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the datasource was deleted successfully:
In the DeleteDatasource step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateJMSProvider
Creates a JMS Provider using the wsadmin tool
This procedure creates a new JMS provider using a Jython script.
CreateJMSProvider Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Scope |
Specifies a scope of cell, node, server, or cluster for the JMS provider. E.g. Cell=Cell01,Node=Node01,Server=server1 |
JMS Provider Name |
Specifies the name to assign to the new JMS provider. |
Initial Context Factory |
Specifies the Java class name of the initial context factory for the JMS provider. |
JMS provider URL |
Specifies the JMS provider URL for external JNDI lookups. |
Classpath |
Specifies a list of paths or Java archive (JAR) file names which together form the location for the resource provider classes. Use a semicolon (;) to separate class paths. |
Description |
Specifies a description of the JMS Provider. |
Isolated Class Loader |
If set to true, specifies that the resource provider is loaded in its own class loader. |
Native Path |
Specifies an optional path to any native libraries, such as *.dll and *.so. Native path entries are separated by a semicolon (;). |
Provider Type |
Specifies the JMS provider type that this JMS provider uses. |
Property Set |
Specifies resource properties in the following format: [[['name','nameValue1'],['type','typeValue1'],['value','valueValue1']]… [['name','nameValuen'],['type','typeValuen'],['value','valueValuen']]] |
Supports ASF |
If set to true, specifies that the JMS provider supports Application Server Facilities (ASF), which provides concurrency and transactional support for applications. |
Create JMS Provider
To create a new JMS provider, do these steps:
-
Go to the CreateJMSProvider procedure.
-
Enter the following parameters:
DeleteJMSProvider
Deletes JMS Provider
This procedure deletes an existing JMS Provider.
DeleteJMSProvider Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
JMS Provider Scope |
Scope of the WebSphere messaging provider to be deleted. |
JMS Provider Administartive Name |
The administrative name of JMS Provider to be deleted. |
Delete JMS Provider
To delete JMS Provider in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose DeleteJMSProvider from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To delete JMS Provider in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteJMSProvider step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateJMSQueue
Creates or updates JMS Queues
This procedure creates a new JMS Queue or updates an existing JMS Queue.
CreateOrUpdateJMSQueue Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Queue Scope |
Scope of the messaging provider at which the JMS Queue is to be created. |
Queue Administrative Name |
The administrative name assigned to this WebSphere MQ messaging provider queue. |
Queue Name |
Name of the Queue. |
JNDI Name |
The name used to bind this object into WebSphere Application Server JNDI. |
Queue Manager Name |
Queue manager that hosts the queue. |
Queue Administrative Description |
An administrative description assigned to queue. |
Additional Options |
This parameter can be used to either override defaults or pass Custom Properties. For example: -ccsid 1208 -readAhead YES |
Create or update JMS Queue
To create or update JMS Queue in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateJMSQueue from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update JMS Queue in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateJMSQueue step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteJMSQueue
Deletes JMS Queues
This procedure deletes an existing JMS Queue.
DeleteJMSQueue Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Queue Scope |
Scope of the messaging provider at which the JMS Queue is to be deleted. |
Queue Administrative Name |
The administrative name assigned to this WebSphere MQ messaging provider queue. |
Delete JMS Queue
To delete JMS Queue in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose DeleteJMSQueue from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To delete JMS Queue in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteJMSQueue step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateJMSTopic
Creates or updates JMS Topics
This procedure creates a new JMS Topic or updates an existing JMS Topic.
CreateOrUpdateJMSTopic Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Topic Scope |
Scope of the messaging provider at which the JMS Topic is to be created. |
Topic Administrative Name |
The administrative name assigned to this WebSphere MQ messaging provider Topic. |
Topic Name |
Name of the Topic. |
JNDI Name |
The name used to bind this object into WebSphere Application Server JNDI. |
Topic Administrative Description |
An administrative description assigned to Topic. |
Additional Options |
This parameter can be used to either override defaults or pass Custom Properties. For example: -readAhead YES -ccsid 1208 |
Create or update JMS Topic
To create or update JMS Topic in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateJMSTopic from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update JMS Topic in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateJMSTopic step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteJMSTopic
Deletes JMS Topics
This procedure deletes an existing JMS Topic.
DeleteJMSTopic Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Topic Scope |
Scope of the messaging provider at which the JMS Topic is to be deleted. |
Topic Administrative Name |
The administrative name assigned to this WebSphere MQ messaging provider topic. |
Delete JMS Topic
To delete JMS Topic in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose DeleteJMSTopic from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To delete JMS Topic in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteJMSTopic step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateSIBJMSActivationSpec
Creates or updates SIB JMS Activation Specs
This procedure creates a new JMS Activation Spec or updates an existing JMS Activation Spec.
CreateOrUpdateSIBJMSActivationSpec Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Scope of the Activation Spec |
Scope of the WebSphere Default messaging provider at which the Activation Spec is to be created. |
Activation Spec Administrative Name |
The administrative name assigned to this Activation Spec. |
JNDI Name |
The name and location used to bind this object into WebSphere Application Server JNDI. |
Destination JNDI Name |
The JNDI name of the destination JMS queue or topic used by the message-driven bean. |
Activation Spec Administrative Description |
An Administrative description assigned to Activation Spec. |
Destination Type |
An option to determine whether the message_driven bean uses a JMS queue or a JMS topic. |
Message Selector |
The JMS message selector used to determine which messages the message-driven bean receives. The value is a string that is used to select a subset of the available messages. The syntax is based on a subset of the SQL 92 conditional expression syntax, as described in the JMS specification. Refer to the information center for more information. The selector string can refer to fields in the JMS message header and fields in the message properties. Message selectors cannot reference message body values. A null value (an empty string) indicates that there is no message selector for the message consumer. |
Additional Options |
Used to either override defaults or pass Custom Properties. |
Create or update SIB JMS Activation Spec
To create or update JMS Activation Spec in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateSIBJMSActivationSpec from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update JMS Topic in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateSIBJMSActivationSpec step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateWMQJMSActivationSpec
Creates or updates WMQ JMS Activation Specs
This procedure creates a new JMS Activation Spec or updates an existing JMS Activation Spec.
CreateOrUpdateWMQJMSActivationSpec Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Scope of the Activation Spec |
Scope of the WebSphere MQ messaging provider at which the Activation Spec is to be created. |
Activation Spec Administrative Name |
The administrative name assigned to this Activation Spec. |
JNDI Name |
The name and location used to bind this object into WebSphere Application Server JNDI. |
Destination JNDI Name |
The JNDI name of the destination JMS queue or topic used by the message-driven bean. |
Destination JNDI Type |
The type of the destination specified by "Destination JNDI Name" parameter. |
Activation Spec Administrative Description |
An Administrative Description assigned to Activation Spec. |
Client Channel Definition URL |
A URL to a client channel definition table to use, for this Activation Spec, when contacting WebSphere MQ. |
Client Channel Definition Queue Manager |
A queue manager name, used to select one or more entries from a client channel definition table. |
Additional Options |
Used to either override defaults or pass Custom Properties. |
Create or update WMQ JMS Activation Spec
To create or update WMQ JMS Activation Spec in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateWMQJMSActivationSpec from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update WMQ JMS Activation Spec in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateWMQJMSActivationSpec step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteJMSActivationSpec
Deletes JMS Activation Specs
This procedure deletes an existing JMS ActivationSpec.
DeleteJMSActivationSpec Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Scope of the Activation Spec |
Scope of the messaging provider at which the JMS Activation Spec is to be deleted. |
Activation Spec Administrative Name |
The administrative name assigned to this WebSphere MQ messaging provider Activation Spec. |
Delete JMS Activation Spec
To delete JMS Activation Spec in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose DeleteJMSActivationSpec from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
In the DeleteJMSActivationSpec step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
To delete JMS Activation Spec in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the pipeline tasks click on "Update SIB JMS Activation Spec", then click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateSIBJMSConnectionFactory
Creates or updates SIB JMS Connection Factories
This procedure creates a new SIB JMS Connection Factory or updates an existing JMS Connection Factory.
CreateOrUpdateSIBJMSConnectionFactory Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Scope of the Connection Factory |
Scope of the WebSphere Default messaging provider at which the Connection Factory is to be created. |
Connection Factory Administrative Name |
The administrative name assigned to this Connection Factory. |
Bus Name |
Name of the service integration bus to which connections are made. |
JNDI Name |
The name and location used to bind this object into WebSphere Application Server JNDI. |
Connection Factory Type |
Type of Connection Factory to create. Should be one of Queue or Topic. To create a generic connection factory, leave this parameter unset. This parameter is being used only if Connection Factory is going to be created. Since factory type can’t be updated in existing factory, this parameter will be omited if Connection Factory already exists. |
Connection Factory Administrative Description |
An Administrative Description assigned to Connection Factory. |
Additional Options |
Used to either override defaults or pass Custom Properties. |
Create or update SIB JMS Connection Factory
To create or update SIB JMS Connection Factory in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateSIBJMSConnectionFactory from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update JMS Topic in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateSIBJMSConnectionFactory step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CreateOrUpdateWMQJMSConnectionFactory
Creates or updates WMQ JMS Connection Factories
This procedure creates a new WMQ JMS Connection Factory or updates an existing JMS Connection Factory.
CreateOrUpdateWMQJMSConnectionFactory Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Scope of the Connection Factory |
Scope of the WebSphere MQ messaging provider at which the Connection Factory is to be created. |
Connection Factory Administrative Name |
The administrative name assigned to this Connection Factory. |
Connection Factory Type |
Use this parameter to determine whether a unified connection factory, a queue connection factory or a topic connection factory is to be created. This needs to be one of the values from CF, QCF and TCF. Default is CF. Since factory type can’t be updated in existing factory, this parameter will be omited if Connection Factory already exists. |
JNDI Name |
The name and location used to bind this object into WebSphere Application Server JNDI. |
Connection Factory Administrative Description |
An Administrative description assigned to Connection Factory. |
Client Channel Definition URL |
A URL to a client channel definition table to use, for this Connection Factory, when contacting WebSphere MQ. |
Client Channel Definition Queue Manager |
A queue manager name, used to select one or more entries from a client channel definition table. |
Additional Options |
Used to either override defaults or pass Custom Properties. |
Create or update WMQ JMS Connection Factory
To create or update WMQ JMS Connection Factory in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CreateOrUpdateWMQJMSConnectionFactory from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To create or update JMS Topic in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CreateOrUpdateWMQJMSConnectionFactory step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeleteJMSConnectionFactory
Deletes JMS Connection Factories
This procedure deletes an existing JMS ConnectionFactory.
DeleteJMSConnectionFactory Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Messaging System Type |
The name of the messaging provider. Pass in either WMQ or SIB. |
Scope of the Connection Factory |
Scope of the WebSphere messaging provider at which the Connection Factory is to be deleted. |
Connection Factory Administrative Name |
The administrative name assigned to this Connection Factory. |
Delete JMS ConnectionFactory
To delete JMS ConnectionFactory in CloudBees CD interface, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose DeleteJMSConnectionFactory from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To delete JMS ConnectionFactory in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the DeleteJMSConnectionFactory step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeployApp
Deploys an application using AdminApp.install
This procedure undeploys an application using a Jython script and invoking AdminApp.uninstall.
DeployApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar' |
Application Name |
Name of the web application to be deploy. i.e: 'webapp'. |
Application Path |
Absolute path of the application to deploy. i.e: '/path/to/webapp.war' or 'c:/mydir/webapp.war'. |
Additional Commands |
Additional commands to be entered for wsadmin. |
Deploying Applications
To deploy an application, do these steps:select the following highlighted step:
-
Go to the DeployApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the application was deployed successfully:
In the DeployApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeployEnterpriseApp
Deploys an enterprise application using wsadmin tool
This procedure deploys java enterprise application (.EAR) or java web application (.WAR) on given targets. If application is already deployed, procedure updates application.
DeployEnterpriseApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Specifies logical name to be given to installing enterprise application. Do not include whitespaces in application name. |
Application Path |
Absolute path of the application to deploy. Use "/" as the path separator on both linux and windows i.e: '/path/to/webapp.war' or 'c:/mydir/webapp.war'. |
Target cluster |
Name of the cluster on which to deploy enterprise application. Not required in WebSphere Base Edition. Enter either target cluster or target server(s). |
Target server(s) |
Specify single or list of standalone application servers on which to deploy enterprise application. Specify servers in the form Node=server. For e.g. Node01=Server1,Node02=Server2. Not required in WebSphere Base Edition. |
Map modules to servers |
Specify deployment targets where you want to install the modules that are contained in your application. Modules can be installed on the same deployment target or dispersed among several deployment targets. Give input in format [ "Module1Name" Module1URL server1][ "Module2Name" Module2URL server2 ] E.g. [ "Increment EJB module" Increment.jar,META-INF/ejb-jar.xml WebSphere:cell=Cell01,node=Node01,server=singleServer ] |
Additional deployment parameters |
Specify any additional options for AdminApp. Install object in case not listed in this input form. For more information about each of the supported arguments, refer to 'http://www-01.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/rxml_taskoptions.html'. |
Directory to install application |
Specifies the directory to which the enterprise archive (EAR) file will be installed. Default is profile_root/installedApps/cell_name/application_name.ear directory. |
Precompile JavaServer Pages files? |
Specify whether to precompile JavaServer Pages (JSP) files as a part of installation. The default is not to precompile JSP files. |
Distribute application? |
Specifies whether the product expands application binaries in the installation location during installation. |
Use binary configuration? |
Specifies whether the application server uses the binding, extensions, and deployment descriptors located with the application deployment document, the deployment.xml file (default), or those located in the enterprise archive (EAR) file. Default is to use bindings located in deployment.xml. |
Deploy enterprise beans? |
Specifies whether the EJBDeploy tool runs during application installation. Default is false(true for EJB 3.0 modules). |
Create MBeans for resources? |
Specifies whether to create MBeans for resources such as servlets or JSP files within an application when the application starts. Default is create MBeans. |
Override class reloading settings for web and EJB modules? |
Specifies whether the product run time detects changes to application classes when the application is running. If yes, then on such changes application is stopped and restarted to reload updated classes. |
Deploy web services? |
Specifies whether to deploy web services. Default is do not enable Deploy web services. |
Process embedded configuration? |
Specifies whether the embedded configuration should be processed. An embedded configuration consists of files such as resource.xml, variables.xml, and deployment.xml. |
Allow EJB reference targets to resolve automatically? |
Specifies whether the embedded configuration should be processed. |
Deploy client modules? |
Select if the file to deploy has one or more client modules and want to configure environment entries for the client modules. Default is do not enable Client Module. |
Validate schema? |
Specifies whether to validate the deployment descriptors against published Java EE deployment descriptor schemas. |
Synchronize active nodes? |
Specify whether to synchronize active nodes. Applicable only for Network Deployment installation. Enabled by default. |
Start application? |
Specify whether to start application or not. Enabled by default. |
Reload interval in seconds |
Specifies the number of seconds to scan the application’s file system for updated files. Default is 3 seconds. |
Validate resource references |
Specifies whether websphere examines the application references specified during application installation or updating and, if validation is enabled, warns you of incorrect references or fails the operation. |
File permission |
Specifies access permissions for application binaries. |
Customized file permission |
Provide custom file permissions if not listed in File permissions drop down. |
Business level application name |
Specifies whether websphere creates a new business-level application with the enterprise application that you are installing or makes the enterprise application a composition unit of an existing business-level application. The default is to create a new business-level application. |
Client deployment mode |
Specifies whether to deploy client modules to an isolated deployment target (Isolated), a federated node of a deployment manager (Federated), or an application server (Server Deployed). Default is Isolated |
Wsadmin Commands |
Commands to be entered to wsadmin. Use one command per line. |
Wsadmin Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar'. |
Wsadmin Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Wsadmin Additional Arguments |
Additional arguements to be passed to wsadmin. |
Context root |
Applicable only to web applications (WAR). Specifies the context root of the web application (WAR). A context root for each web module is defined in the application deployment descriptor during application assembly. Use this field to assign a different context root to a web module. The context root is combined with the defined servlet mapping (from the WAR file) to compose the full URL that users type to access the servlet. For example, if the context root is /gettingstarted and the servlet mapping is MySession, then the URL is http://host:port/gettingstarted/MySession. |
Deploy Enterprise Application
To deploy an enterprise application, do these steps:
-
Go to the DeployEnterpriseApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that enterprise application is deployed successfully:
In the DeployEnterpriseApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
DeployOSGiApp
Deploy OSGi application using the wsadmin tool
This procedure deploys the OSGi application.It optionally configures external OSGi bundle library if the application to be deployed reference bundles that are stored in an external bundle repository. This procedure can also add the bundles to internal bundle repository, if required.
DeployOSGiApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Want to add external bundle repository? |
If your OSGi applications reference bundles that are stored in an external bundle repository, you must configure a link (name and URL) to the repository so that the provisioner can retrieve the bundles when required. |
External Bundle Repository Name |
Name of the external bundle repository to configure. |
External Bundle Repository URL |
URL of the external bundle repository to configure. |
List of bundles to add to local repository |
Comma separated list of bundles to add to internal bundle repository.E.g. C:/installableApps/com.ibm.samples.websphere.osgi.logging.api.jar,C:/installableApps/com.ibm.samples.websphere.osgi.logging.impl.jar |
EBA file Path |
Absolute path of the OSGi application to deploy. i.e: '/path/to/blog.eba' or 'c:/mydir/blog.eba'. |
Application Name |
Name to be given to newly deployed OSGi application. |
Target Deployment Unit |
Deployment Unit on which to deploy the OSGi application. For e.g cluster=cluster1 or node=node01,server=server1 |
Deploy OSGi Application
To deploy an OSGi application, do these steps:
-
Go to the DeployOSGiApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that OSGi application is deployed successfully:
In the DeployOSGi step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
UndeployApp
Undeploys an application using AdminApp.uninstall
This procedure undeploys an application using a Jython script and invoking AdminApp.uninstall.
UndeployApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. If the path in which wsadmin is stored in the path environmental variable, the absolute path is ommited. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the application to undeploy. i.e: 'webapp'. |
Commands |
Commands to be entered to wsadmin. Use one command per line. |
Java Parameters |
Java options to be passed to wsadmin, separate them using semicolons (;). |
Classpath |
Jars to be passed to the wsadmin classpath. It is a string containing paths (semicolon-separated) the required JARs to execute wsadmin in a particular job. i.e: 'c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar' or '/MyDir/Myjar.jar;/yourdir/yourdir.jar' |
Additional Commands |
Additional commands to be entered for wsadmin. |
Undeploying Applications
To undeploy an application, do these steps:
Go to the UndeployApp procedure. Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that the application was undeployed successfully:
In the UndeployApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
UpdateApp
Updates existing application
This procedure updates already deployed application in units of files, modules or entire application.
UpdateApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the web application to be updated. i.e: 'webapp'. |
Content Type |
Specifies to type of content to update. Use File option for updating a single file, Partial Application option for updating application partially, Module option to add/update a module to the deployed application, Application option for updating the entire deployed application. |
Operation |
Specifies to type of operation to perform as part of update procedure. Use Add option to add new content, Update option to update existing content, AddUpdate option to add content and to replace if already exist, Delete option to remove existing content respectively. |
Content |
Specifies the file that contains the content that you want to update. For example, depending on the content type, the file could be an EAR file, a module, a partial zip, or a single file.Not required for Delete operation. |
Content URI |
The relative path beginning with the installed application archive file to the file to be replaced or added. For example, if the file is located at com/company/greeting.class in module hello.jar, specify hello.jar/com/company/greeting.class for the relative path |
Cluster Name |
Name of the cluster on which application is deployed. |
Server Name |
Name of the server on which application is deployed. |
Additional Parameters |
Additional parameters to pass while updating entire application or module/s, if required. For e.g. -nodeployejb, -BindJndiForEJBNonMessageBinding etc. |
Update Application
To update application , do these steps:
-
Go to the UpdateApp procedure.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details, which show that WSDL files are published successfully:
In the UpdateApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CheckApp
Checks if a web application is ready
This procedure checks if a web application is ready by using a Jython script.
CheckApp Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Absolute Path |
Absolute path of wsadmin, including filename and extension. i.e: '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Application Name |
Name of the web application to be checked. i.e: 'webapp'. |
Application State Checked |
Application State that is being checked, with any applicable retries based on wait time parameter. Any state that is not the desired state after any applicable retries, will be returned as a failure by the procedure. |
Wait Time |
Maximum duration of check application state retries. |
Checking Application State
To check Application State, do these steps:
-
Create procedure.
-
Create step, choose Plugin, choose CheckApp from procedures picker.
-
Enter the following parameters:
After the job runs, you can view the results, including the following job details:
To check Application State in CloudBees CD interface, do these steps:
-
Create Pipeline.
-
Create task.
-
In task definition choose Plugin and choose following parameters:
-
Click on arrow.
-
Enter the following parameters:
After the pipeline runs, you can view the results, including the following step details:
In the CheckApp step, click the Log icon to see the diagnostic information. The output is similar to the following diagnostic report.
CheckNodeStatus
(Applicable only for WebSphere Network Deployment installation.)
Checks Node Status.
This procedure checks WebSphere node status. It checks Node Agent and all servers associated with node by it’s name.
CheckNodeStatus Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Wsadmin Path |
Path to wsadmin. If the location of wsadmin is in the PATH environment variable, then just the script name can be specified omitting its full path. E.g. '/path/to/wsadmin.sh' or 'wsadmin.bat'. |
Name of the Node |
Name of the Node, which should be checked. |
Success Criteria |
Conditions that must be met for successful completion of the procedure. |
CheckPageStatus
Check the status of a page on a given URL
This procedure checks the status of the page with the specified URL.
CheckPageStatus Parameters
Parameter | Description |
---|---|
Credentials to be entered |
The credentials needed to check the status of the page. |
Target URL |
URL of the page to be checked. |
Maximum Elapsed Time |
Defines the maximum time in seconds that the job will try to check into the server. Blank implies no wait time (URL only checked one time). |
Success Criteria |
Indicates the expected correct result to be obtained when running checking the server. |
Checking the Status of a Page
To check the status of page at a specific URL, do the following steps:
-
Enter the following parameters:
-
Click Run.
After the job runs, you can view the results, including the following job details, which show that the criteria was reached:
In the CheckPageStatus step, click the Log icon to see the diagnostic info. The output is similar to the following diagnostic report.
CheckServerStatus
Check the status of the given server URL
This procedure checks the status of the specified server URL.
CheckServerStatus Parameters
Parameter | Description |
---|---|
Configuration Name |
Name of the configuration to be used. URL, port and credentials are retrieved from the given configuration. |
Maximum Elapsed Time |
Defines the maximum time in seconds that the job will try to check into the server. Blank implies no wait time (URL only checked one time). |
Success Criteria |
Indicates the expected correct result to be obtained when running checking the server. |
Release notes
EC-WebSphere 3.1.0
-
Fixed an issue that prevented the UpdateApp procedure from running while using a Delete operation.
-
Added option in the UpdateApp procedure to update applications without forcing application/cluster to restart.
EC-WebSphere 3.0.0
-
Upgraded from Perl 5.8 to Perl 5.32. The plugin is not backward compatible with CloudBees CD/RO versions prior to 10.3. Starting from this release, a new agent is required to run EC-WebSphere plugin procedures.
-
The support of new configurations has been added.
EC-WebSphere 2.8.0
-
Add checking connection while creating a configuration.
-
Jobs for the successful "CreateConfiguration" and "EditConfiguration" run is now preserved.
-
Add logging while running "CreateConfiguration".
EC-WebSphere 2.6.0
-
Following new procedures have been added to support management of clusters:
The Interface for the Following procedures have been Improved (for moving WSADMIN path to configuration, decoupling Application deployment from Start, Ability to sync nodes etc.,)
Error Reporting has been improved by leveraging postp to capture granular error messages in Diagnostics.
EC-WebSphere 2.5.0
-
Following New procedures have been added to support application server management:
-
Following New procedures have been added to support start and stop of Node and Deployment Manager:
-
WSAdmin Absolute path has been changed from non-required to required in plugin configuration.
EC-WebSphere 2.4.1
-
Configured the plugin to allow the ElectricFlow UI to create configs inline of procedure form.
EC-WebSphere 2.4.0
-
Following New procedures have been added to support the entire set of IBM JMS functionality:
EC-WebSphere 2.3.1
-
Help links have been updated for DeleteJMSTopic and DeleteJMSQueue procedures.
-
Configured the plugin to allow the ElectricFlow UI to render the plugin procedure parameters entirely using the configured form XMLs.
-
Enabled the plugin for managing the plugin configurations in-line when defining an application process step or a pipeline stage task.
EC-WebSphere 2.3.0
-
Following New procedures have been added:
Fixed non-ascii characters in plugin forms.
Following procedures have been extended to support Websphere 9.0:
The Debug Level checkbox has been changed to a dropdown. The level will be defaulted to INFO if no value is chosen.
WSAdmin Absolute Path has been added to configuration and made as an optional parameter for all the following procedures:
Fixed an issue when application was not started on all servers during deployment if server name and node name are the same.
Fixed an error with attached credentials when in some cases it was not possible to create new JDBC provider.
Procedure has been improved and now it could check for different application states.
EC-WebSphere 2.2.4
-
Documentation has been improved.
-
Cluster Scope field has been added to CreateJDBCProvider procedure.
EC-WebSphere 2.2.3
-
Added support of parallel execution for all plugin procedures.
-
Added "Context root" parameter for Deploy Enterprise Application procedure.
-
Bug fixes in CheckPageStatus procedure.
-
Added warning instead of stack trace in the Stop/StartApp procedures if app was already stoped or started.
EC-WebSphere 2.2.2
-
Added new procedures - SyncNodes, CheckNodeStatus.
-
Added following optional parameters to DeployEnterpriseApplication procedure:
-
"Synchronize active nodes": Sync active nodes after application deployment. Enabled by default.
-
"Start application": Start the deployed application after deploying the application. Enabled by default.
-
-
Changed default value for "Distribute application" from unchecked to checked. (Deploy Enterprise Application procedure).
EC-WebSphere 2.2.1
-
Added new procedures - StartCluster, StopCluster, MapSharedLibrary, ModifyApplicationClassLoader.
-
DeployEnterpriseApp procedure will now update the application if it is already deployed. This procedure was refactored.
-
Added debugging in DeployEnterpriseApp procedure.
-
Bug fixes in DeployEnterpriseApplication procedure on WASND 8.5.5 Windows platform.
-
Bug fixes in UpdateApp procedure on WAS 8.5 and WASND 8.5.5 Windows platform.
-
Added application name to step log when ModifyApplicationClassLoader procedure fails to find application.
-
Added debug flag to plugin configurations.
EC-WebSphere 2.2.0
-
Added suport for discovering WebSphere configuraiton on ElectricFlow resource.
-
Moved 'Connection Type' parameter for all plugin procedures to plugin’s configuration.
-
Added 'Cluster Name' and 'Server Name' optional parameter to 'Start Application' and 'Stop Application' procedures.
EC-WebSphere 2.1.0
-
Added support for WebSphere Network Deployment 8.5
-
Added support to create a cluster, add application servers to it, deploy applications in the cluster, remove cluster members, and delete the cluster.
-
Added support to deploy Java enterprise applications (EARs) and web archives (WARs).
-
Added support to update deployed applications.
-
Added support to deploy OSGi applications and to configure external and internal bundle repositories.
-
Added support to configure session management component for deployed applications.
-
Added support for setting the EJB container properties for improved memory consumption and stateful session bean failover.
-
Added support for the JavaMail session.
EC-WebSphere 2.0.6
-
Fixed the DeployApp procedure to not include the password in the log file.
-
Fixed the problem about attaching credentials in the CheckApp procedure.
-
Fixed the problem where the wsadmin password appeared when you view job step log files and property information.
-
Fixed instructions to create WebSphere plugin configurations.
-
Fixed instructions to access plugins in ElectricFlow.
EC-WebSphere 2.0.4
-
Add four new procedures: CreateDatasources, DeleteDatasources, CreateJDBCProviders, and DeleteJDBCProviders.
-
Fix minor bugs.
EC-WebSphere 2.0.1
-
Features and Enhancements in EC-WebSphere 2.0.1.
-
Use the new Parameter Form XML.
-
Add a link directly to the new help document.
EC-WebSphere 1.3.0
-
Add the CheckPageStatus procedure.
-
Remove the CURL dependency from the CheckServerStatus procedure.
-
Fix minor bugs.
-
The procedures now have only one step using ec-perl to execute the necessary commands.