Starting and stopping a node

You can start a node by using the startNode command. You can stop a node by using the stopNode command. Starting and stopping a node is applicable only if your profile, also known as a node, is added to a WebSphere® Application Server WebSphere Application Server Network Deployment domain or cell.

Before you begin

Before you can start and stop a node, you must federate the node into a cell.

Start the deployment manager and add the node as a managed node of the deployment manager. Adding the managed node federates the node.

About this task

Start or stop a node as need in administering your WebSphere Application Server Network Deployment environment. Before your environment can service requests, you must have the deployment manager and node started, and typically an HTTP server.

Procedure

  • Start a node.
    Use one of these methods to start a node:
    • Use the startNode command.

      [IBM i]Use the startNode Qshell script to start a node from the Qshell command line of the IBM® i server hosting the node.

      [Windows]For example, from a command dialog at the bin directory of the node profile, run the serverStatus -all command. Suppose running the command shows that the node profile is named nodeagent. To start the node, run the following command from a command dialog at the bin directory of the node profile:
      startNode
      After starting the node, running the serverStatus -all command shows that the nodeagent status is STARTED.
    • [IBM i]Use the Submit Job (SBMJOB) CL command.
      You can run this CL command from an IBM i command line:
      SBMJOB CMD(CALL PGM(product_library/QWASSTRSVR) PARM('-profilePath'
        'profile_root' '-server' 'node agent')) JOB(server)
        JOBD(QWAS85/QWASJOBD) JOBQ(QWAS85/QWASJOBQ) USER(QEJBSVR) LANGID(*USRPRF)
        CNTRYID(*USRPRF) CCSID(*USRPRF) OUTQ(QWAS85/QWASOUTQ) ALWMLTTHD(*YES)
      where
      • profile_root is the profile root of the node agent.
      • node agent is the name of the node agent server that you want to start.
  • Stop a node.
    Use one of these methods to stop a node:
    • Use the stopNode command:
      stopNode

      [IBM i]Use the stopNode Qshell script to stop a node from the Qshell command line of the IBM i server hosting the node.

      [Windows]For example, from a command dialog at the bin directory of the node profile, run the serverStatus -all command. Suppose running the command shows that the node profile is named nodeagent. To stop the node, run the following command from a command dialog at the bin directory of the node profile:
      stopNode
    • Use the deployment manager administrative console.
      To use the deployment manager administrative console to stop a node:
      1. Start the deployment manager profile that manages your node.
      2. Start the administrative console for the deployment manager.
      3. Expand System Administration and click Node Agents.
      4. Select the check box for the node that you want to stop.
      5. Click Stop.
    • [IBM i]Use the End Job (ENDJOB) CL command
      To use the ENDJOB CL command to end an application server, enter this command on an IBM i command line:
      ENDJOB JOB(jobNumber/QEJBSVR/jobName) OPTION(*CNTRLD) DELAY(delayTime)
      where jobNumber is the job number, jobName is the name of the application server job for the deployment manager, and delayTime is the amount of time to wait for the job to end in seconds. Set the value to 600 seconds initially. To find out what the appropriate delayTime value is, see Shutting down the WebSphere Application Server subsystem.

Results

You have started and stopped a node.

What to do next

You can deploy applications, create a cluster, and generally administer your WebSphere Application Server Network Deployment environment.