EPM Integration Agent 시작 매개변수 구성

EPM Integration Agent에 대한 Oracle Enterprise Performance Management Cloud URL 및 EPM Cloud 도메인의 시작 매개변수는 agentparams.ini 파일에 정의되어 있습니다.

주:

EPM Integration Agent 시작 매개변수를 정의하기 전에, 채워진 EPM_AGENT_HOME 및 EPM_APP_DATA_HOME 매개변수가 포함된 INI 파일을 생성하는 createAppFolder.bat를 실행합니다. 자세한 내용은 애플리케이션 폴더 생성을 참조하십시오.

EPM Cloud 사용자가 사용하는 비밀번호를 암호화하려면 ecryptpassword.bat를 실행해야 합니다. 자세한 내용은 EPM Cloud 사용자 비밀번호 암호화을 참조하십시오.

EPM Integration Agent에서 사용하는 시작 매개변수를 구성하려면 다음을 수행합니다.

C:\EPMAgentData\config 디렉토리로 이동합니다.
agentparams.ini 파일을 두 번 눌러 메모장과 같은 텍스트 편집기로 엽니다.

agentparams.ini 파일이 텍스트 파일로 열립니다.
EPM_AGENT_HOME은 에이전트의 홈 디렉토리 이름입니다. 이 폴더에는 bin 및 lib 폴더가 있습니다.

createappfolder.bat를 실행하면, 스크립트는 채워진 EPM_AGENT_HOME 매개변수를 자동으로 생성합니다.

폴더 이름을 변경하면 에이전트가 새 위치에서 실행되고, 새 EPM_APP_DATA_HOME 폴더에 파일이 생성됩니다.
EPM_APP_DATA_HOME은 config, log, script 폴더를 포함하는 애플리케이션 데이터 폴더의 이름입니다. 구성 폴더에는 현재 사용되지 않는 빈 인증서 폴더도 포함되어 있습니다.

createappfolder.bat를 실행하면, 스크립트는 채워진 EPM_APP_DATA_HOME 매개변수가 포함된 INI 파일을 생성합니다.
AGENT_NAME에서 EPM Integration Agent의 고유 이름을 지정합니다.

이름에는 문자와 숫자만 사용할 수 있습니다. AGENT_NAME에는 기호 또는 공백을 포함할 수 없습니다.
CLUSTER에서 에이전트가 속한 클러스터의 이름을 지정합니다.

이름에는 영숫자 문자만 사용할 수 있습니다. 기호(@) 또는 앰퍼샌드(&)와 같은 특수 문자는 사용하지 마십시오. 클러스터가 생성된 후에는 이름을 수정할 수 없습니다.

기본 클러스터 이름은 EPMCLUSTER입니다.

주:

클러스터 이름이 Data Integration에 이미 정의되어 있어야 여기서 참조할 수 있습니다. 자세한 내용은 클러스터 추가를 참조하십시오.

이 매개변수는 필수입니다.
PORT에서 EPM Integration Agent가 실행되는 포트 번호를 지정합니다.

이 매개변수는 필수입니다.
CLOUD_URL에서 에이전트를 인증하고 시작하는 데 사용되는 EPM Cloud URL을 지정합니다.

에이전트와 연계된 EPM 인스턴스의 URL입니다. 예를 들면 다음과 같습니다.

https://example-pbcs.us1.oraclecloud.com

주:
Cloud_URL 끝에 "epmcloud" 또는 "HyperionPlanning"을 포함하지 마십시오.

이 매개변수는 필수입니다.
CLOUD_DOMAIN에서 EPM Cloud URL의 고유 이름을 지정합니다.

ID 도메인은 서비스 인스턴스에 액세스해야 하는 사용자 계정을 제어합니다. 인증된 사용자가 액세스할 수 있는 기능도 제어합니다. 서비스 인스턴스는 ID 도메인에 속합니다.

관리자가 사용자에게 표시되는 도메인 이름을 업데이트할 수 있지만, Data Management에는 고객이 서비스에 등록할 때 제공된 원래 도메인 이름이 필요합니다. Data Management에서 EPM Cloud 연결을 설정하는 경우 별칭 도메인 이름을 사용할 수 없습니다.

주:
Gen 2 데이터 센터를 제외하면 CLOUD_DOMAIN 매개변수는 필수입니다.
CLOUD_USER_NAME에서 EPM Cloud 환경에 있는 관리자 사용자 이름을 지정합니다.

사용자 이름은 SSO 사용자 이름이 아닌 고유 사용자여야 합니다.

