Skip To Content

Instalando silenciosamente o Portal for ArcGIS

O Portal for ArcGIS pode ser instalado sem uma interface de usuário executando a configuração utilizando os parâmetros da linha de comando do Windows Installer.

Anotação:

Se você estiver atualizando para 11.3, consulte Sobre atualizar Portal for ArcGIS para mais informações.

Preparando para instalar o Portal for ArcGIS

  1. Verifique se o site atende os requisitos de sistema mínimos.
  2. Entre na sua máquina como um usuário com privilégios administrativos.
  3. Abra as portas como descrito em Portas utilizadas pelo Portal for ArcGIS.
  4. Feche todos os aplicativos não críticos no seu servidor.
  5. Execute os comandos de instalação como descrito abaixo.

Instalando o Portal for ArcGIS silenciosamente

Abaixo estão os parâmetros da linha de comando do Windows Installer para utilizar ao instalar o Portal for ArcGIS silenciosamente: Utilize estes comandos para especificar o local da instalação do Portal for ArcGIS ou diretório de conteúdo do seu portal.

  • ACCEPTEULA=yes

    Esta propriedade é exigida para aceitar o Contrato de Licença do Usuário Final (EULA) durante uma instalação silenciosa. Especifique sim para concordar com o EULA e instalar o software. Especificar não ou omitir essa propriedade resultará em uma instalação com falha. O download contém uma versão em PDF do EULA. O arquivo EULA.pdf está localizado na pasta \Documentation

  • INSTALLDIR=<installation location>

    Esta propriedade permite especificar o local de instalação do Portal for ArcGIS a partir da linha de comando. Se você não configurar esta propriedade, o local de instalação padrão do C:\Program Files\ArcGIS\Portal é utilizado.

  • CONTENTDIR=<installation location content>

    Esta propriedade permite que você especifique o diretório de conteúdo do portal. O local que você especifica deve ser um diretório local; você não pode escolher um diretório de rede compartilhado. Isto é devido ao fato do serviço do Portal for ArcGIS estar configurado para executar na conta LocalSystem nativa do Windows por padrão. A conta LocalSystem não pode acessar locais de rede. Para mais informações, consulte A conta do Portal for ArcGIS . Se você não configurar esta propriedade, o local de instalação padrão do C:\arcgisportal é utilizado.

O seguinte é uma localização de exemplo:

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes INSTALLDIR=C:\myportal CONTENTDIR=C:\arcgisportal

Configurando a conta do Portal for ArcGIS utilizando parâmetros da linha de comando

A conta do Portal for ArcGIS deve ser configurado quando o Portal for ArcGIS estiver instalado silenciosamente. Para sistemas de produção, é recomendado que você designe uma conta pré-existente que esteja em seu domínio ou Diretório Ativo e siga a política de segurança da sua organização. Se os parâmetros da linha de comando não forem usados ​​para configurar a conta do Portal for ArcGIS durante as instalações silenciosas, a conta será definida como a conta do Sistema Local. Isto é principalmente para a conveniência de uma rápida instalação do Portal for ArcGIS.

Use os parâmetros da linha de comando abaixo para configurar a conta do Portal for ArcGIS.

Passando as credenciais da conta do Portal for ArcGIS diretamente

Aviso:

Se a conta do Portal for ArcGIS não for definida durante uma instalação silenciosa (/qb) ou as credenciais não forem válidas, a configuração do Portal for ArcGIS exibirá uma mensagem de aviso durante a instalação. A mensagem pode ser fechada clicando em OK. Sob estas circunstâncias, a conta do Portal for ArcGIS é configurada na conta de Sistema Local.

  • USER_NAME=<conta do sistema operacional>

    A conta pode ser uma conta de domínio ou uma conta local. Se você estiver utilizando uma conta de domínio, ela já deverá existir. Se você estiver utilizando uma conta local, a conta será criada se ainda não existir. Se a conta não for válida, uma mensagem aparecerá durante a instalação indicando que a conta ou senha é inválida.

  • MSA=TRUE

    Este parâmetro deve ser utilizado somente com uma Conta de Serviço Gerenciado. Uma Conta de Serviço Gerenciado já deve existir em seu domínio. Não utilize este parâmetro com uma conta local ou uma conta de domínio com senha. Uma Conta de Serviço Gerenciado não utilizará o parâmetro PASSWORD.

  • PASSWORD=<senha da conta>

    Esta é a senha da conta especificada para o parâmetro USER_NAME. Se a senha não for válida, uma mensagem aparecerá durante a instalação indicando que a conta ou senha é inválida.

