Commands for the ServerManagement group of the AdminTask object
Use the Jython sor Jacl scripting languages to manage servers with the wsadmin tool. The commands and parameters in the ServerManagement group can be used to create and manage application servers and server configurations.
For more information about the AdminTask object, see the Commands for the AdminTask object article.
The following commands are available for the ServerManagement group of the AdminTask object:
Command name:
Description: Target object: Parameters and return values: Examples: createApplicationServer
Use the createApplicationServer command to create a new application server. Node name (optional)
- Parameters:
- - name
- The name of the server that you want to create. (String)
- - templateName
- The name of the template from which to base the server. (String)
- - genUniquePorts
- Specifies that unique ports should be created for the server. (boolean)
- - templateLocation
- The location of a template. (ObjectName)
- Returns: The configuration ID of the server you created.
Batch mode example usage:
Using Jacl
$AdminTask createApplicationServer ndnode1 {-name test1 –templateName default}Using Jython string
AdminTask.createApplicationServer(ndnode1, '[-name test1 -templateName default]’)
Interactive mode example usage:
Using Jacl
$AdminTask createApplicationServer {-interactive}Using Jython string
AdminTask.createApplicationServer ('[-interactive]')
createApplicationServerTemplate
The createApplicationServerTemplate command creates a new application server template. None
- Parameters:
- - templateName
- The name of the application server template that you want to create. (String)
- - serverName
- The name of the server from which to base the template. (String)
- - nodeName
- The node that corresponds to the server from which to base the template. (String)
- - description
- The description of the template. (String)
- - templateLocation
- The location where you want to place the template. (String)
- Returns: The configuration ID of a new template.
Batch mode example usage:
Using Jacl
$AdminTask createApplicationServerTemplate {-templateName newTemplate -serverName server1 -nodeName ndnode1 -description "This is my new template"}Using Jython string
AdminTask.createApplicationServerTemplate('[-templateName newTemplate -serverName server1 -nodeName ndnode1 -description "This is my new template"]')
Interactive mode example usage:
Using Jacl
$AdminTask createApplicationServerTemplate {-interactive}Using Jython string
AdminTask.createApplicationServerTemplate ('[-interactive]')
createGenericServer
Use the createGenericServer command to create a new generic server in the configuration. A generic server is a server that the WebSphere Application Server manages, but did not supply. The createGenericServer command provides an additional step, ConfigProcDef, that use to configure the parameters that are specific to generic servers. None
- Parameters:
- - name
- The name of the server that you want to create.
- - templateName
- Picks up a server template. This step provides a list of application server templates for the node and server type. The default value is the default templates for the server type. (String, optional)
- - genUniquePorts
- The port for the server.
- - templateLocation
- The location of the server template.
- - startCommand
- Indicates the path to the command that will run when this generic server is started. (String, optional)
- - startCommandArgs
- Indicates the arguments to pass to the startCommand when the generic server is started. (String, optional)
Batch mode example usage:
Using Jacl
$AdminTask createGenericServer jim667BaseNode {-name jgeneric -ConfigProcDef {{"/usr/bin/myStartCommand" "arg1 arg2" "" "" "/tmp/workingDirectory" "/tmp/stopCommand" "argy argz"}}}Using Jython string
AdminTask.createGenericServer('jim667BaseNode', '[-name jgeneric -ConfigProcDef [[/usr/bin/myStartCommand "arg1 arg2" "" "" /tmp/workingDirectory /tmp/StopCommand "argy argz"]]]')
Interactive mode example usage:
Using Jacl
$AdminTask createGenericServer {-interactive}Using Jython string
AdminTask.createGenericServer ('[-interactive]')
- - executableTargetKind
- Specifies whether a Java class name (use JAVA_CLASS) or the name of an executable JAR file (use EXECUTABLE_JAR) will be used as the executable target for this process. This field should be left blank for binary executables. This parameter is only applicable for Java processes. (String optional)
- - executableTarget
- Name of the executable target (a Java class containing a main() method or the name of an executable JAR), depending on the executable target type. This field should be left blank for binary executables. This parameter is only applicable for Java processes. (String, optional)
- - workingDirectory
- working directory for the generic server.
- - stopCommand
- Indicates the path to the command that will run when this generic server is stopped. (String, optional)
- - stopCommandArgs
- Indicates the arguments to pass to the stopCommand parameter when the generic server is stopped. (String, optional)
- Returns: None
createWebServer
Use the createWebServer command to create a Web server definition. This command is a two-step process. The first step creates a Web server definition using a template. The parameters of the second step configure the Web server definition properties. Web server definitions generate and propagate the plugin-config.xml file for each Web server. For IBM HTTP Server only, use the Web server definitions allow you to administer and configure IBM HTTP Server Web servers using the administrative console. These functions include: Start, Stop, View logs, View and Edit configuration files. None
- Parameters for step one:
- nodeName
- The name of the node. (String, required)
- name
- The name of the server. (String, required)
- templateName
- The name of the template that you want to use. Templates include the following: IHS, iPlanet, IIS, DOMINO, APACHE. The default template is IHS. (String, required)
- genUniquePorts
- Indicates that you want to generate unique ports. (optional)
- Parameters for step two:
- serverConfig
- Create the Web server. (String, required)
- webPort
- The port for the Web server. (String, required)
- configurationFile
- The configuration file. The default is the path relative to the installation root, for example, conf/httpd.conf. (String, optional)
- webInstallRoot
- The installation path for the Web server. (String, required)
- pluginInstallRoot
- The plug-in installation path. (String, required)
- serviceName
- The service name. (String, optional)
- errorLogfile
- The error log for viewing. The default is the path relative to the installation root, for example, logs/error_log. (String, optional)
Batch mode example usage:
Using Jacl
$AdminTask createWebServer {-name web1 -serverConfig {{webPort WebserverInstallRoot PluginInstallRoot Configuration_file_name Windows_Server_Name errorLogPath accessLogPath WebProtocol}} -remoteServerConfig {{AdminPort UserID Password AdminProtocol}}Using Jython string
AdminTask.createWebServer('[-name web1 -serverConfig [[webPort WebserverInstallRoot PluginInstallRoot Configuration_file_name Windows_Server_Name errorLogPath accessLogPath WebProtocol]] -remoteServerConfig [[AdminPort UserID Password AdminProtocol]]]')where -serverConfig is second step of the command.
- WebPort - is the port for the Webserver (required for all webservers)
- WebserverInstallRoot - is the install path (directory) for webserver. necessary for IBM HTTP Server Admin Function.
- Plugin Install Root - is install root where the plugin for the webserver is installed. Necessary for all webservers.
- Configuration file name - is the file path for the IBM HTTP Server. This is necessary for View and edit of the IBM HTTP Server Configuration file only.
- Windows Service Name - The windows service name on which IBM HTTP Server is to be started. This is necessary for Start and stop of the IBM HTTP Server Web server only.
- ErrorLogPath - This is the path for the IBM HTTP Server error log (error.log)
- accessLogfile
- The access log for viewing. The default is the path relative to the installation root, for example, logs/access_log. (String, optional)
- webProtocol
- Parameters for the IBM HTTP Server administration server running with an unmanaged or remote Web server. Options include HTTP or HTTPS. The default is HTTP. (String, required)
- adminPort
- The port of the IBM HTTP Server administrative server. (String, required)
- adminUserID
- The user ID. This value should match the one for authentication in the admin.conf. (String, required)
- adminPasswrd
- The administrative password. (String, required)
- adminProtocol
- The administrative protocol title. Options include HTTP or HTTPS. The default is HTTP. (String, required)
- AccessLogPath - This is the path for the IBM HTTP Server access log (access.log)
- WebServerProtocol - HTTP or HTTPS
where -remoteServerConfig is 3rd step of the command
These parameters are only necessary if the IBM HTTP Server Web server is installed on a machine remote from WebSphere.
- Admin Server Port - This is the port for the ADministration server. The administration server is installed on the same machine as the IBM HTTP Server. The administrative server handles administrative requests to the IBM HTTP Server Web server.
- UserID - This is the userID for authentication, if authentication is activated on the Administration server in the admin configuration file (admin.conf).
- Passwd - This is the password for the specified authentication UserID. The password is generated by htpasswd utility in the admin.passwd file.
- Admin ServerProtocol - HTTP or HTTPS
Interactive mode example usage:
Using Jacl
$AdminTask createWebServer -interactiveUsing Jython string
AdminTask.createWebServer ('[-interactive]')
- Parameters for step three:
Parameters for IBM HTTP Server administration server running with an unmanaged or remote Web server (installed on machine different from WebSphere Application Server)
- adminPortTitle (adminPort)
- Port of IBM HTTP Server administration
- adminUserIDTitle (adminUserID)
- The user ID. This value should match the authentication in the admin.conf file.
- adminPasswdTitle (adminPasswd)
- password
- AdminProtocolTitle (adminProtocol)
- This parameter is required. The value is either HTTP or HTTPS. The default value is HTTP.
- Returns: None
deleteServer
Use the deleteServer command to delete a server.
None
- Parameters:
- -serverName
- The name of the server to delete. (String, required)
- -nodeName
- The name of the node for the server that you want to delete. (String, required)
- Returns: None
Batch mode example usage:
Using Jacl
$AdminTask deleteServer {-serverName servername -nodeName node}Using Jython string
AdminTask.deleteServer('[-serverName servername -nodeName node]')
Interactive mode example usage:
Using Jacl
$AdminTask deleteServer {-interactive}Using Jython string
AdminTask.deleteServer ('[-interactive]')
deleteServerTemplate
Use the deleteServerTemplate command to delete a server template. We cannot delete templates that are defined by the system. We can only delete server templates that you created. This command deletes the directory that hosts the server template.
The name of the template to delete. (ObjectName, required)
- Parameters:
- Returns: None
Batch mode example usage:
Using Jacl
$AdminTask deleteServerTemplate template_name(templates/serverTypes /APPLICATION_SERVER/servers/newTemplate|server.xml#Server_1105015708079)Using Jython string
AdminTask.deleteServerTemplate('template_name(templates/serverTypes/ APPLICATION_SERVER/servers/newTemplate|server.xml#Server_1105015708079)')
Interactive mode example usage:
Using Jacl
$AdminTask deleteServerTemplate {-interactive}Using Jython string
AdminTask.deleteServerTemplate ('[-interactive]')
getServerType
The getServerType command returns the type of the server that you specify. None
- Parameters:
- - serverName
- The name of the server. (String)
- - nodeName
- The name of the node. (String)
- Returns: The type of the server.
Batch mode example usage:
Using Jacl
$AdminTask getServerType {-serverName test2 -nodeName ndnode1}Using Jython string
AdminTask.getServerType('[-serverName test2 -nodeName ndnode1]')
Interactive mode example usage:
Using Jacl
$AdminTask getServerType {-interactive}Using Jython string
AdminTask.getServerType ('[-interactive]')
listServers
The listServers command returns a list of servers. None
- Parameters:
- serverType
- The type of the server. Used to filter the results. (String)
- nodeName
- The name of the node. Used to filter the results. (String)
- Returns: A list of configuration IDs for the servers that match the criteria that you specified.
Batch mode example usage:
Using Jacl
$AdminTask listServers {-serverType APPLICATION_SERVER -nodeName ndnode1}Using Jython string
AdminTask.listServers('[-serverType APPLICATION_SERVER -nodeName ndnode1]')
Interactive mode example usage:
Using Jacl
$AdminTask listServers {-interactive}Using Jython string
AdminTask.listServers ('[-interactive]')
listServerTemplates
Use the listServerTemplates command to list server templates.
None
- Parameters:
- - version
- The version of the template that you want to list. (String, optional)
- - serverType
- Specify this option if you want to list templates for a specific server type. (String, optional)
- - name
- Specify this option to look for a specific template. (String, optional)
- - queryExp
- A key/value pair that use to find templates by properties. For example, com.ibm.websphere.nodeOperatingSystem=os390 (String[], optional)
- Returns: A list of server template identifications that match with the criteria that you specify with the command parameters. If you do no specify any parameters, all server templates are returned.
Batch mode example usage:
Using Jacl
$AdminTask listServerTemplates {-version 6.0.0.0 -serverType APPLICATION_SERVER}Using Jython string
AdminTask.listServerTemplates('[-version 6.0.0.0 -serverType APPLICATION_SERVER]')
Interactive mode example usage:
Using Jacl
$AdminTask listServerTemplates {-interactive}Using Jython string
AdminTask.listServerTemplates ('[-interactive]')
listServerTypes
Use the listServerTypes command to display all the current server types. For example, APPLICATION_SERVER, WEB_SERVER, GENERIC_SERVER
The node name for which you want to list the valid types. For example, the types that are only valid on z/OS will appear on a z/OS node. (String, optional)
- Parameters: None
- Returns: A list of server types that we can define on a node. If you do not specify the target object, this command returns all of the server types defined in the entire cell.
Batch mode example usage:
Using Jacl
$AdminTask listServerTypes ndnode1Using Jython string
AdminTask.listServerTypes(ndnode1)
Interactive mode example usage:
Using Jacl
$AdminTask listServerTypes {-interactive}Using Jython string
AdminTask.listServerTypes ('[-interactive]')
- - verboseModeGarbageCollection
- Specifies whether to use verbose debug output for garbage collection. The default is not to enable verbose garbage collection. (Boolean, optional)
- - verboseModeJNI
- Specifies whether to use verbose debug output for native method invocation. The default is not to enable verbose Java Native Interface (JNI) activity. (Boolean, optional)
- - initialHeapSize
- initial heap size in megabytes that is available to the JVM code. (Integer, optional)
- - maximumHeapSize
- maximum heap size available in megabytes to the JVM code. (Integer, optional)
- - runHProf
- This parameter only applies to WAS version. It specifies whether to use HProf profiler support. To use another profiler, specify the custom profiler settings using the hprofArguments parameter. The default is not to enable HProf profiler support. (Boolean, optional)
- - hprofArguments
- This parameter only applies to WAS version. It specifies command-line profiler arguments to pass to the JVM code that starts the application server process. We can specify arguments when HProf profiler support is enabled. (String, optional)
- - debugMode
- Specifies whether to run the JVM in debug mode. The default is not to enable debug mode support. (Boolean, optional)
- - debugArgs
- command line debug arguments to pass to the JVM code that starts the application server process. We can specify arguments when the debug mode is enabled. (String, optional)
- - genericJvmArguments
- command line arguments to pass to the JVM code that starts the application server process. (String, optional)
- - executableJarFileName
- Specifies a full path name for an executable JAR file that the JVM code uses. (String, optional)
- - disableJIT
- Specifies whether to disable the just in time (JIT) compiler option of the JVM code. (Boolean, optional)
- - osName
- JVM settings for a given operating system. When started, the process uses the JVM settings for the operating system of the node. (String, optional)
- Returns: None
showServerInfo
The showServerInfo command returns the information for a server that you specify. The configuration ID of the server. (required)
- Parameters: None
- Returns: A list of metadata.
Batch mode example usage:
Using Jacl
$AdminTask showServerInfo server1(cells/WAS00Network /nodes/ndnode1/servers/server1|server.xml)Using Jython string
AdminTask.showServerInfo('server1(cells/WAS00Network /nodes/ndnode1/servers/server1|server.xml)')
Interactive mode example usage:
Using Jacl
$AdminTask showServerInfo {-interactive}Using Jython string
AdminTask.showServerInfo ('[-interactive]')
showServerTypeInfo
The showServerTypeInfo command displays information about a specific server type. A server type. For example: APPLICATION_SERVER (String, required)
- Parameters:
- - version
- Specify the version of the templates that you want to list. For example, 6.0.0.0. (String, optional)
- - serverType
- Specify this option if you want to list templates for a specific server type. (String, optional)
- - name
- Specify this option to look for a specific template. (String, optional)
- - queryExp
- A key and value pair that use to find templates by properties. For example, com.ibm.websphere.nodeOperatingSystem=os390. (String[], optional)
- Returns: A list of information about the server type.
Batch mode example usage:
Using Jacl
$AdminTask showServerTypeInfo APPLICATION_SERVERUsing Jython string
AdminTask.showServerTypeInfo(APPLICATION_SERVER)
Interactive mode example usage:
Using Jacl
$AdminTask showServerTypeInfo {-interactive}Using Jython string
AdminTask.showServerTypeInfo ('[-interactive]')
showTemplateInfo
Use the showTemplateInfo command to display the metadata information for a specific server template.
The server type, for example: APPLICATION_SERVER (String, required)
- Parameters: None
- Returns: The metadata information regarding a specific template.
Batch mode example usage:
Using Jacl
$AdminTask showTemplateInfo default(templates/ servertypes/APPLICATION_SERVER/servers/default|server.xml) {isSystemTemplate true} {name default} {com.ibm.websphere.baseProductv6.0} {description {The WebSphere Default Server Template}} {com.ibm.websphere.baseProductMinorV0.0} {com.ibm.websphere.baseProductMajorV6} {com.ibm.websphere.nodeOperatingSystem {}} {isDefaultTemplate true}Using Jython string
AdminTask.showTemplateInfo(default(templates/serverTypes/APPLICATION_SERVER/servers/default|server.xml)) '[[isSystemTemplate true] [com.ibm.websphere.baseProductv6.0] [name default] [com.ibm.websphere.baseProductMinorV0.0] [description The WebSphere Default Server Template] [isDefaultTemplate true] [com.ibm.websphere.nodeOperatingSystem] [com.ibm.websphere.baseProductMajorV6]]'
Interactive mode example usage:
Using Jacl
$AdminTask showTemplateInfo {-interactive}Using Jython string
AdminTask.showTemplateInfo ('[-interactive]')
Related tasks
Using the AdminTask object for scripted administration Related reference
Commands for the AdminTask object