The crtwasinst script

Note: The crtwasinst script is deprecated in Version 6. Use the wasprofile command with the -create parameter to create a profile.

The crtwasinst script creates a new profile, which contains one application server. It also creates the required directories and sets up the correct authorities. For usage instructions and examples, see Create a new profile.

Product

The crtwasinst script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

Authority

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

Syntax

The syntax of the script is shown below.

• WebSphere Application Server

  crtwasinst -profileName profile [ -portblock portblock ]
    [ -noembeddedjms ] [ -server servername ] [ -nodefaultapps ]
    [ -node nodename ] [ -os400passwords [ -validationlist listpath ] ] 
    [ -exthttp exthttpport ] [ -inthttp inthttpport ]
    [ -admin adminport ] [ -adminssl adminsslport ]
    [ -jmsqueued jmsqueuedport ] [ -jmsdirect jmsdirectport ]
    [ -jmssecure jmssecureport ] [ -soap soapport ]
    [ -nameservice nameserviceport ] [ -drsclient drsclientport ]
    [ -sas sasserverport ] [ -csiv2server csiv2serverauthport ]
    [ -csiv2client csiv2clientauthport ] [ -verbose ] [ -help ]

• WebSphere Application Server Network Deployment

  crtwasinst -profileName profile [ -portblock portblock ]
    [ -server servername ] [ -node nodename ] [ -cell cellname ]
    [ -admin adminport ] [ -adminssl adminsslport ] [ -soap soapport ]
    [ -orblistener orblistenerport ] [ -nameservice nameserviceport ]
    [ -drsclient drsclientport ] [ -celldiscovery celldiscoveryport ]
    [ -sas sasserverport ] [ -csiv2server csiv2serverauthport ]
    [ -csiv2client csiv2clientauthport ] [ -verbose ] [ -help ]

Parameters

The parameters of the script are:

• -profileName
  This is a required parameter. The value profile specifies the name of the profile. The script creates the new profile in the /QIBM/UserData/WebSphere/AppServer/V6/Base/profile directory or the /QIBM/UserData/WebSphere/AppServer/V6/ND/profile directory.

• -portblock
  This is an optional parameter. The value portblock specifies the first number of a block of port numbers that your profile 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.

  Notes:

  1. Although this is an optional parameter, it is recommended that you always specify the parameter (or the specific port parameters, described below) if you do not want your profile's ports to conflict with the default profile's ports.

  2. A WebSphere Application Server profile uses several ports for various functions. When you create a new profile, 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 (Base application server), -admin, -jmsqueued (Base application server), -jmsdirect (Base application server), -jmssecure (Base application server), -soap, -orblistener (Network Deployment), -nameservice, -drsclient, and -celldiscovery (Network Deployment).
     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 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.

  3. For the -portblock parameter, the script checks only a master index of all profiles of WebSphere Application Server Version 5.1 and WebSphere Application Server Network Deployment Version 5.1. The script is not able to detect port usage by other applications, including previous versions of WebSphere Application Server.

• -noembeddedjms
  (Base application server) This is an optional parameter. Specify this optional parameter if you do not want to create an embedded Java Message Service (JMS) provider for your profile. If you do not specify this parameter and you installed WebSphere MQ for iSeries and WebSphere MQ classes for Java and JMS V5.3 for iSeries, the script creates an embedded JMS provider when you create a new profile. For information about the software prerequisites, see Select the components to install.

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

• -node
  This is an optional parameter. The value nodename specifies the name of the node for the profile. If this parameter is not specified, the script assigns the default value. For a WebSphere Application Server profile, the default node name is hostname_profile, where hostname is the host name of the iSeries server and profile is the value specified for the -profileName parameter. For a WebSphere Application Server Network Deployment profile, the default node name is profileManager, where profile is the value specified for the -profileName parameter.

• -cell
  (Network Deployment) This is an optional parameter. The value cellname specifies the name of the cell for the profile. If this parameter is not specified, the cell name is profileNetwork where profile is the value specified for the -profileName parameter.

• -nodefaultapps
  This optional parameter specifies that the default applications should not be installed in the profile. The default applications provide examples that you can use to verify that your application server is functioning properly. By default the script installs the default applications in the profile.