이 매개변수는 필수입니다.
CLOUD_PASSWORD에서 관리자 사용자의 암호화된 비밀번호 문자열을 지정합니다.

EPM Cloud 사용자의 비밀번호를 암호화하고 encryptpassword.bat(Windows의 경우) 또는 ecryptpassword.sh(Linux의 경우)를 실행하여 암호화된 비밀번호 문자열을 가져올 수 있습니다. 자세한 내용은 EPM Cloud 사용자 비밀번호 암호화를 참조하십시오.

이 매개변수는 필수입니다.
LOG_LEVEL에서 로컬 EPM Integration Agent 로그 레벨을 지정합니다.

적합한 로그 레벨은 다음과 같습니다.
- ALL - 가장 세부적인 레벨을 표시하고 모든 로그 명령문을 인쇄합니다.
- INFO - 중요한 선택된 로그를 인쇄합니다.
- ERROR - 최소 로깅을 수행합니다. 심각한 오류만 인쇄됩니다.
모든 로그는 APPDATA_HOME\logs 폴더에 있는 파일에 기록됩니다.

이 매개변수는 선택 사항입니다. 모두이 기본 로그 레벨입니다.
POLL_INTERVAL에서 비동기 모드로 대기 및 폴링하는 시간 간격을 지정합니다.

시간 간격은 초 단위로 지정됩니다. 기본 시간 간격은 120초입니다.
REGISTER_WITH_IP에서 에이전트를 호스트 이름으로 등록하려면 N을 지정합니다. 에이전트를 IP 주소로 등록하려면 Y를 지정합니다.

이 매개변수는 선택 사항입니다.
EXECUTION_POOL_SIZE에서 병렬로 실행할 수 있는 작업 수를 지정합니다.

기본 실행 풀 크기는 2입니다.

이 매개변수는 선택 사항입니다.
JYTHON_HOME에서 Jython이 설치된 최상위 레벨 디렉토리를 지정합니다.

Jython을 스크립팅 언어로 사용하는 경우에만 필요합니다.
GROOVY_HOME에서 Groovy가 설치된 최상위 레벨 디렉토리를 지정합니다.

Groovy를 스크립팅 언어로 사용하는 경우에만 필요합니다.
CUSTOM_MEM_ARGS에서 Java에 전달된 표준 메모리 인수를 사용자정의 메모리 인수로 대체할 변수를 지정합니다.

예를 들어 CUSTOM_MEM_ARGS=-Xms128m -Xmx4096m 매개변수에서 128MB는 최소 초기 메모리 크기이고 4096은 최대 메모리 크기입니다.

이 매개변수는 선택 사항입니다.
CUSTOM_JAVA_OPTIONS에서 추가 Java 런타임 매개변수를 지정합니다.

EPM Integration Agent가 프록시 인증 방법을 사용하도록 CUSTOM_JAVA_OPTIONS 설정을 구성할 수도 있습니다.

시스템은 다음과 같은 인증 방법을 지원합니다.
- 단순
- 기본
- 다이제스트
- NTLM
프록시 인증 방법을 사용하는 경우 프록시 인증 방법에 따라 프록시 호스트 이름, 프록시 포트, 프록시 사용자 이름, 암호화된 비밀번호를 이 필드에 지정합니다.

프록시에서 기본 인증을 사용하는 경우 CUSTOM_JAVA_OPTIONS를 다음과 같이 설정합니다.
-Djdk.http.auth.tunneling.disabledSchemes=""

주:

jdk.http.auth.tunneling.disabledSchemes 네트워킹 속성에 기본값을 추가하면 Oracle Java Runtime에서 기본 인증 체계가 기본적으로 비활성화되었습니다. 결과적으로 HTTPS용 터널을 설정할 때 기본 인증을 요구하는 프록시는 더 이상 기본적으로 성공하지 못합니다. 필요한 경우 이 인증 체계를 jdk.http.auth.tunneling.disabledSchemes 네트워킹 속성에서 제거하여 다시 활성화할 수 있습니다.

단순 프록시 인증 방법:

단순 프록시 인증을 사용하려면 위의 NTLM_PROXY_AUTH 필드를 N으로 설정하고 CUSTOM_JAVA_OPTIONS에 다음 매개변수를 포함합니다.

HTTP의 경우 -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=80을 지정합니다.

HTTPS의 경우 -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=443을 지정합니다.

기본 또는 다이제스트 프록시 인증 방법:

기본 또는 다이제스트 프록시 인증을 사용하려면 위의 NTLM_PROXY_AUTH 필드를 N으로 설정하고 CUSTOM_JAVA_OPTIONS에 다음 매개변수를 포함합니다.

-DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword

NTLM 프록시 인증 방법:

NTML 프록시 인증을 사용하려면 NTLM_PROXY_AUTH를 Y로 설정하고 CUSTOM_JAVA_OPTIONS의 매개변수에 다음을 포함합니다.

-DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword -DproxyDomain=domain
CUSTOM_INTERFACE_CLASS_NAME에서 EpmAgentInterface를 구현하는, custom.jar에 있는 클래스의 정규화된 클래스 이름을 지정합니다.

예를 들어 com.mycompany.agent.implementation.MyImplementation을 지정합니다.

이 매개변수는 선택 사항입니다.
CUSTOM_CLASS_PATH에서 jar의 전체 경로와 이름(예: C:\AgentDeployment\agenthome\myJarFolder\custom.jar)을 지정합니다.

이 매개변수는 선택 사항입니다.

EPM Integration Agent에서 JDBC(Microsoft Java Database Connectivity) 드라이버를 사용하여 SQL Server에 연결하는 경우 EPM Integration Agent에서 SQL Server용 Microsoft JDBC 드라이버 구성을 참조하십시오.
NTLM_PROXY_AUTH에서 NTLM 프록시 인증 방법을 사용하도록 Y를 지정합니다.

NTLM 프록시 인증을 사용하는 경우 CUSTOM_JAVA_OPTIONS에 프록시 매개변수도 추가로 지정해야 합니다.

기본 또는 다이제스트 프록시 인증을 사용하거나 프록시 인증을 사용하지 않는 경우 N을 지정합니다.

주:

스크립팅에 Jython 또는 Groovy를 사용하려는 경우 JYTHON_HOME 또는 GROOVY_HOME을 설정합니다.

확장에 사용자정의 Java를 사용하려는 경우 CUSTOM_JAVA_OPTIONS, CUSTOM_INTERFACE_CLASS를 설정합니다.
AMW_IDLE_TIME에서 자동 유지관리 기간(AMW) 작동 중지 시간 중에 또는 스케줄링되지 않은 유지관리 중에 비동기 모드로 실행되는 에이전트에 대한 유휴 시간 값을 지정합니다.

AMW_IDLE_TIME 매개변수 값은 분 단위로 설정되며 기본 설정은 15분입니다. 고객은 유휴 시간을 더 길게 정의할 수 있으나 유휴 시간 값을 15분 미만으로 지정해서는 안 됩니다. AMW 작동 중지 시간은 비즈니스 프로세스에 대한 자동화된 유지관리 태스크가 실행되는 연속 시간 간격입니다.
Client_ID에서 ID 도메인 관리자가 OAuth에 맞게 모바일 애플리케이션을 구성할 때 생성된 클라이언트 ID를 입력합니다. 애플리케이션 구성 탭의 일반 정보에 표시되어 있습니다. 자세한 내용은 EPM Integration Agent에서 OAUTH 옵션 사용을 참조하십시오.

클라이언트 ID는 ID 도메인 관리자가 OAuth에 대해 모바일 애플리케이션을 구성할 때 생성됩니다. 애플리케이션 구성 탭의 일반 정보에 표시되어 있습니다.
ENABLE_AUTO_COMMIT에 자동 커밋 동작을 지정합니다.

ENABLE_AUTO_COMMIT 매개변수가 모든 데이터베이스 작업이 수행될 때 커밋되는 트랜잭션인지 여부를 결정합니다. 이 매개변수는 자동 커밋을 기본적으로 수행하는 일부 버전의 JDBC 드라이버(예: IBM DB2)에서 에이전트를 처리하는 중에 발생할 수 있는 오류를 해결합니다.

기본값은 N입니다.
RETRY_INTERVAL에 지정된 시간(초) 후에 재시도할 논리 주기를 지정합니다.

기본값은 10(초)입니다.
FILE_UPLOAD_SIZE에 선택한 메가바이트(MB) 값씩 반복해서 업로드할 파일 크기를 지정합니다.

기본적으로 파일 업로드 크기는 50 (MB)입니다.
agentparamas.ini 파일에 대한 모든 변경사항을 저장합니다.

시작 매개변수를 정의한 경우 EPM Integration Agent를 진단 모드로 실행할 수 있으므로 에이전트를 시작할 수 없을 때 EPM Integration Agent 시작 매개변수 또는 네트워크 연결에 대한 이슈를 파악할 수 있습니다. 자세한 내용은 EPM Integration Agent를 진단 모드로 실행을 참조하십시오.