Create an application server instance with the crtwasinst script

You can use the crtwasinst script from Qshell to create an application server instance. You can create multiple WebSphere Application Server - Express instances that are completely isolated from one another. For example, you can create separate instances for application development and application testing, or you can create one instance with security enabled and one with security disabled.

The crtwasinst script creates a new instance that contains one application server. It also creates the required directories and sets up the correct authorities. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.

Authority

To run this script, your iSeries user profile must have *ALLOBJ authority.

Usage

To create a new instance with the crtwasinst script, follow these steps:

1. On the CL command line, enter the STRQSH (Start Qshell) command.

2. Run the cd command to change to the directory that contains the script:

   cd /QIBM/ProdData/WebASE51/ASE/bin

3. Run the crtwasinst script:

   crtwasinst -instance instance -portblock port

   where instance is the name of the instance that is created and port is the first of a block of ports.

Syntax

The syntax of the script is shown below.

crtwasinst -instance instance [ -portblock portblock ]
 [ -server servername ] [ -exthttp exthttpport ] [ -extssl extsslport ]
 [ -inthttp inthttpport ] [ -admin adminport ] [ -adminssl adminsslport ]
 [ -soap soapport ] [ -nameservice nameserviceport ] [ -sas sasserverport ]
 [ -csiv2server csiv2serverauthport ] [ -csiv2client csiv2clientauthport ]
 [ -verbose ] [ -help ]

Parameters

The parameters of the script are:

• -instance
  This is a required parameter. The value instance specifies the name of the instance. The script creates the new instance in the /QIBM/UserData/WebASE51/ASE/instance directory.

• -portblock
  This is an optional parameter. The value portblock specifies the first number of a block of port numbers that your instance uses. Specify the first port in a group of unused ports on your iSeries server. You can use the Work with TCP/IP Network Status (NETSTAT *CNN) command to display a list of port numbers that are currently being used.

  Note:

  1. A WebSphere Application Server - Express instance uses several ports for various functions. When you create a new instance, ports are assigned based on the following ordered conditions:

     1. Specific port parameters
        If you specify values for specific port parameters, the script uses those values. Specific port parameters are -inthttp, -admin, -soap, -nameservice, and -drsclient.
     2. The -portblock parameter
        Services for which you have not specified a port number are assigned ports sequentually starting with the value of the -portblock parameter. If a script encounters a port that is assigned to a different instance or a port specified by another parameter in the script, it skips that port number and continues with the next unused port.
     3. Default values
        If -portblock is not specified, any services for which you have not specified a port parameter are assigned the default ports. See the specific port parameters for the default port numbers.

• -server
  This is an optional parameter. The value servername specifies the name of the application server that runs in your instance. If this value is not specified, the application server name is the same as the instance name.

• -exthttp
  This is an optional parameter. The value exthttpport specifies the number of the TCP/IP port where the external HTTP server listens. The default value is 80. You must configure the external HTTP server through its administrative interface so that WebSphere Application Server - Express also listens on this port.

  Note: The -portblock parameter does not affect the external HTTP port. If you specify the -portblock parameter, but not the -exthttp parameter, your instance uses the default value for the external HTTP port.

• -extssl
  This parameter is supported in versions 5.0 and 5.0.1 only. This is an optional parameter. The value extsslport specifies the number of the TCP/IP port where the external SSL-enabled HTTP server listens. The default value is 443. You must configure the external HTTP server through its administrative interface so that WebSphere Application Server - Express also listens on this port for SSL-enabled requests.

  Note: The -portblock parameter does not affect the external SSL port. If you specify the -portblock parameter, but not the -extssl parameter, your instance uses the default value for the external SSL port.

• -inthttp
  This is an optional parameter. The value inthttpport specifies the port number on which the Web container listens for requests from the Web server. If neither the -portblock parameter nor the -inthttp parameter is specified, the default value is 9080. See the Note on the -portblock parameter for more information.

• -admin
  This is an optional parameter. The value adminport specifies the port number to use for the WebSphere administrative console. If neither the -portblock parameter nor the -admin parameter is specified, the default value is 9090. See the Note on the -portblock parameter for more information.

• -adminssl
  This is an optional parameter. The value adminportssl specifies the port number to use for the secure communications with WebSphere administrative console. If neither the -portblock parameter nor the -adminssl parameter is specified, the default value is 9043. See the Note on the -portblock parameter for more information.

• -soap
  This is an optional parameter. The value soapport specifies the port number to use for Simple Object Access Protocol (SOAP). If neither the -portblock parameter nor the -soap parameter is specified, the script assigns the default value. The default value is 8880. See the Note on the -portblock parameter for more information.

• -nameservice
  This is an optional parameter. The value nameserviceport specifies the port number to use for name service (or RMI connector) port. If neither the -portblock parameter nor the -nameservice parameter is specified, the script assigns the default value. The default value is 2809. See the Note on the -portblock parameter for more information.

• -sas
  This is an optional parameter. The value sasserverport specifies the port on which the Secure Association Services (SAS) listen for inbound authentication requests. The default value is 9401. This port is specified by the SAS_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml.

  Note: It is recommended that you specify this parameter. If you do not specify this parameter, the application server selects a port at runtime. However, if a client application is connected to the application server and the application server restarts, the server could select a different port number, and the client application would be unable to connect to the server.

• -csiv2server
  This is an optional parameter. The value csiv2serverauthport specifies the port on which the Common Secure Interoperability Version 2 (CSIV2) Service listens for inbound server authentication requests. The default value is 9403. This port is specified by the CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml.

  Note: It is recommended that you specify this parameter. If you do not specify this parameter, the application server selects a port at runtime. However, if a client application is connected to the application server and the application server restarts, the server could select a different port number, and the client application would be unable to connect to the server.

• -csiv2client
  This is an optional parameter. The value csiv2clientauthport specifies the port on which the Common Secure Interoperability Versson 2 (CSIV2) Service listens for inbound client authentication requests. The default value is 9402. This port is specified by the CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS property in serverindex.xml.

  Note: It is recommended that you specify this parameter. If you do not specify this parameter, the application server selects a port at runtime. However, if a client application is connected to the application server and the application server restarts, the server could select a different port number, and the client application would be unable to connect to the server.

• -verbose
  This optional parameter turns on verbose messages, which can be helpful if you need to debug the script.

• -help
  This optional parameter displays the help message. If you specify this parameter, the script ignores all other parameters.

Example

In this example, the script creates an instance named devinst.

crtwasinst -instance devinst -portblock 10320