• -os400passwords
  This is an optional parameter. If you specify this parameter, the script sets the os400.security.password.encoding.algorithm property in the application server's setupCmdLine file to OS400. The default encoding algorithm is XOR.

• -validationlist
  This is an optional parameter. The value listpath specifies the path to the validation list or lists that are used for the OS400 password encoding algorithm. It sets the os400.security.password.validation.list.object property in the application server's setupCmdLine file. This parameter only applies if the -os400passwords parameter is included. The default value is /QSYS.LIB/QUSRSYS.LIB/EJSADMIN.VLDL.

• -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 also listens on this port. See Communicating with Web servers for more information.

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

• -inthttp
  (Base application server) 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 Notes on the -portblock parameter for more information.

• -admin
  This is an optional parameter. The value adminport specifies the port number to use for the administrative console. If neither the -portblock parameter nor the -admin parameter is specified, the default value is 9090. See the Notes 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 administrative console. If neither the -portblock parameter nor the -adminssl parameter is specified, the default value is 9043. See the Notes on the -portblock parameter for more information.

• -jmsqueued
  (Base application server) This is an optional parameter. The value jmsqueuedport specifies the port number that the internal JMS provider's WebSphere MQ listener uses. This listener is used by JMS connections to communicate with the internal JMS provider. If neither the -portblock parameter nor the -jmsqueued parameter is specified, the default value is 5558. See the Notes on the -portblock parameter for more information.

• -jmsdirect
  (Base application server) This is an optional parameter. The value jmsdirectport specifies the port that the internal JMS provider uses to communicate with the internal JMS provider for JMS publish/subscribe connections when the WebSphere Topic Connection Factory resource port is set to DIRECT. If neither the -portblock parameter nor the -jmsdirect parameter is specified, the default value is 5559. See the Notes on the -portblock parameter for more information.

• -jmssecure
  (Base application server) This is an optional parameter. The value jmssecureport specifies the port that the internal JMS provider uses to communicate with the internal JMS provider to verify authorizations to resources when WebSphere Application Server security is enabled. If neither the -portblock parameter nor the -jmssecure parameter is specified, the default value is 5557. See the Notes 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 for a WebSphere Application Server profile is 8880. The default value for a WebSphere Application Server Network Deployment profile is 8879. See the Notes on the -portblock parameter for more information.

• -orblistener
  (Network Deployment) This is an optional parameter. The value orblistenerport specifies the port number to use for the orb listener port. If neither the -portblock or -orblistener parameter is specified, the default is 9100. See the Notes 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 for WebSphere Application Server is 2809. The default value for WebSphere Application Server Network Deployment is 9809. See the Notes on the -portblock parameter for more information.

• -drsclient
  This is an optional parameter. The value drsclientport specifies the port number to use for the Data Replication Service (DRS) client. If neither the -portblock parameter nor the -drsclient parameter is specified, the script assigns the default value. The default value for WebSphere Application Server is 7873. The default value for WebSphere Application Server Network Deployment is 7989. See the Notes on the -portblock parameter for more information.

• -celldiscovery
  (Network Deployment only) This is an optional parameter. The value celldiscoveryport specifies the port on which the Network Deployment profile listens for a node attempting to find the cell to which the node belongs. If neither the -portblock parameter nor the -celldiscovery parameter is specified, the default value is 7277. See the Notes 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. For WebSphere Application Server, the default value is 9501. For WebSphere Application Server Network Deployment, the default value is 9401. This port is specified by the SAS_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml. For information about changing this port with the administrative console, see End point settings. You can also use The chgwassvr script to change this port.

  Note: IBM recommends 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. For WebSphere Application Server, the default value is 9503. For WebSphere Application Server Network Deployment, the default value is 9403. This port is specified by the CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml. For information about changing this port with the administrative console, see End point settings. You can also use The chgwassvr script to change this port.

  Note: IBM recommends 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. For WebSphere Application Server, the default value is 9502. For WebSphere Application Server Network Deployment, the default value is 9402. This port is specified by the CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS property in serverindex.xml. For information about changing this port with the administrative console, see End point settings. You can also use The chgwassvr script to change this port.

  Note: IBM recommends 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.