Skip To Content

Configurações do GeoAnalytics Server

Há diversas propriedades que podem ser configuradas para alterar as configurações do GeoAnalytics Server na sua implantação. Definir estas configurações para sua organização é importante para otimizar o desempenho do GeoAnalytics Server. Quando configurando estes configurações, você deve considerar o seguinte:

  • O número de trabalhos simultâneos que estará sendo executados
  • O tamanho dos dados que estão sendo utilizados
  • A frequência dos trabalhos que serão executados
  • Os recursos disponíveis

As Ferramentas do GeoAnalytics que os membros do portal executam são fornecidas por tarefas no serviço de sistema GeoAnalyticsTools em seu site do ArcGIS Server . As propriedades de sistema abaixo são definidas no site do GeoAnalytics Server , enquanto as propriedades de serviço e o número de instâncias são definidos no próprio serviço de sistema GeoAnalyticsTools. Antes de modificar quaisquer parâmetros, leia todas as opções de configuração para planejar sua configuração de GeoAnalytics.

Aviso:

Quando você atualizar para uma nova versão do ArcGIS Enterprise, estas configurações do GeoAnalytics Server não serão preservadas. Antes de atualizar, note quaisquer configurações que você alterou e implemente-as novamente quando a atualização estiver concluída.

Os seguintes exemplos serão utilizados neste tópico:

  • Exemplo 1: Um site de três máquinas do GeoAnalytics Server que executará um único trabalho de cada vez
  • Exemplo 2: Um site de três máquina do GeoAnalytics Server que executará dois trabalhos simultaneamente

Ambos destes exemplos incluem três máquinas (nós), cada com 16 GB de RAM e 4 núcleos de CPU. Em total, cada site do GeoAnalytics Server tem 48 GB de RAM e 12 núcleos.

Anotação:

É recomendado que você não aloque mais que 30 GB de memória por máquina para o GeoAnalytics.

Propriedades de sistema

As seguintes propriedades de sistema são propriedades opcionais que podem ser configuradas por um administrador do site para alocar recursos de CPU e memória para o processo de trabalho da plataforma de computação em cada máquina no ArcGIS Server:

  • percentageMaxAllowedComputeCores—Isto representa o máximo de núcleos da CPU (como uma porcentagem do total disponível em uma máquina) que serão usados pelo processo de trabalho da plataforma de computação em um único nó. O valor padrão é 80 porcento e o valor máximo permitido é 90 porcento. Se o valor especificado for convertido para menos de um núcleo da CPU, um núcleo da CPU será utilizado para o processo de trabalho da plataforma de computação.
  • percentageMaxAllowedComputeMemory—Isso representa a memória máxima (como uma porcentagem da memória total disponível em uma máquina) que será utilizada pelo processo de trabalho da plataforma de computação em um único nó. O valor padrão é 80 porcento e o valor máximo permitido é 90 porcento.

Para editar as propriedades de sistema, complete as etapas seguintes:

  1. Entre no ArcGIS Server Administrator Directory como um usuário com privilégios administrativos. A URL está no formato http://gisserver.domain.com:6080/arcgis/admin/.
  2. Vá até Sistema > Propriedades.
  3. Clique em Atualizar.
  4. Adicione as propriedades no seguinte formato JSON: { "percentageMaxAllowedComputeCores": <value>, "percentageMaxAllowedComputeMemory": <value>} (por exemplo, {"percentageMaxAllowedComputeCores": 90, "percentageMaxAllowedComputeMemory": 90}).

Propriedades do serviço

Há duas propriedades de nível do serviço no serviço GeoAnalyticsTools para alocação de memória máxima permitida e núcleos da CPU por tarefa. O padrão é configurado para 6 GB por máquina e 4 núcleos de CPU. É recomendado que você atualize estes para um valor apropriado baseado nos recursos da CPU e memória disponíveis em seu site. A utilização do padrão não aproveitará da computação distribuída e resultará em um desempenho ruim.

Anotação:

Somente administradores podem definir propriedades de nível do serviço. Você precisa saber o número de núcleos no site do servidor e a quantidade de RAM em cada máquina. Se você não conhecer estes valores, é possível utilizar a verificação de desempenho do GeoAnalytics para descobrir isto.

Aprenda sobre a verificação de desempenho do GeoAnalytics

A seguinte equação pode ser utilizada para avaliar a memória máxima permitida de trabalho por máquina:

