startServer 命令

startServer 命令读取所指定服务器进程的配置文件并启动该服务器进程。

使用 startServer 命令来执行下列操作:
  • 启动应用程序服务器。
  • 启动DMZ Secure Proxy Server for IBM® WebSphere® Application Server
  • 启动管理代理程序。
  • 启动作业管理器。
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

[Windows]如果您正在 Windows Windows 操作系统上运行该产品并且将服务器作为 Windows 操作系统服务运行,那么 startServer 命令将启动服务器以及关联的 Windows 服务。

您不必将用户名和密码与 startServer 命令配合使用,因为此命令虽然会启动服务器进程,但不会调用 MBean 方法。

避免故障 避免故障: 可以使用管理控制台来更改 Java™ 虚拟机类路径设置或服务器的环境条目设置。但是,在进行这些更改之前,应该了解进行这些更改的下列结果:
  • 发出 startServer -script 命令将会创建包含静态值的脚本。从控制台更改 JVM 参数后,需要生成一个新的脚本以包含这些更改后的 JVM 参数。
  • 运行 startServer -script 时,该命令将会生成一个新的脚本,此脚本包含该命令运行时的所有参数值。如果您更改这些参数的值(或者添加新的参数),那么已生成的脚本不会包含这些新的参数值。这些新值将以静态方式传递到新生成的脚本,因此,在创建此脚本之后进行的任何更改都需要运行新的 startServer -script,以生成包含这些更新后的值的新脚本。
  • 如果更改 Java 虚拟机类路径设置的值,那么此新值会覆盖缺省情况下在脚本中设置的 launch 命令中的 Classpath 参数的值(在您发出 startServer -script 命令时会生成该脚本)。
  • 如果在“环境条目”页面上添加新的环境条目或更改现有条目的设置,那么新值和已更改值作为参数出现在您发出 startServer -script 命令时生成的脚本中。
  • 如果添加的某个环境条目称为 PATH,那么为此条目指定的值会覆盖为 PATH 变量指定的值,缺省情况下,PATH 变量在 setUpCmdLine 文件中设置为 WAS_PATH。如果 PATH 变量的值被覆盖,那么以下消息会被发送至记录了错误消息的文件:
    WSVR0009E: Error occured during startup. com.ibm.ws.exception.RuntimeError: 
    java.lang.NoClassDefFoundError: com/ibm/ws/process/Win32ProcessGlue
gotcha

要了解有关从何处运行此命令的更多信息,请参阅使用命令行工具这一主题。

语法

命令语法为下列其中一项:
startServer server_name [options]

其中 server_name 是要启动的应用程序服务器或DMZ Secure Proxy Server for IBM WebSphere Application Server的名称。

[AIX Solaris HP-UX Linux Windows][z/OS]此参数是必需的。

[IBM i]此参数是可选的。如果未指定此参数,那么会根据概要文件名来分配服务器。如果使用名为 default 的概要文件,那么 <server> 参数设置为 server1。如果概要文件名不是 default,那么 <server> 参数设置为概要文件名。

startServer <adminagent_name>

其中 adminagent_name 是要启动的管理代理程序的名称。

startServer <job_manager>

其中 job_manager 是要启动的作业管理器的名称。

参数

下列选项可用于 startServer 命令:

-?
显示用法说明。
[IBM i]-curlib <product_library>
[IBM i]指定要用于底层“提交作业”(SBMJOB) CL 命令的当前库。
[IBM i]-cpyenvvar
[IBM i]通知 startServer 命令设置当前为服务器进程定义的环境变量。缺省情况是不设置当前定义的环境变量。
-help
显示用法说明。
[IBM i]-inllibl <library_list>
[IBM i]指定要用于底层“提交作业”(SBMJOB) CL 命令的初始库列表。
[IBM i]-inlaspgrp <ASP_group>
[IBM i]指定底层“提交作业”(SBMJOB) CL 命令的初始 ASP 组。
[AIX Solaris HP-UX Linux Windows][z/OS]-J <java_option>
[AIX Solaris HP-UX Linux Windows][z/OS]指定要传递至 Java 解释器的选项。
[IBM i]-jobd <product_library/job_description>
[IBM i]指定底层“提交作业”(SBMJOB) CL 命令的作业描述。
[IBM i]-jobq <product_library/job_queue>
[IBM i]指定底层“提交作业”(SBMJOB) CL 命令的作业队列。
[AIX Solaris HP-UX Linux Windows][z/OS]-logfile <fileName>
[AIX Solaris HP-UX Linux Windows][z/OS]指定写入跟踪信息的日志文件的位置。缺省情况下,日志文件名为 startServer.log,并且是在 logs 目录中创建的。
[AIX Solaris HP-UX Linux Windows][IBM i]-nowait
[AIX Solaris HP-UX Linux Windows][IBM i]指示 startServer 命令不要等待启动的服务器进程成功初始化。
[IBM i]-outq <product_library/output_queue>
[IBM i]指定底层“提交作业”(SBMJOB) CL 命令的输出队列。
-profileName
在多概要文件安装中定义服务器进程的概要文件。在单概要文件环境中运行不需要 -profileName 选项。此选项的缺省值为缺省概要文件。
[AIX Solaris HP-UX Linux Windows][z/OS]-quiet
[AIX Solaris HP-UX Linux Windows][z/OS]禁止显示 startServer 命令以正常方式输出的进度信息。
[AIX Solaris HP-UX Linux Windows][z/OS]-replacelog
[AIX Solaris HP-UX Linux Windows][z/OS]替换日志文件,而不是附加到当前日志。
-recovery
指定服务器将以恢复方式启动,执行事务恢复,然后关闭。当服务器处于恢复方式时将不接受任何新事务。当您再次启动该服务器时,由于可疑事务而不可用的资源将变为可用。