Os exemplos estão abaixo.

Aviso:

Os parâmetros da linha de comando diferenciam letra maiúscula de letra minúscula. Se você tiver dificuldades para executar a instalação da linha de comando, confirme que o texto atende as propriedades conforme mostrado nos exemplos.

Utilizando uma conta de domínio

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\mydomainaccount PASSWORD=my.password

Utilizando uma conta local existente ou nova

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password

Utilizando uma Conta de Serviço Gerenciado.

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa

Importando as credenciais de conta do Portal for ArcGIS utilizando um arquivo de configuração do portal

Os dois parâmetros da linha de comando seguintes devem ser utilizados juntos para importar as credenciais de conta do Portal for ArcGIS utilizando um arquivo de configuração do portal.

  • ACCOUNT=UseConfigFile

    Utilize o parâmetro ACCOUNT da linha de comando exatamente como mostrado acima. Não existe nenhum outro valor válido para esta propriedade.

  • CONFIGPATH=<caminho completo e nome do arquivo de configuração do portal>

    Utilizada em conjunto com ACCOUNT=UseConfigFile, esta propriedade permite a você especificar o arquivo de configuração do portal que será utilizado para configurar a conta do Portal for ArcGIS. Os arquivos de configuração do portal são criados pela exportação de um arquivo de configuração do portal ao instalar o Portal for ArcGIS (instalações anteriores ou de outras máquinas).

Abaixo está um exemplo:

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml

Aviso:

Os parâmetros da linha de comando diferenciam letra maiúscula de letra minúscula. Se você tiver dificuldades para executar a instalação da linha de comando, confirme que o texto atende as propriedades conforme mostrado nos exemplos.

Exportando credenciais de conta do Portal for ArcGIS para um arquivo de configuração do portal

Anotação:

Ao exportar um arquivo de configuração do portal para compartilhar na rede, a conta do Sistema Local na máquina onde o Portal for ArcGIS está sendo instalado deverá ter permissões de escrita na rede compartilhada. Por exemplo, se você estiver instalando o Portal for ArcGIS em uma máquina denominada Quick, a conta do Sistema Local em Quick deverá ter permissão de escrita na rede compartilhada. Se as permissões não forem configuradas, o arquivo de configuração do portal não poderá ser exportado com sucesso. Se você não tiver certeza de como configurar corretamente as permissões da rede compartilhada, entre em contato com o administrador do sistema ou exporte o arquivo de configuração do portal localmente, então copie na rede compartilhada.

Os dois parâmetros de linha de comando a seguir devem ser usados ​​juntos para exportar credenciais de conta do Portal for ArcGIS para um arquivo de configuração do portal:

  • EXPORTCONFIG=Yes

    Utilize esta propriedade para exportar as informações da conta inseridas com os parâmetros USER_NAME e PASSWORD da linha de comando. As informações da conta serão armazenadas em um arquivo XML codificado, conhecido como um arquivo de configuração do portal. Esta propriedade é configurada para Não por padrão.

  • CONFIGPATH=<caminho completo e nome do arquivo de configuração do portal>

    Utilizada em conjunto com EXPORTCONFIG=Yes, esta propriedade permite a você definir o nome do arquivo de configuração do portal e o local onde será armazenado. O nome do arquivo deve terminar com .xml e a pasta especificada já deve existir. Se o arquivo não tiver uma extensão do .xml e o diretório especificado ainda não existir, a criação do arquivo de configuração do portal poderá não ser bem sucedida.

Abaixo está um exemplo:

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes EXPORTCONFIG=Yes CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml

Aviso:

Os parâmetros da linha de comando diferenciam letra maiúscula de letra minúscula. Se você tiver dificuldades para executar a instalação da linha de comando, confirme que o texto atende as propriedades conforme mostrado nos exemplos.

Utilizando o utilitário da linha de comando createportal para criar um portal

Você pode usar o utilitário de linha de comando do createportal para criar um portal após o Portal for ArcGIS ter sido instalado. Você pode utilizar o utilitário createportal nos modos seguintes:

  • Execute o utilitário do createportal como administrador em uma solicitação de comando e especifique o nome, o sobrenome, o nome do usuário, a senha, o endereço de e-mail, a pergunta secreta, a resposta e os parâmetros do diretório de conteúdo.
  • Forneça um arquivo createportal.properties contendo parâmetros específicos.

Para utilizar o utilitário de linha de comandos createportal, execute o script createportal.bat com -h ou -help como segue:

<Portal for ArcGIS Installation Directory>\tools\createportal\createportal.bat -help