Floor(((percentageMaxAllowedComputeCores) * (total cores on the Server Site) / (number of simultaneous jobs)) = (Maximum allowed compute cores per job)

A seguinte equação pode ser utilizada para avaliar o máximo permitido de núcleos de computação por trabalho:

Floor((percentageMaxAllowedComputeMemory) * (GB of RAM on a single GeoAnalytics machine) / (number of simultaneous jobs)) = (Maximum allowed memory per job per machine)

Anotação:

A quantidade de memória utilizada por máquina é a mesma em todas as máquinas do GeoAnalytics Server . Se você tiver múltiplas máquinas no seu site do GeoAnalytics Server com diferentes quantidades de RAM, utilize o valor da máquina com a menor quantidade de RAM.

Por Exemplo 1, suponha que você deseja consumir até 80 porcento dos núcleos e memória de computação disponíveis (como descrito nas Propriedades de sistema). Com um total de 12 núcleos da CPU e 48 GB de RAM (16 em cada máquina), as quantidades de núcleos e RAM são decididas utilizando as equações abaixo.

  • Número de núcleos:
    Floor(((.80) * (12))/1) = Floor(9.6) = 9
  • Quantidade de RAM por máquina:
    Floor(((.80) * (16))/1) = Floor(12.8) = 12

Para aproveitar dos recursos disponíveis no GeoAnalytics Server e distribuir as tarefas através de múltiplas máquinas do site, você pode atualizar os valores para os seguintes:

  • Máixmo de memória permitida por posto de trabalho por máquina (GB): 12
  • Máximo de núcleos de computação permitidos por trabalho (CPU): 9

Isto garantirá que o trabalho será distribuído para mais de duas máquinas no site e utilizará apenas 80 porcento dos recursos disponíveis em todas as máquinas. O conjunto de alocação também impactará no número de instâncias como descrito abaixo.

Por Exemplo 2, suponha que você deseja consumir até 80 porcento dos núcleos e memória de computação disponíveis (como descrito nas Propriedades de sistema) e poder executar dois trabalhos de uma vez. Isto significa que os recursos precisam ser definidos para dois trabalhos em todas as vezes. Com um total de 12 núcleos da CPU e 48 GB de RAM (16 em cada máquina), as quantidades de núcleos e RAM são decididas utilizando as equações abaixo.

  • Número de núcleos:
    Floor(((.80) * (12))/2) = Floor(4.8) = 4
  • Quantidade de RAM por máquina:
    Floor(((.80) * (16))1) = Floor(6.4) = 6

Para aproveitar dos recursos disponíveis no GeoAnalytics Server e distribuir as tarefas através de múltiplas máquinas do site, você pode atualizar os valores para os seguintes:

  • Máixmo de memória permitida por posto de trabalho por máquina (GB): 6
  • Máximo de núcleos de computação permitidos por trabalho (CPU): 4

Para modificar estas propriedades, faça o seguinte:

  1. Entre no ArcGIS Server Manager do GeoAnalytics Server como um usuário com privilégios administrativos. A URL está no formato https://gisserver.domain.com:6443/arcgis/manager.
  2. Na guia Serviços, selecione a pasta Sistema.
  3. Na lista de serviços disponíveis, localize e escolha para editar o serviço GeoAnalyticsTools.
  4. Utilize a guia Parâmetros para configurar as propriedades do serviço. Estes incluem o seguinte:
    • Máximo de memória permitida de trabalho por máquina (GB)—Isto representa a quantidade de memória em gigabytes que pode ser utilizada por trabalho em cada máquina.
    • Máximo permitido para computar núcleos por trabalho (CPU)—Isto representa o número total de núcleos da CPU que podem ser utilizados por trabalho através de todas as máquinas em seu agrupamento.
  5. Após finalizado, clique em Salvar e Reiniciar para atualizar as propriedades do serviço.

Se os valores iniciais não forem modificados, a tarefa de GeoAnalytics somente utilizará uma parte dos recursos disponíveis (4 núcleos e 18 GB dos 12 núcleos disponíveis e 48 GB da configuração de exemplo).

Anotação:

Quando selecionar a quantidade de memória para utilizar, tenha certeza de configurar um número que seja menor ou igual à porcentagem definida para os recursos da máquina (o padrão é 80 por cento). Se você fizer isto, os trabalhos esperarão por recursos que não estejam realmente disponíveis por um minuto e, em seguida, serão cancelados com o seguinte erro: ERROR BD_101057: Não foi possível iniciar o trabalho distribuído. Verifique suas configurações do serviço GeoAnalyticsTools e garanta que haja recursos suficientes disponíveis para que o trabalho seja executado. Você também visualizará este erro se os recursos não estiverem disponíveis, pois outros trabalhos estão utilizando os recursos.

Instâncias mínima e máxima do serviço GeoAnalyticsTools

As instâncias mínimas e máximas padrão do serviço GeoAnalyticsTools são definidas para uma por máquina do ArcGIS Server no site. Dependendo do número de máquinas (n) que estão no site do GeoAnalytics Server, existirá (n) número de instâncias disponíveis para aceitar os trabalhos do GeoAnalytics. Dependendo do número de instâncias e quantidade de memória e núcleos da CPU alocados por trabalho nas propriedades do serviço, um ou mais pedidos de concorrentes podem ser processados. Quaisquer pedidos adicionais do Ferramentas do GeoAnalytics entrarão na fila até que a instância ou recursos de memória e CPU se tornem disponíveis. Se nenhum recurso for disponibilizado após um minuto, o trabalho será cancelado.

Alocar a quantidade máxima possível de memória e núcleos da CPU por trabalho é ideal para trabalhos que exigem isto.

Para processar múltiplos trabalhos ao mesmo tempo, você pode aumentar a instância máxima conforme necessário para mais de uma por máquina no site. Entretanto, você também terá que modificar os limites de memória e CPU por trabalho de forma que haja recursos suficientes de memória e CPU disponíveis para cada trabalho concorrente.

Para configurar as instâncias mínima e máxima do serviço GeoAnalyticsTools, complete as seguintes etapas:

  1. Entre no ArcGIS Server Administrator Directory. A URL está no formato https://gisserver.domain.com:6443/arcgis/admin.
  2. Vá até Serviços > Sistema > GeoAnalyticsTools.
  3. Clique em Editar.
  4. Edite as propriedades maxInstancesPerNode e minInstancesPerNode e clique em Salvar Edições.

No exemplo de três máquinas, haverá um total de três instâncias disponíveis suficientes para atender ambos os casos de uso do Exemplo 1 e 2. Para executar mais de três tarefas simultâneas com este cenário de três máquinas, você também deve atualizar o número de instâncias além de ajustar os limites da CPU e memória.

O total de limites da memória e CPU em todas as instâncias deve ser menor que o limite de sistema da CPU e memória. A memória total por nó multiplicada pelo número de instâncias deve ser menor que o que está disponível em uma única máquina—isto é, (16 GB x 0.80) / 2 instâncias = 6.4 e deve ser um inteiro -> 6—e os núcleos de computação devem ser menores que o total de núcleos dividido pelo número de instâncias—isto é, (12 núcleos x .80) / 2 instâncias = 4.8 -> 4.

Tempo limite do serviço GeoAnalyticsTools

Por padrão, qualquer trabalho de longa execução processado pelo serviço GeoAnalyticsTools expirará em 24 horas. Talvez queira editar esta propriedade para que as ferramentas expirem após a execução por períodos mais longos ou mais curtos. Você pode editar a propriedade do limite de tempo do serviço GeoAnalyticsTools no ArcGIS Server Manager seguindo as etapas abaixo.

  1. Entre no ArcGIS Server Manager. A URL está no formato https://gisserver.domain.com:6443/arcgis/manager.
  2. Na guia Serviços, escolha a pasta Sistema.
  3. Na lista de serviços disponíveis, localize e escolha para editar o serviço GeoAnalyticsTools.
  4. Utilize a guia Agrupar para configurar a propriedade do limite de tempo do serviço na seção Especificar tempos limite do serviço. Altere O tempo máximo que um cliente pode utilizar o serviço para o tempo em segundos que deseja para a nova propriedade de tempo limite.
  5. Clique em Salvar e Reiniciar para atualizar o serviço.

Local de arquivo temporário do GeoAnalytics Server

Quando uma tarefa é executada no GeoAnalytics Server, arquivos temporários são gravados por padrão na pasta \<ArcGIS Server installation directory>\server\framework\runtime\spark\work>. Os administradores podem selecionar um local alternativo para arquivos temporários especificando a propriedade geoAnalyticsTempFolder , seguindo as etapas abaixo.

Anotação:

O local da propriedade geoAnalyticsTempFolder deve ser um diretório local em cada máquina de site do GeoAnalytics Server , e deve ter espaço em disco considerável e disponível para suportar a execução de tarefas do GeoAnalytics em conjuntos de dados muito grandes.

  1. Entre no ArcGIS Server Administrator Directory no site do GeoAnalytics Server como um usuário com privilégios administrativos. A URL está no formato http://gisserver.domain.com:6080/arcgis/admin/.
  2. Vá até Sistema > Propriedades.
  3. Clique em Atualizar.
  4. Adicione as propriedades no seguinte formato JSON: {"geoanalyticsTempFolder": "<value>"} (por exemplo, {"geoanalyticsTempFolder": "/data/temp"}). Levará um minuto para que a alteração seja refletida na página de propriedades do sistema.
  5. Verifique a condição do seu GeoAnalytics Server utilizando o serviço de verificação do desempenho da Plataforma de Computação . Navegue até Sistema > Serviços da Plataforma > Compute_Platform e clique em Desempenho.