如果服务器失败,且在恢复过程中您不想接受新事务,那么请使用此选项。

转换: 如果要从产品的先前版本迁移,请确保控制器的 JCL 过程语句上包含的 ENV 参数包括 REC=N 或 REC=Y 元素。如果 ENV 参数不包括 REC=N 或 REC=Y 元素,那么即使您指定 -recovery 选项,服务器也不会以恢复方式重新启动。

[z/OS]如果 ENV 参数包括 REC=N 元素,那么如果您指定 -recovery,重新启动服务器时就会自动将设置更改为 REC=Y。如果未从产品的先前版本迁移,那么 REC=N 元素将自动包括在 ENV 参数中。以下是更新后的 PROC 语句的示例:

//BBO6ACR  PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
[IBM i]如果使用 -recovery 参数来调用 startServer 命令并且恢复过程失败,那么 SystemErr.logSystemOut.log 文件中将出现以下错误消息:
CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.
此消息未指示恢复过程失败。 如果使用 -recovery 参数,请检查要启动的服务器的 SystemErr.logSystemOut.log 文件,以确定恢复过程是否成功。
[IBM i]-sbs <product_library/subsystem_description>
[IBM i]指定要用于底层“提交作业”(SBMJOB) CL 命令的子系统。
[AIX Solaris HP-UX Linux Windows][z/OS]-statusport <portNumber>
[AIX Solaris HP-UX Linux Windows][z/OS]一个可选参数,允许管理员设置服务器状态回调的端口号。该工具打开此端口并等待来自服务器的指示该服务器已启动的状态回调。如果未设置此参数,那么将自动分配一个未使用的端口。
[AIX Solaris HP-UX Linux Windows][z/OS]-script [<script fileName>] -background
[AIX Solaris HP-UX Linux Windows][z/OS]使用 startServer 命令生成启动脚本,而不是直接启动服务器进程。启动脚本名称是一个可选参数。如果您没有提供启动脚本名称,那么缺省脚本文件名是基于服务器名称(其作为 startServer 命令的第一个参数传递)的 start_server-background 参数是一个可选参数,用于指定当您运行它时将在后台运行生成的脚本。
-trace
[AIX Solaris HP-UX Linux Windows][z/OS]将跟踪信息生成日志文件以进行调试。
[IBM i]启用对启动服务器的本机进程代码的跟踪。跟踪输出将写至 profile_root/logs 目录中的 was_jobname-jobuser-jobnum.log 文件。
-timeout <seconds>
指定在服务器初始化超时并返回一个错误之前的等待时间。
[IBM i]-usejobd
[IBM i]指定切换至 Run-As 用户标识时,将“提交作业”(SBMJOB) 进程中的作业描述用于服务器。
注: 此命令不会影响当前作业描述的 USER 字段。

使用方案

以下示例说明了正确的语法。括号中的信息是在发出前面的命令时会创建的输出描述。

[AIX Solaris HP-UX Linux Windows]
startServer server1

startServer server1 -script (produces the start_server1.sh or .bat files)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)
startServer jobmgr

startServer proxy1 (for the secure proxy profile)
[z/OS]
startServer server1

startServer server1 -script (produces the start_server1.sh file)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer jobmgr

startServer proxy1 (for the secure proxy profile)

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)
[IBM i]
startServer server1 (starts the server1 server for the default profile)

startServer server1 -trace (starts the server1 server for
the default profile and produces trace files under the
profile_root/logs directory)

startServer -profileName mytest (starts server mytest 
configured under profile mytest)

startServer AdminAgent01
startServer JobMgr01

startServer proxy1 (default server name for the SecureProxySrv01 profile)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

退出码

如何捕获 startServer 和 stopServer 返回码以确定此操作是否成功?该表显示了对于指定的启动或停止命令,服务器的返回码。

以下示例是用于执行和捕获服务器 1 的返回码的脚本:
#!/bin/sh
exitCode=`./startServer.sh server1`
可以将 exitCode 值与下一列返回码进行对比,以确定命令结果:
服务器状态 返回码
服务器初始化失败 -1
服务器初始化超时 -2
服务器正在启动 1
服务器正初始化显示的应用程序 2
服务器初始化完成(成功) 0
服务器未能停止 -10
服务器停止超时 -11
服务器停止操作已启动 1000
服务器已成功停止 0

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_startserver
文件名:rxml_startserver.html