Skip To Content

Usare porte non predefinite per ArcGIS Web Adaptor del portale

Per la stragrande maggioranza degli utenti ArcGIS Enterprise, è opportuno eseguire ArcGIS Web Adaptor sulle porte predefinite 80 e 443. In alcuni rari casi, tuttavia, un'istanza di Web Adapter non può utilizzare queste porte predefinite sul server Web che lo ospita. Ad esempio, il server Web host potrebbe già avere un'applicazione in esecuzione su queste porte o l'accesso alla porta potrebbe essere limitato in un'organizzazione protetta.

In questi casi in cui non è possibile utilizzare le porte 80 e 443, è disponibile una soluzione del problema in ArcGIS Enterprise 10.6.1 per consentire l'esecuzione di Web Adaptor del portale su porte non predefinite. Un server proxy inverso o un bilanciatore deve quindi essere configurato in modo che gli utenti accedano al portale attraverso le porte predefinite. L'uso di HTTPS deve essere mantenuto per crittografare la comunicazione tra ArcGIS Web Adaptor e Portal for ArcGIS.

In 10.6.1, il ArcGIS Web Adaptor file di configurazione ha una nuova proprietà, EnableDefaultPortValidation, che per impostazione predefinita applica l'uso delle porte predefinite 80 e 443 durante la configurazione di ArcGIS Web Adaptor con un portale. La modifica del valore di questa proprietà su false ignora questa convalida, consentendo l'esecuzione di ArcGIS Web Adaptor su porte non predefinite.

Configurare ArcGIS Web Adaptor del portale su porte non predefinite

Se il server Web progettato per ospitare ArcGIS Web Adaptor del portale deve eseguire il software su porte diverse da 80 e 443, sarà necessario eseguire qualche passaggio aggiuntivo durante la configurazione di Web Adapter tramite le procedure guidate di installazione e configurazione.

  1. Abilitare HTTPS nel server Web che ospita Web Adaptor. Annotare la porta utilizzata per la comunicazione HTTPS, in quanto verrà utilizzata per accedere ad ArcGIS Web Adaptor durante la configurazione iniziale con il portale.
  2. Installare ArcGIS Web Adaptor sul server Web, utilizzando l'installazione guidata Setup.exe come utente con privilegi amministrativi.
  3. Nel computer che ospita ArcGIS Web Adaptor, cercare e aprire il file webadaptor.config in un editor di testo. Per impostazione predefinita, si trova nella cartella C:\inetpub\wwwroot\<web adaptor name> per IIS e nella cartella C:\Users\<username>\.webadaptor\<web adaptor name> per Java.
  4. Nel file webadaptor.config, individuare la proprietà EnableDefaultPortValidation, con un valore predefinito di true. Cambiare il valore su false: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
  5. Riavviare il server Web.
  6. Aprire la pagina di configurazione ArcGIS Web Adaptor in un browser Internet sulla porta HTTPS utilizzata dal server Web con il formato URL https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal. Se un alias DNS verrà utilizzato con il portale, il Web Adaptor deve essere configurato sull'alias, utilizzando un URL quale https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal.
  7. Per la proprietà URL del portale, digitare l’URL del computer che ospita il software Portal for ArcGIS utilizzando il nome dominio completamente qualificato del computer nell’URL, ad esempio https://portal.domain.com:7443.
  8. Digitare nome utente e password per un account che dispone di privilegi amministrativi per Portal for ArcGIS. In genere si utilizza l'accesso con account amministratore iniziale definito durante la configurazione del portale. Se l'account amministratore iniziale è stato abbassato di livello o eliminato, sarà necessario specificare un altro account con accesso amministrativo al Portale Web.
  9. Fare clic su Configura.
  10. Configurare il portale con il server proxy inverso dell'organizzazione o il bilanciatore, in modo che gli utenti accedano al portale tramite le porte predefinite. A tal fine, è necessario fornire alcune informazioni al portale sul proxy inverso o sul bilanciatore. Per le istruzioni complete, vedere Utilizzare un server proxy inverso con Portal for ArcGIS.
  11. Una volta configurato il proxy server o il bilanciatore, aggiornare la pagina di configurazione ArcGIS Web Adaptor per aggiornarlo.

