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

If the web server intended to host your portal's ArcGIS Web Adaptor has to run the software on ports other than 80 and 443, you will need to follow additional steps when setting up Web Adaptor via the installation and configuration wizards.

  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. If a DNS alias will be used with the portal, Web Adaptor should be configured over the alias instead, using a URL such as 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.

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 ospiterà 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 the C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools inviata. Verrà utilizzata la sintassi ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <Machine Name|URL> /u <Username> /p <Password>. The parameters to provide are as follows:

    • <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. If a DNS alias will be used with the portal, Web Adaptor should be configured over the DNS alias instead, using a URL such as 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 portal.domain.com /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.

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:

To execute the command line utility, Java Runtime Environment (JRE) must be present on the machine hosting ArcGIS Web Adaptor. If JRE is not present on your machine, an error will occur when executing the utility. See the Java SE Downloads site for instructions on how to download and install JRE on your machine.

  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 <Machine Name|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. If a DNS alias will be used with the portal, Web Adaptor should be configured over the DNS alias instead, using a URL such as 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 portal.domain.com -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.