Portal for ArcGIS는 Windows Installer 명령줄 매개변수를 사용하여 설치 프로그램을 실행하는 방식으로 UI 없이 설치할 수 있습니다.
비고:
11.1으로 업그레이드하는 경우 자세한 내용은 Portal for ArcGIS 업그레이드를 참고하세요.
Portal for ArcGIS 설치 준비
- 최소 시스템 요구 사항을 충족하는지 확인합니다.
- 관리 권한이 있는 사용자로 머신에 로그인합니다.
- Portal for ArcGIS에서 사용하는 포트에 설명된 대로 포트를 엽니다.
- 중요하지 않은 모든 응용프로그램을 서버에서 닫습니다.
- 아래에 설명된 대로 설치 명령을 실행합니다.
Portal for ArcGIS 자동 설치
다음은 Portal for ArcGIS를 자동 설치할 때 사용할 Windows Installer 명령줄 매개변수입니다. 이러한 명령을 사용하여 Portal for ArcGIS 또는 포털 콘텐츠 디렉터리의 설치 위치를 지정할 수 있습니다.
ACCEPTEULA=yes
이 등록정보는 자동 설치 중에 최종 사용자 라이선스 동의서(EULA)에 동의하는 데 필요합니다. EULA에 동의하고 소프트웨어를 설치하려면 예를 선택합니다. 아니요를 선택하거나 이 등록정보를 생략하면 설치가 실패합니다. 다운로드에는 EULA의 PDF 버전이 포함되어 있습니다. EULA.pdf 파일은 \Documentation 폴더에 있습니다.
INSTALLDIR=<installation location>
이 등록정보를 사용하여 명령줄에서 Portal for ArcGIS 설치 위치를 지정할 수 있습니다. 이 등록정보를 설정하지 않으면 기본 설치 위치 C:\Program Files\ArcGIS\Portal가 사용됩니다.
CONTENTDIR=<installation location content>
이 등록정보를 사용하여 포털의 콘텐츠 디렉토리를 지정할 수 있습니다. 지정한 위치는 로컬 디렉터리여야 합니다. 공유 네트워크 디렉터리는 선택할 수 없습니다. 이는 Portal for ArcGIS 서비스가 기본 설정에 따라 Windows의 기본 LocalSystem 계정으로 실행되도록 구성되었기 때문입니다. LocalSystem 계정은 네트워크 위치에 접근할 수 없습니다. 자세한 내용은 Portal for ArcGIS 계정을 참고하세요. 이 등록정보를 설정하지 않으면 기본 설치 위치 C:\arcgisportal가 사용됩니다.
다음은 예시 위치입니다.
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes INSTALLDIR=C:\myportal CONTENTDIR=C:\arcgisportal
명령줄 매개변수를 사용하여 Portal for ArcGIS 계정 구성
Portal for ArcGIS 계정은 Portal for ArcGIS를 자동으로 설치한 경우 구성해야 합니다. 생산 시스템의 경우 도메인 또는 Active Directory에 있는 기존 계정을 지정하고 기관의 보안 정책을 따르는 것이 좋습니다. 명령줄 매개변수가 자동 설치 시 Portal for ArcGIS 계정을 구성하는 데 사용되지 않는 경우 계정은 로컬 시스템 계정으로 설정됩니다. 이는 Portal for ArcGIS를 쉽고 빠르게 설치하기 위한 기본 사항입니다.
아래의 명령줄 매개변수를 사용하여 Portal for ArcGIS 계정을 구성합니다.
Portal for ArcGIS 계정 자격 증명 직접 전달
주의:
Portal for ArcGIS 계정이 자동(/qb) 설치 시 정의되지 않거나 자격 증명이 유효하지 않은 경우 Portal for ArcGIS 설정에서는 설치 시 경고 메시지가 표시됩니다. 확인을 클릭하여 메시지를 닫을 수 있습니다. 이 상태에서 Portal for ArcGIS 계정이 LocalSystem 계정으로 설정됩니다.
USER_NAME=<운영 체제 계정>
계정은 도메인 계정 또는 로컬 계정이 될 수 있습니다. 도메인 계정을 사용 중인 경우 계정이 이미 있어야 합니다. 로컬 계정을 사용 중인 경우 계정이 아직 없으면 생성됩니다. 계정이 유효하지 않은 경우 계정 또는 비밀번호가 잘못되었음을 나타내는 메시지가 설치 중에 나타납니다.
MSA=TRUE
이 매개변수는 관리 서비스 계정에만 사용해야 합니다. 관리 서비스 계정은 이미 도메인에 있어야 합니다. 비밀번호가 있는 도메인 계정이나 로컬 계정에는 이 매개변수를 사용하지 마세요. 관리 서비스 계정은 PASSWORD 매개변수를 사용하지 않습니다.
PASSWORD=<계정 비밀번호>
USER_NAME 매개변수에 지정된 계정의 비밀번호입니다. 비밀번호가 유효하지 않은 경우 계정 또는 비밀번호가 잘못되었음을 나타내는 메시지가 설치 중에 나타납니다.
아래에 예시가 나와 있습니다.
주의:
명령줄 매개변수는 대/소문자를 구분합니다. 명령줄 설치 작업을 가져오는 데 문제가 있는 경우 예시에 표시된 대로 대/소문자가 등록정보와 일치하는지 확인합니다.
도메인 계정 사용
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\mydomainaccount PASSWORD=my.password
신규 또는 기존 로컬 계정 사용
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password
관리 서비스 계정 사용
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa
포털 구성 파일을 사용하여 Portal for ArcGIS 계정 자격 증명 가져오기
다음과 같은 두 개의 명령줄 매개변수는 포털 구성 파일을 사용하여 Portal for ArcGIS 계정 자격 증명을 가져오는 데 함께 사용해야 합니다.
ACCOUNT=UseConfigFile
위에 표시된 대로 정확하게 ACCOUNT 명령줄 매개변수를 사용합니다. 이 등록정보에 유효한 다른 값이 없습니다.
CONFIGPATH=<포털 구성 파일의 전체 경로 및 이름>
ACCOUNT=UseConfigFile 조합에 사용되는 이 등록정보를 통해 Portal for ArcGIS 계정을 구성하는 데 사용될 포털 구성 파일을 지정할 수 있습니다. 포털 구성 파일은 Portal for ArcGIS 설치 시 포털 구성 파일을 내보내어 생성됩니다(이전 설치 또는 기타 머신에서).
예를 들면 다음과 같습니다.
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml
주의:
명령줄 매개변수는 대/소문자를 구분합니다. 명령줄 설치 작업을 가져오는 데 문제가 있는 경우 예시에 표시된 대로 대/소문자가 등록정보와 일치하는지 확인합니다.
포털 구성 파일로 Portal for ArcGIS 계정 자격 증명 내보내기
비고:
포털 구성 파일을 네트워크 공유에 내보낼 때 Portal for ArcGIS가 설치 중인 머신에 있는 로컬 시스템 계정은 네트워크 공유에 대한 쓰기 권한이 있어야 합니다. 예를 들어 Quick이라는 이름의 머신에 Portal for ArcGIS를 설치하는 경우 Quick에 있는 로컬 시스템 계정에는 네트워크 공유에 대한 쓰기 권한이 있어야 합니다. 권한이 설정되지 않은 경우 포털 구성 파일을 성공적으로 내보낼 수 없습니다. 네트워크 공유에 대해 올바르게 권한을 설정하는 방법을 모르는 경우 시스템 관리자에게 문의하거나 포털 구성 파일을 로컬로 내보내고 네트워크 공유에 복사합니다.
다음과 같은 두 개의 명령줄 매개변수는 포털 구성 파일로 Portal for ArcGIS 계정 자격 증명을 내보내는 데 함께 사용해야 합니다.
EXPORTCONFIG=Yes
이 등록정보를 사용하여 USER_Name 및 PASSWORD 명려줄 매개변수로 입력한 계정 정보를 내보냅니다. 계정 정보는 포털 구성 파일이라고 하는 암호화된 XML 파일에 저장됩니다. 이 등록정보는 기본적으로 No로 설정됩니다.
CONFIGPATH=<포털 구성 파일의 전체 경로 및 이름>
EXPORTCONFIG=Yes 조합에 사용되는 이 등록정보를 통해 포털 구성 파일의 이름과 저장될 위치를 지정할 수 있습니다. 파일 이름은 .xml로 끝나야 하며 지정된 폴더가 이미 있어야 합니다. 파일에 .xml 익스텐션이 없고 지정한 디렉터리가 아직 없는 경우 포털 구성 파일 생성을 성공적으로 수행할 수 없습니다.
예를 들면 다음과 같습니다.
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes EXPORTCONFIG=Yes CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml
주의:
명령줄 매개변수는 대/소문자를 구분합니다. 명령줄 설치 작업을 가져오는 데 문제가 있는 경우 예시에 표시된 대로 대/소문자가 등록정보와 일치하는지 확인합니다.
createportal 명령줄 유틸리티를 사용하여 포털 생성
Portal for ArcGIS를 설치하면 createportal 명령줄 유틸리티를 사용하여 포털을 생성할 수 있습니다. createportal 유틸리티는 다음과 같은 방법으로 사용할 수 있습니다.
- 명령 프롬프트에서 관리자 권한으로 createportal 유틸리티를 실행하고 이름, 성, 사용자 이름, 비밀번호, 이메일 주소, 본인 확인 질문, 대답 및 콘텐츠 디렉터리 매개변수를 지정합니다.
- 지정된 매개변수가 포함된 createportal.properties 파일을 제공합니다.
createportal 명령줄 유틸리티를 사용하려면 다음과 같이 -h 또는 -help를 사용하여 createportal.bat 스크립트를 실행합니다.
<Portal for ArcGIS Installation Directory>\tools\createportal\createportal.bat -help
유틸리티 사용 예시: createportal.bat [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [-lf <arg>] [-ut <arg>]
파일 사용 예시: createportal.bat [-f <FILE>]
비고:
createportal.properties 파일에서 경로를 참조할 때 백슬래시를 이스케이프 문자로 사용해야 합니다(예시: C:\\arcgisportal 또는 \\\\<Absolute path to>\\<portal arcgisportal>).
| 옵션 | 설명 |
|---|---|
-fn; --firstname | 포털을 구성하는 데 사용되는 초기 관리 계정의 이름입니다. 여러 단어로 된 항목은 따옴표로 묶어야 합니다. |
-ln; --lastname | 포털을 구성하는 데 사용되는 초기 관리 계정의 성입니다. 여러 단어로 된 항목은 따옴표로 묶어야 합니다. |
-u; --username | 포털을 구성하는 데 사용되는 초기 관리 계정의 사용자 이름입니다. 사용자 이름은 숫자(0~9), ASCII 문자(a~z 및 A~Z), 점(.)으로 구성될 수 있습니다. |
-p; --password | 포털을 구성하는 데 사용되는 초기 관리 계정의 비밀번호입니다. 비밀번호는 숫자(0~9), ASCII 문자(a~z 및 A~Z), 점(.)으로 구성될 수 있습니다. |
-e; --email | 포털을 구성하는 데 사용되는 초기 관리 계정의 이메일 주소입니다. |
-qi; --question | 잊어버린 비밀번호를 검색할 본인 확인 질문의 색인입니다. 각 색인 번호가 있는 사용 가능한 질문은 다음과 같습니다.
|
-qa; --answer | 매개변수 -qi에 대해 선택한 본인 확인 질문에 대한 대답입니다. 여러 단어로 된 항목은 따옴표로 묶어야 합니다. |
-d; --contentDirectory | 포털에서 호스팅되는 데이터를 저장하는 데 사용되는 콘텐츠 디렉터리의 절대 경로 및 이름입니다. 기본 설정에 따라 포털 콘텐츠 디렉터리는 이 위치에 로컬로 생성됩니다. C:\arcgisportal 또는 \\<Absolute path to>\<Content Directory> |
-lf; --licenseFile | 포털 라이선스 파일의 경로입니다. |
-ut; --userTypeId | 초기 관리자의 사용자 유형 ID입니다. 매개변수는 선택 사항입니다. -ut 매개변수에 대해 기관에서 사용 가능한 호환되는 사용자 유형 목록을 생성하려면 listadministratorusertypes 유틸리티를 실행합니다. 사용자 유형 ID가 지정되지 않고 포털 라이선스 파일에 호환되는 단일 사용자 유형이 포함되어 있으면 해당 사용자 유형이 할당됩니다. 라이선스 파일에 호환되는 다중 사용자 유형이 포함되어 있으면 임시 사용자 유형이 할당되고 초기 관리자가 로그인 후에 사용자 유형을 선택해야 합니다. |
-f; --file | createportal 유틸리티의 등록정보 파일입니다. 기본 설정에 따라 createportal.properties 파일은 다음 위치에 있습니다. <Portal for ArcGIS Installation Directory>/tools/createportal |
-h; --help | 명령줄 도움말을 표시하고 종료합니다. |
다음은 createportal.properties 파일의 예시입니다.#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g username@domain.com
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally.
# e.g. C:\\arcgisportal, or \\\\<Absolute path to>\\<portal arcgisportal>
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =
도구를 종료하기 전에 포털이 성공적으로 생성되었다는 메시지가 표시됩니다.
listadministratorusertypes 명령줄 유틸리티를 사용하여 호환되는 사용자 유형 식별
관리자 역할과 호환되는 기관에 대한 라이선스가 부여된 사용자 유형 ID 목록을 식별하려면 listadministratorusertypes 명령줄 유틸리티를 실행합니다. 그러면 createportal 도구의 -ut 매개변수에 대한 입력 목록이 제공됩니다. 포털 라이선스 파일을 입력으로 사용하여 아래와 같이 -la로 도구를 실행합니다.
<Portal for ArcGIS Installation Directory>\tools\createportal\listadministratorusertypes.bat
유틸리티 사용 예시: listadministratorusertypes.bat [-la <arg>] 또는 listadministratorusertypes.bat [--listadministratorusertypes <arg>]