如果使用 Windows Installer 命令行参数来运行安装程序,则无需通过用户界面即可安装 Portal for ArcGIS。
注:
如果要升级到 10.9.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 帐户将设置为本地系统帐户。
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>]