startServer 명령

startServer 명령은 지정한 서버 프로세스에 대한 구성 파일을 읽고 해당 서버 프로세스를 시작합니다.

startServer 명령을 사용하여 다음을 수행하십시오.
  • 애플리케이션 서버를 시작하십시오.
  • IBM® WebSphere® Application Server용 DMZ 보안 프록시 서버를 시작하십시오.
  • 관리 에이전트를 시작하십시오.
  • 작업 관리자를 시작하십시오.
참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.

[Windows]Windows Windows 운영 체제에서 제품을 실행 중이고 서버가 Windows 운영 체제 서비스로 실행 중인 경우, startServer 명령은 서버 및 연관된 Windows 서비스를 시작합니다.

startServer 명령은 서버 프로세스를 실행하지만 MBean 메소드를 호출하지 않으므로 이 명령과 함께 사용자 이름 및 비밀번호를 사용할 필요는 없습니다.

유의: 관리 콘솔을 사용하여 서버에 대한 JVM(Java™ Virtual Machine) 클래스 경로 설정 또는 환경 항목 설정을 변경할 수 있습니다. 하지만, 변경사항을 작성하기 전에 이러한 변경사항의 다음 결과를 이해해야 합니다.
  • startServer -script 명령을 실행하면 정적 값이 있는 스크립트가 작성됩니다. 콘솔에서 JVM 매개변수를 변경할 때는 이러한 변경된 JVM 매개변수를 수용할 수 있도록 새 스크립트를 생성해야 합니다.
  • startServer -script를 실행하면, 이 명령은 명령이 실행된 시점의 모든 매개변수 값을 포함하는 새 스크립트를 생성합니다. 매개변수의 값을 변경하거나 새 매개변수를 추가하는 경우, 생성된 스크립트에는 이러한 새 매개변수 값이 포함되어 있지 않습니다. 이러한 새 값은 새로 생성된 스크립트에 정적 방식으로 전달되므로, 이 스크립트가 작성된 후의 변경사항은 이러한 업데이트된 값을 포함하는 새 스크립트가 생성되도록 새 startServer -script 명령을 필요로 합니다.
  • JVM(Java Virtual Machine) 클래스 경로 설정값을 변경하는 경우, 이러한 새 값은 사용자가 startServer -script 명령을 실행할 때 생성되는 스크립트에 기본적으로 설정되어 있는 실행 명령의 클래스 경로 매개변수 값을 대체합니다.
  • 환경 항목 페이지에서 새 환경 항목을 추가하거나 기존 항목의 설정을 변경하는 경우, 새로 추가되거나 변경된 값이 사용자가 startServer -script 명령을 실행할 때 생성되는 스크립트에서 매개변수로 표시됩니다.
  • 사용자가 추가하는 환경 항목 중 하나가 PATH인 경우, 이 항목에 지정된 값은 setUpCmdLine 파일에서 기본적으로 WAS_PATH로 설정되는 PATH 변수에 지정된 값을 대체합니다. PATH 변수의 값이 대체되면 오류 메시지 로그 파일에 다음 메시지가 로그됩니다.
    WSVR0009E: Error occured during startup. com.ibm.ws.exception.RuntimeError: 
    java.lang.NoClassDefFoundError: com/ibm/ws/process/Win32ProcessGlue

이 명령을 실행할 위치에 대한 자세한 정보는 명령행 도구 사용 주제를 참조하십시오.

구문

명령 구문은 다음 중 하나입니다.
startServer server_name [options]

여기서, server_name은 시작할 IBM WebSphere Application Server용 DMZ 보안 프록시 서버 또는 애플리케이션 서버의 이름입니다.

[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]startServer 명령에 -recovery 매개변수를 지정하여 호출하는 경우 복구 프로세스가 실패하면 다음 오류 메시지가 SystemErr.logSystemOut.log 파일에서 발생합니다.
CWNATV03I: xxxxxx 프로파일의 xxxxxx 애플리케이션 서버 복구가 완료되었습니다.
서버가 중지되었습니다. 
이 메시지는 복구 프로세스가 실패했음을 표시하지 않습니다. -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 사용자 ID로 전환하는 경우 서버의 작업 제출(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 리턴 코드 캡처 방법은? 이 표는 시작 또는 중지 명령이 제시된 서버에 대한 리턴 코드를 표시합니다.

다음 예제는 server1에 대한 리턴 코드를 실행 및 캡처하는 스크립트입니다.
#!/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