Al termine di questo flusso di lavoro, ArcGIS Web Adaptor è configurato per l’uso con il portale ArcGIS Enterprise. Gli utenti accedono al portale e ad ArcGIS Portal Administrator Directory solo attraverso il server proxy inverso, con il formato dell'URL https://reverseproxy.domain.com/webadaptorname/home, piuttosto che tramite la porta 7443.

Suggerimento:

Se il portale è configurato per l'uso di HTTPS per tutte le comunicazioni, aggiornare il sito Web del portale installato e gli URL dei collegamenti alla guida in modo da utilizzare https anziché http.

Configurare in modalità silenziosa ArcGIS Web Adaptor (IIS) del portale su porte non predefinite

L’installazione e la configurazione di ArcGIS Web Adaptor (IIS) può essere effettuata anche dalla riga di comando, con passaggi aggiuntivi per l'esecuzione su porte non predefinite.

  1. Abilitare HTTPS nel server Web IIS che ospita Web Adaptor. Annotare la porta utilizzata per la comunicazione HTTPS, in quanto verrà utilizzata per accedere ad ArcGIS Web Adaptor durante la configurazione iniziale con il portale.
  2. Installare ArcGIS Web Adaptor (IIS) sul server Web, utilizzando l'utilità da riga di comando di installazione come utente con privilegi amministrativi.
  3. Nel computer che ospita ArcGIS Web Adaptor, cercare e aprire il file webadaptor.config in un editor di testo. Per impostazione predefinita, si trova nella cartella C:\inetpub\wwwroot\<web adaptor name>.
  4. Nel file webadaptor.config, individuare la proprietà EnableDefaultPortValidation, con un valore predefinito di true. Cambiare il valore su false: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
  5. Riavviare il server Web IIS.
  6. Configurare ArcGIS Web Adaptor l'utilità da riga di comando ConfigureWebAdaptor.exe, situata nella cartella C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptor\IIS\Tools . Verrà utilizzata la sintassi ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <URL> /u <Username> /p <Password>. I parametri da fornire sono:

    • <Mode>: modalità del prodotto in cui verrà configurato ArcGIS Web Adaptor. Impostare questo parametro su portal per l’uso con Portal for ArcGIS.
    • <WebAdaptorURL>: URL di ArcGIS Web Adaptor che si desidera configurare dalla riga di comando. Si tratta dello stesso URL che viene utilizzato se si accede alla pagina di configurazione in un browser web. È necessario specificare l'URL HTTPS di ArcGIS Web Adaptor: ad esempio https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor. Se un alias DNS verrà utilizzato con il portale, il Web Adaptor deve essere configurato sull'alias DNS, utilizzando un URL quale https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor.
    • <URL>: URL del computer che ospita Portal for ArcGIS. Includere nell'URL il nome di dominio completo del computer: ad esempio https://portal.domain.com:7443.
    • <Username>: nome utente di un account con privilegi amministrativi per Portal for ArcGIS. In genere si utilizza l'account amministratore iniziale definito durante la configurazione del portale.
    • <Password>: password di un account con privilegi amministrativi per Portal for ArcGIS. In genere si utilizza l'account amministratore iniziale definito durante la configurazione del portale.

    Comando di esempio

    ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor /g https://portal.domain.com:7443 /u initialadmin /p secret123
  7. Configurare il portale con il server proxy inverso dell'organizzazione o il bilanciatore, in modo che gli utenti accedano al portale tramite le porte predefinite. A tal fine, è necessario fornire alcune informazioni al portale sul proxy inverso o sul bilanciatore. Per le istruzioni complete, vedere Utilizzare un server proxy inverso con Portal for ArcGIS.

Al termine di questo flusso di lavoro, ArcGIS Web Adaptor è configurato per l’uso con il portale ArcGIS Enterprise. Gli utenti accedono al portale e ad ArcGIS Portal Administrator Directory solo attraverso il server proxy inverso, con il formato dell'URL https://reverseproxy.domain.com/webadaptorname/home, piuttosto che tramite la porta 7443.

Suggerimento:

Se il portale è configurato per l'uso di HTTPS per tutte le comunicazioni, aggiornare il sito Web del portale installato e gli URL dei collegamenti alla guida in modo da utilizzare https anziché http.