Exemplo de uso com o utilitário: createportal.bat [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [-lf <arg>] [-ut <arg>]

Uso de exemplo com um arquivo: createportal.bat [-f <FILE>]

Anotação:

Quando você faz referência a um caminho no arquivo createportal.properties, você precisa escapar da barra invertida C:\\arcgisportal ou \\\\<Absolute path to>\\<portal arcgisportal>.

OpçãoDescrição

-fn; --firstname

Primeiro nome para uma conta administrativa inicial utilizado para configurar o portal.

Garanta que entradas de múltiplas palavras sejam incluídas entre aspas.

-ln; --lastname

Sobrenome para uma conta administrativa inicial utilizado para configurar o portal.

Garanta que entradas de múltiplas palavras sejam incluídas entre aspas.

-u; --username

Nome do usuário para uma conta administrativa inicial utilizado para configurar o portal.

O nome do usuário podem ser composto de números 0-9, as letras de ASCII de a–z e A–Z e o caractere de ponto (.).

-p; --password

Senha da conta administrativa inicial utilizada para configurar o portal.

A senha pode ser composta de números 0-9, as letras de ASCII de a–z e A–Z e o caractere de ponto (.).

-e; --email

Endereço de e-mail para uma conta administrativa inicial utilizado para configurar o portal.

-qi; --question

Índice da pergunta secreta para recuperar uma senha esquecida. Perguntas disponíveis com números de índice respectivos são como seguem:

  • 1, Em que cidade você nasceu?
  • 2, Qual foi seu mascote no segundo grau?
  • 3, Qual é nome de solteira da sua mãe?
  • 4, Qual era a marca do seu primeiro carro?
  • 5, Qual foi sua escola no ensino médio?
  • 6, Qual é o sobrenome do seu melhor amigo?
  • 7, Qual é o nome do meio do seu irmão mais novo?
  • 8, Qual é o nome da rua na qual você cresceu?
  • 9, Qual é o nome do seu personagem de ficção favorito?
  • 10, Qual é o nome do seu animal de estimação favorito?
  • 11, Qual é o nome do seu restaurante favorito?
  • 12, Qual é o título do seu livro favorito?
  • 13, Qual é o seu emprego dos sonhos?
  • 14, Aonde você foi no seu primeiro encontro?

-qa; --answer

Responda a pergunta secreta que você escolheu para o parâmetro -qi.

Garanta que entradas de múltiplas palavras sejam incluídas entre aspas.

-d; --contentDirectory

Caminho e nome absoluto do diretório de conteúdo utilizado para armazenar dados hospedados no portal.

Por padrão, o diretório de conteúdo do portal é criado localmente nesta localização:

C:\arcgisportal

ou

\\<Absolute path to>\<Content Directory>

-lf; --licenseFile

O caminho para o arquivo de licença do portal.

-ut; --userTypeId

OID do tipo de usuário para o administrador inicial.

Este parâmetro é opcional. Para gerar uma lista de tipos de usuário compatíveis disponíveis para sua organização para o parâmetro -ut, execute o utilitário listadministratorusertypes. Se um ID de tipo de usuário não for especificado e o arquivo de licença de portal contém um tipo de usuário compatível único, que o tipo de usuário será atribuído. Se o arquivo de licença contiver os tipos de usuário compatíveis múltiplos, um tipo de usuário temporário será atribuído e o administrador inicial terá que selecionar um tipo de usuário após registrar.

-f; --file

O arquivo de propriedades do utilitário createportal.

Por padrão, o arquivo createportal.properties pode ser encontrado nesta localização:

<Portal for ArcGIS Installation Directory>/tools/createportal

-h; --help

Exibe a ajuda da linha de comando e sai.

O seguinte é um exemplo do arquivo 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 =

Você receberá uma mensagem que o portal criou com sucesso antes da ferramenta sair.

Utilize o utilitário de linha de comandos listadministratorusertypes para identificar tipos de usuário compatíveis

Para identificar uma lista de IDs de tipo de usuário licenciado para sua organização que são compatíveis com o papel de Administrador, execute o utilitário de linha de comandos do listadministratorusertypes. Isto fornecerá uma lista de entradas para o parâmetro -ut na ferramenta createportal. Execute a ferramenta -lf como mostrado abaixo, utilizando o arquivo de licença do portal como a entrada:

<Portal for ArcGIS Installation Directory>\tools\createportal\listadministratorusertypes.bat

Uso de exemplo com o utilitário: listadministratorusertypes.bat [-lf <arg>] ou listadministratorusertypes.bat [--listadministratorusertypes <arg>]