부트스트랩 특성은 특정 서버의 런타임 환경을 초기화합니다.
일반적으로 이들은 런타임 코어의 구성 및 초기화에 영향을 주는 속성입니다.
이 태스크 정보
부트스트랩 특성은 bootstrap.properties라는 텍스트
파일에 설정됩니다. 이 파일은 필수가 아니므로 사용자가 작성하지 않으면 존재하지 않습니다. 서버 디렉토리에
이 파일을 작성해야 하며, 서버 디렉토리에는 구성 루트 파일 server.xml도 있습니다.
기본적으로 서버 디렉토리는 usr/servers/server_name입니다.
Liberty 환경의 사용자 정의에서
설명한 대로 서버 디렉토리를 변경할 수 있습니다.
WebSphere® Application Server Developer Tools for Eclipse에서 편집기를 사용하여 bootstrap.properties 파일을 작성할 수 있습니다.
서버 보기에서 구성하려는 서버를 마우스 오른쪽 단추로 클릭한 후
새로 작성을 선택하고 서버 환경 파일을 선택한 후
bootstrap.properties를 선택하면 파일이 템플리트에서 작성되어 편집기에서 열립니다.
server.xml 및 server.env 파일과 함께
bootstrap.properties 파일이 서버 보기에서
연관된 서버 아래에 표시되며 이 파일을 두 번 클릭하면 편집할 수 있습니다.
WebSphere Application Server Developer Tools for Eclipse에서 편집기 또는
문서 편집기를 사용하여 bootstrap.properties 파일을 편집할 수 있습니다.
bootstrap.properties 파일을 업데이트하는 경우, 변경사항을 적용하려면 서버를 다시 시작해야 합니다.
bootstrap.properties 파일에는 두 가지 유형의 특성이 있습니다.
- 소규모의, 사전 정의된 초기화 특성 세트
- 정의하기 위해 선택하는 사용자 정의 특성. 이러한 사용자 정의 특성을 다른 구성 파일(예:
server.xml 및 포함 파일)에서 변수로 사용할 수 있습니다.
- 사전 정의된 특성을 사용하여 추적 및 로깅을 구성하십시오.
추적 및 로깅의 사전 정의된 특성 목록은 로깅 및 추적의 내용을 참조하십시오.
- OSGi 프레임워크 진단을 위해 사전 정의된 특성을 사용하십시오. 예를 들어, 다음과 같이 OSGi 콘솔을 위한 포트를 설정하십시오.
osgi.console = 5678
추가 정보는 OSGi 콘솔 사용의 내용을 참조하십시오.
- OSGi 프레임워크 확장기능을 위해 사전 정의된 특성을 사용하십시오.
외부 모니터링 도구에 이 특성이 필요한 경우 org.osgi.framework.bootdelegation을 지정하십시오.
값은 쉼표로 구분된 패키지 목록입니다.
- 구성 비밀번호 암호화를 위해 사전 정의된 특성을 사용하십시오. 추가 정보는 Liberty: 비밀번호 암호화를 통한 보호의 한계의 내용을 참조하십시오.
- 사용자 정의 특성을 사용하여 웹 애플리케이션의 기본 포트를 정의하십시오.
시스템별 또는 환경별 사용자 정의를 허용하는 다양한 개발 환경 사이에서
server.xml을 공유하고 XML 구성 파일을 사용할 수 있습니다. 예:
- bootstrap.properties 파일에서 default.http.port 및 default.https.port 특성을 지정하십시오.
default.http.port = 9081
default.https.port = 9444
참고: 이 특성을 지정하지 않을 경우, 기본 HTTP 포트는 9080이고 HTTPS 포트는
9443입니다. 기본 HTTP 엔드포인트 정의를 대체하려면 서버 구성에서
httpEndpoint 요소의 id 속성을
defaultHttpEndpoint로 설정하십시오.
- server.xml 구성 파일에서 다음 특성을 사용하십시오.
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="${default.http.port}"
httpsPort="${default.https.port}" />
참고: host="*"은 모든 어댑터를 청취함을 의미합니다. 기본적으로 서버는 주소 127.0.0.1/localhost만을 청취하고 있습니다.
또한 host 특성을 사용하여 단일 IP 주소를 지정할 수 있으며
이 경우 시스템은 지정된 어댑터만을 청취합니다.
- 사용자 정의 특성을 사용하여 명령 포트를 설정하십시오.
서버 스크립트가 실행 중인 Liberty 서버와 통신하고
특정 조작(예: Liberty 서버 중지 또는
Java™ 덤프 실행)을 요청할 수 있도록
명령 포트를 설정하십시오. 보안의 경우 명령 포트에는 원격으로 액세스할 수 없으며 클라이언트에게 명령을 발행하기 위한 권한을 부여받으려면 서버 출력 디렉토리에 대한 읽기/쓰기 액세스 권한이 있어야 합니다.
z/OS®의 쉘 스크립트에서 Liberty 서버를 시작하는 경우, 기본적으로 Liberty 서버는 명령 리스너가 사용할 임시 포트를 확보합니다. z/OS에서 시작 태스크로서 Liberty 서버를 시작하는 경우, 기본적으로 명령 포트는
처음에는 사용되지 않으며 모든 서버 관리 태스크는 z/OS 운영자 콘솔에
발행된 modify 명령을 사용하여 수행됩니다. 이러한 명령은 z/OS에서 Liberty 관리에 설명되어 있습니다. command.port 특성을 사용하여
Liberty 서버의 기본 동작을 대체할 수 있습니다.
- 올바른 값
- -1
- 명령 포트는 사용 안함으로 설정됩니다.
- 0
- 임시 포트는 런타임에 선택됩니다.
- 1-65535
- 사용자 지정 포트입니다.
- 기본값
- 0
- 서버가
z/OS의 쉘 스크립트에서 시작된 경우, 임시 포트는 런타임에 선택됩니다.
- -1
- 서버가 z/OS에서 시작 태스크로 시작되는 경우, 명령 포트는 사용 안함으로 설정됩니다.
참고:
서버가 z/OS에서 시작 태스크로 실행되고 있지 않는 한 명령 포트를 사용 안함으로 설정하지 않는 것이 좋습니다.
명령 포트를 사용하지 않으면 일부 조작을 요청하는 서버 스크립트를 사용할 수 없습니다(예: Liberty 서버 중지 또는 Java 덤프 실행).
- 사용자 정의 특성을 사용하여 서버 시작 대기 시간을 구성하십시오.
server.start.wait.time 특성을 boostrap.properties
파일에 추가하여 제품 기본 설정을 넘어 서버 시작 대기 시간을 늘릴 수 있습니다. server.start.wait.time은 초 단위로 지정됩니다.
- bootstrap.properties 파일에서 server.start.wait.time 특성을 지정하십시오. 다음 예는 서버 시작 시간을 25초로 설정합니다.
server.start.wait.time = 25
이 설정은 서버가 시작될 때 서버의 보고 메커니즘이 시작의 완료된 단계에 대한 보고를 하려고 시도함을 의미합니다. 서버에 대한 보고 메커니즘이 25초 내에 그 기능을 수행할 수 없는 경우 오류 22가 발생합니다.
bootstrap.properties 파일에 server.start.wait.time 특성을 추가하지 않으면 기본 서버 시작 대기 시간이 내부적으로 30초로 설정됩니다.
사용자 정의 특성을 사용하여 엔젤 이름을 설정하십시오. 이름 지정된 엔젤에 대한 자세한 정보는 이름 지정된 엔젤의 내용을 참조하십시오.
사전 정의된 특성을 사용하여 서버가 연결해야 하는 엔젤 프로세스를 표시하십시오. 기본적으로
이 엔젤 프로세스가 사용 가능한 경우 서버가
이름 지정되지 않은 기본 엔젤 프로세스에 연결합니다.
- 이름 지정된 특정 엔젤에 연결하려면 com.ibm.ws.zos.core.angelName 특성을
이름 지정된 엔젤로 설정하십시오.
com.ibm.ws.zos.core.angelName=named_angel
사용자 정의 특성을 사용하여 서버가 시작할 수 있도록 서버가 실행 중인 엔젤 프로세스에 연결되게끔
요구하십시오. 기본적으로 서버를 시작하는 데 엔젤 프로세스가 필요하지 않습니다. 그러나 엔젤 프로세스가 없는 경우
일부 시스템 서비스를 사용할 수 없습니다.엔젤 프로세스에 대한 자세한 정보는
z/OS에서의 프로세스 유형의 내용을 참조하십시오.
- 서버 시작에 엔젤 프로세스가 필요함을 표시하려면
com.ibm.ws.zos.core.angelRequired 특성을 true로 설정하십시오.
com.ibm.ws.zos.core.angelRequired=true
- 변경사항을 적용하려면 서버를
다시 시작하십시오.