Configurare in modalità silenziosa ArcGIS Web Adaptor (Java Platform) del portale su porte non predefinite

L’installazione e la configurazione di ArcGIS Web Adaptor (Java Platform) può essere effettuata anche dalla riga di comando, con passaggi aggiuntivi per l'esecuzione su porte non predefinite.

Nota:

Per poter eseguire l'utilità da riga di comando, nel computer che ospita ArcGIS Web Adaptor deve essere già installato Java Runtime Environment (JRE). Se JRE non è presente nel computer, verrà visualizzato un errore quando l'utility viene eseguita. Per istruzioni su come scaricare e installare JRE nel computer, visitare il sito internet dei download di Java SE.

  1. Abilitare HTTPS nel server Web che ospita Web Adaptor. Annotare la porta utilizzata per la comunicazione HTTPS, in quanto verrà utilizzata per accedere ad ArcGIS Web Adaptor durante la configurazione iniziale con il portale.
  2. Installare ArcGIS Web Adaptor sul server Web, utilizzando l'utilità da riga di comando di installazione come utente con privilegi amministrativi.
  3. Nel computer che ospita ArcGIS Web Adaptor, cercare e aprire il file webadaptor.config in un editor di testo. Per impostazione predefinita, si trova nella cartella C:\Users\<username>\.webadaptor\<web adaptor name>.Per impostazione predefinita, si trova nella cartella /root/.webadaptor/<web adaptor name>.
  4. Nel file webadaptor.config, individuare la proprietà EnableDefaultPortValidation, con un valore predefinito di true. Cambiare il valore su false: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
  5. Riavviare il server Web.
  6. Configurare ArcGIS Web Adaptor l'utilità da riga di comando ConfigureWebAdaptor.bat, situata nella cartella <ArcGIS Web Adaptor installation directory>\Web Adaptor<version>\java\tools. Verrà utilizzata la sintassi ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password>. I parametri da fornire sono:

    • <Mode>: modalità del prodotto in cui verrà configurato ArcGIS Web Adaptor. Impostare questo parametro su portal per l’uso con Portal for ArcGIS.
    • <WebAdaptorURL>: URL di ArcGIS Web Adaptor che si desidera configurare dalla riga di comando. Si tratta dello stesso URL che viene utilizzato se si accede alla pagina di configurazione in un browser web. È necessario specificare l'URL HTTPS di ArcGIS Web Adaptor: ad esempio https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor. Se un alias DNS verrà utilizzato con il portale, il Web Adaptor deve essere configurato sull'alias DNS, utilizzando un URL quale https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor.
    • <URL>: URL del computer che ospita Portal for ArcGIS. Includere nell'URL il nome di dominio completo del computer: ad esempio https://portal.domain.com:7443.
    • <Username>: nome utente di un account con privilegi amministrativi per Portal for ArcGIS. In genere si utilizza l'account amministratore iniziale definito durante la configurazione del portale.
    • <Password>: password di un account con privilegi amministrativi per Portal for ArcGIS. In genere si utilizza l'account amministratore iniziale definito durante la configurazione del portale.

    Comando di esempio

    ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor -g https://portal.domain.com:7443 -u initialadmin -p secret123
  7. Configurare il portale con il server proxy inverso dell'organizzazione o il bilanciatore, in modo che gli utenti accedano al portale tramite le porte predefinite. A tal fine, è necessario fornire alcune informazioni al portale sul proxy inverso o sul bilanciatore. Per le istruzioni complete, vedere Utilizzare un server proxy inverso con Portal for ArcGIS.

Al termine di questo flusso di lavoro, ArcGIS Web Adaptor è configurato per l’uso con il portale ArcGIS Enterprise. Gli utenti accedono al portale e ad ArcGIS Portal Administrator Directory solo attraverso il server proxy inverso, con il formato dell'URL https://reverseproxy.domain.com/webadaptorname/home, piuttosto che tramite la porta 7443.

Suggerimento:

Se il portale è configurato per l'uso di HTTPS per tutte le comunicazioni, aggiornare il sito Web del portale installato e gli URL dei collegamenti alla guida in modo da utilizzare https anziché http.