startServer 명령
startServer 명령은 지정한 서버 프로세스에 대한 구성 파일을 읽고 해당 서버 프로세스를 시작합니다.
- 애플리케이션 서버를 시작하십시오.
- IBM® WebSphere® Application Server용 DMZ 보안 프록시 서버를 시작하십시오.
- 관리 에이전트를 시작하십시오.
- 작업 관리자를 시작하십시오.
Windows Windows 운영 체제에서
제품을 실행 중이고 서버가 Windows
운영 체제 서비스로 실행 중인 경우, startServer 명령은 서버 및 연관된
Windows
서비스를 시작합니다.
startServer 명령은 서버 프로세스를 실행하지만 MBean 메소드를 호출하지 않으므로 이 명령과 함께 사용자 이름 및 비밀번호를 사용할 필요는 없습니다.
- 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 보안 프록시 서버 또는 애플리케이션 서버의 이름입니다.
이 인수는 필수입니다.
이
인수는 선택사항입니다. 이 인수를 지정하지 않으면 서버가 프로파일 이름을 기반으로 지정됩니다.
default 프로파일을 사용하는 경우, <server>
인수가 server1로 설정됩니다. 프로파일 이름이
default가 아닌 경우, <server> 인수가
프로파일 이름으로 설정됩니다.
startServer <adminagent_name>
여기서, adminagent_name은 시작할 관리 에이전트의 이름입니다.
startServer <job_manager>
여기서, job_manager는 시작할 작업 관리자의 이름입니다.
매개변수
다음 옵션은 startServer 명령에 대해 사용 가능합니다.
- -?
- 명령문 사용법을 인쇄합니다.
-curlib <product_library>
기본 작업 제출(SBMJOB) CL 명령에 사용할 현재 라이브러리를 지정합니다.
-cpyenvvar
startServer 명령이 서버 프로세스에 현재 정의된 환경 변수를 설정하도록 지시합니다. 기본값은 현재 정의된 환경 변수를 설정하지 않는 것입니다.
- -help
- 명령문 사용법을 인쇄합니다.
-inllibl <library_list>
기본 작업 제출(SBMJOB) CL 명령에 사용할 초기 라이브러리 목록을 지정합니다.
-inlaspgrp <ASP_group>
기본 작업 제출(SBMJOB) CL 명령의 초기 ASP 그룹을 지정합니다.
-J <java_option>
Java 해석기를 통해 전달할 옵션을 지정합니다.
-jobd <product_library/job_description>
기본 작업 제출(SBMJOB) CL 명령의 작업 설명을 지정합니다.
-jobq <product_library/job_queue>
기본 작업 제출(SBMJOB) CL 명령의 작업 큐를 지정합니다.
-logfile <fileName>
추적 정보를 기록할 로그 파일의 위치를 지정합니다. 기본적으로 로그 파일은 startServer.log라고 하며 logs 디렉토리에서 작성됩니다.
-nowait
실행된 서버 프로세스가 초기화될 때까지 startServer가 대기하지 않도록 지시합니다.
-outq <product_library/output_queue>
기본 작업 제출(SBMJOB) CL 명령의 출력 큐를 지정합니다.
- -profileName
- 다중 프로파일 설치에서 서버 프로세스의 프로파일을 정의합니다. 단일 프로파일 환경에서 실행하기 위해 -profileName 옵션은 필요하지 않습니다. 이 옵션의 기본값은 기본 프로파일입니다.
-quiet
startServer 명령이 정상 모드에서 인쇄하는 진행상황 정보를 표시하지 않습니다.
-replacelog
현재 로그에 추가하는 대신 로그 파일을 바꿉니다.
- -recovery
- 서버가 복구 모드에서 시작되어 트랜잭션 복구를 수행하고 종료되도록 지정합니다.
서버는 복구 모드에 있는 동안 다른 새 트랜잭션을 허용하지 않습니다. 서버를 다시 시작하면
의문시되는 트랜잭션으로 인해 사용 불가능해진 자원이 사용 가능해집니다.
서버가 실패하고 복구 프로세스 중에 새 트랜잭션을 허용하지 않으려면 이 옵션을 사용하십시오.
전이: 이전 제품 버전에서 마이그레이션하는 경우 제어기의 JCL 프로시저 명령문에 포함된 ENV 매개변수가 REC=N 또는 REC=Y 요소를 포함하는지 확인하십시오. ENV 매개변수가 REC=N 또는 REC=Y 요소를 포함하지 않는 경우 -recovery 옵션을 지정해도 서버는 복구 모드로 다시 시작하지 않습니다.ENV 매개변수에 REC=N 요소가 포함된 경우, 서버를 다시 시작할 때 -recovery를 지정하면 설정은 자동으로 REC=Y로 변경됩니다. 제품의 이전 버전에서 마이그레이션하지 않은 경우에는 REC=N 요소는 ENV 매개변수에 자동으로 포함됩니다. 다음은 업데이트된 PROC 문의 예제입니다.
//BBO6ACR PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
startServer 명령에 -recovery 매개변수를 지정하여 호출하는 경우 복구 프로세스가 실패하면 다음 오류 메시지가 SystemErr.log 및 SystemOut.log 파일에서 발생합니다.
이 메시지는 복구 프로세스가 실패했음을 표시하지 않습니다. -recovery 매개변수를 사용하는 경우, 시작할 서버에 대한 SystemErr.log 및 SystemOut.log 파일을 확인하여 복구 프로세스가 성공했는지 판별하십시오.CWNATV03I: xxxxxx 프로파일의 xxxxxx 애플리케이션 서버 복구가 완료되었습니다. 서버가 중지되었습니다.
-sbs <product_library/subsystem_description>
기본 작업 제출(SBMJOB) CL 명령에 사용할 서브시스템을 지정합니다.
-statusport <portNumber>
관리자가 서버 상태 콜백에 대한 포트 번호를 설정할 수 있는 선택적 매개변수. 도구는 이 포트를 열고 서버가 시작되었음을 나타내는 상태 콜백을 서버에서 대기합니다. 이 매개변수가 설정되지 않으면 사용하지 않은 포트가 자동으로 할당됩니다.
-script [<script fileName>] -background
서버 프로세스를 직접 실행하는 대신 startServer 명령으로 실행 스크립트를 생성합니다. 실행 스크립트 이름은 선택적 인수입니다. 실행 스크립트 이름을 제공하지 않으면 startServer 명령에 대한 첫 번째 인수로 전달된 서버 이름을 기반으로 기본 스크립트 파일 이름이 start_server입니다. -background 매개변수는 생성된 스크립트를 실행할 때 백그라운드에서 실행되도록 지정하는 선택적 매개변수입니다.
- -trace
디버깅 목적으로 추적 정보를 로그 파일에 생성합니다.
서버를 시작하는 기본 프로세스 코드의 추적을 사용 가능하게 합니다. 추적 결과는 profile_root/logs 디렉토리에 있는 was_jobname-jobuser-jobnum.log 파일에 로그됩니다.
- -timeout <seconds>
- 서버 초기화가 제한시간 초과되고 오류를 리턴하기까지의 대기 시간을 지정합니다.
-usejobd
Run-As 사용자 ID로 전환하는 경우 서버의 작업 제출(SBMJOB) 프로세스에서 작업 설명을 사용하도록 지정합니다.
참고: 이 명령은 현재 작업 설명의 USER 필드에는 영향을 주지 않습니다.
사용법 시나리오
다음 예제는 올바른 구문을 보여줍니다. 소괄호 안의 정보는 이전 명령을 발행한 경우 작성된 출력에 대한 설명입니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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]](../images/ngzos.gif)
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]](../images/iseries.gif)
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 리턴 코드 캡처 방법은? 이 표는 시작 또는 중지 명령이 제시된 서버에 대한 리턴 코드를 표시합니다.
#!/bin/sh
exitCode=`./startServer.sh server1`
서버 상태 | 리턴 코드 |
---|---|
서버 초기화 실패 | -1 |
서버 초기화 제한시간 초과됨 | -2 |
서버 시작 진행 중 | 1 |
서버가 표시된 애플리케이션을 초기화 중 | 2 |
서버 초기화가 완료됨(정상적 완료) | 0 |
서버 중지 실패 | -10 |
서버 중지 제한시간 초과 | -11 |
서버 중지 조작 시작됨 | 1000 |
서버가 정상적으로 중지됨 | 0 |