Korzystanie z portów innych niż domyślne dla aplikacji ArcGIS Web Adaptor portalu

W przypadku zdecydowanej większości użytkowników oprogramowania ArcGIS Enterprise należy uruchomić aplikację ArcGIS Web Adaptor na portach domyślnych 80 i 443. W pewnych rzadkich przypadkach jednak instancja aplikacji Web Adaptor nie może użyć portów domyślnych na serwerze internetowym, który ją hostuje. Serwer internetowy może już na przykład mieć aplikację działającą na tych portach lub dostęp do portów może być ograniczony w zabezpieczonej instytucji.

W takich sytuacjach, w których nie można użyć portów 80 i 443, w oprogramowaniu ArcGIS Enterprise 10.6.1 jest dostępne obejście umożliwiające uruchamianie aplikacji Web Adaptor portalu na portach innych niż domyślne. Następnie należy skonfigurować zwrotny serwer proxy lub moduł równoważenia obciążenia, tak aby użytkownicy mogli mieć dostęp do portalu z użyciem portów domyślnych. Należy zapewnić możliwość użycia protokołu HTTPS, aby szyfrować komunikację między oprogramowaniem ArcGIS Web Adaptor i Portal for ArcGIS.

W wersji 10.6.1 plik konfiguracyjny aplikacji ArcGIS Web Adaptor ma nową właściwość, EnableDefaultPortValidation, która domyślnie wymusza użycie portów domyślnych 80 i 443 przy konfigurowaniu aplikacji ArcGIS Web Adaptor z portalem. Zmiana wartości tej właściwości na false pozwala ominąć tę weryfikację, umożliwiając działanie aplikacji ArcGIS Web Adaptor na portach innych niż domyślne.

Konfigurowanie aplikacji ArcGIS Web Adaptor portalu na portach innych niż domyślne

Jeśli serwer internetowy przeznaczony do hostowania aplikacji ArcGIS Web Adaptor portalu musi mieć uruchomione oprogramowanie na portach innych niż 80 i 443, będzie potrzebne wykonanie dodatkowych czynności przy konfigurowaniu aplikacji Web Adaptor za pomocą kreatorów instalacji i konfiguracji.

1. Włącz protokół HTTPS na serwerze internetowym, który będzie hostował adapter internetowy. Zanotuj port, który będzie używany do komunikacji HTTPS, ponieważ będzie on używany do uzyskania dostępu do aplikacji ArcGIS Web Adaptor podczas początkowej konfiguracji z portalem.
2. Zainstaluj aplikację ArcGIS Web Adaptor na serwerze internetowym, korzystając z kreatora instalacji Setup.exe jako użytkownik z uprawnieniami administracyjnymi.
3. Na komputerze hostującym aplikację ArcGIS Web Adaptor przejdź do pliku webadaptor.config i otwórz go w edytorze tekstu. Domyślnie znajduje się w folderze /root/.webadaptor/<web adaptor name>.
4. W pliku webadaptor.config znajdź właściwość EnableDefaultPortValidation o wartości domyślnej true. Zmień wartość na false: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Uruchom ponownie serwer internetowy.
6. Otwórz stronę konfiguracji aplikacji ArcGIS Web Adaptor w przeglądarce internetowej na porcie HTTPS używanym przez serwer internetowy, korzystając z adresu URL w formacie https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal. Jeśli w portalu będzie używany alias DNS, aplikację Web Adaptor należy skonfigurować z użyciem aliasu, korzystając z adresu URL, na przykład https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal.
7. We właściwości Adres URL portalu wpisz adres URL komputera hostującego oprogramowanie Portal for ArcGIS, używając w adresie URL w pełni kwalifikowanej nazwy domeny, na przykład https://portal.domain.com:7443.
8. Podaj nazwę użytkownika i hasło konta z uprawnieniami administracyjnymi w oprogramowaniu Portal for ArcGIS. Zwykle należy użyć loginu początkowego konta administratora zdefiniowanego podczas pierwszej konfiguracji portalu. W przypadku obniżenia rangi lub usunięcia początkowego konta administratora należy podać inne konto z dostępem administracyjnym do witryny portalu.
9. Kliknij przycisk Konfiguruj.
10. Skonfiguruj portal ze zwrotnym serwerem proxy lub modułem równoważenia obciążenia instytucji, tak aby użytkownicy mogli uzyskiwać dostęp do portalu z użyciem portów domyślnych. W tym celu należy podać w portalu pewne informacje dotyczące zwrotnego serwera proxy lub modułu równoważenia obciążenia. Szczegółowe instrukcje można znaleźć w temacie Korzystanie ze zwrotnego serwera proxy z oprogramowaniem Portal for ArcGIS.
11. Po skonfigurowaniu z portalem zwrotnego serwera proxy lub modułu równoważenia obciążenia odśwież stronę konfiguracji aplikacji ArcGIS Web Adaptor, aby ją zaktualizować.

Po zakończeniu procedury wykonywania zadań aplikacja ArcGIS Web Adaptor będzie skonfigurowana do użycia z portalem ArcGIS Enterprise. Użytkownicy będą mieć dostęp do portalu i aplikacji ArcGIS Portal Administrator Directory tylko za pomocą zwrotnego serwera proxy z użyciem adresu URL w formacie URL https://reverseproxy.domain.com/webadaptorname/home zamiast korzystania z portu 7443.

Konfigurowanie aplikacji ArcGIS Web Adaptor (Java Platform) portalu na portach innych niż domyślne w trybie dyskretnym

Instalację i konfigurację aplikacji ArcGIS Web Adaptor (Java Platform) można przeprowadzić również z poziomu wiersza poleceń z dodatkowymi czynnościami w celu uruchomienia na portach innych niż domyślne.

Notatka:

Do uruchomienia wiersza poleceń wymagane jest środowisko Java Runtime Environment (JRE) na komputerze hostującym aplikację ArcGIS Web Adaptor. Jeśli na danym komputerze nie ma środowiska JRE, w momencie uruchamiania narzędzia wystąpi błąd. Instrukcje dotyczące pobierania i instalacji środowiska JRE na komputerze znajdują się w witrynie Java SE Downloads (Pliki do pobrania środowiska Java SE).

1. Włącz protokół HTTPS na serwerze internetowym, który będzie hostował adapter internetowy. Zanotuj port, który będzie używany do komunikacji HTTPS, ponieważ będzie on używany do uzyskania dostępu do aplikacji ArcGIS Web Adaptor podczas początkowej konfiguracji z portalem.
2. Zainstaluj aplikację ArcGIS Web Adaptor na serwerze internetowym, korzystając z narzędzia instalacyjnego wiersza poleceń jako użytkownik z uprawnieniami administracyjnymi.
3. Na komputerze hostującym aplikację ArcGIS Web Adaptor przejdź do pliku webadaptor.config i otwórz go w edytorze tekstu.
4. W pliku webadaptor.config znajdź właściwość EnableDefaultPortValidation o wartości domyślnej true. Zmień wartość na false: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Uruchom ponownie serwer internetowy.
6. Skonfiguruj aplikację ArcGIS Web Adaptor, używając narzędzia wiersza poleceń configurewebadaptor.sh, które znajduje się w folderze <ArcGIS Web Adaptor installation directory>/webadaptor<version>/java/tools. Używana składnia: ConfigureWebAdaptor.sh -m <Mode> -w <WebAdaptorURL> -g <Machine Name|URL> -u <Username> -p <Password>. Należy podać następujące parametry:

   • <Mode> — tryb, w którym aplikacja ArcGIS Web Adaptor zostanie skonfigurowana. Skonfiguruj wartość portal tego parametru do użytku z oprogramowaniem Portal for ArcGIS.
   • <WebAdaptorURL> — adres URL aplikacji ArcGIS Web Adaptor, która ma zostać skonfigurowana za pomocą wiersza poleceń. To ten sam adres URL, którego należy użyć w przypadku uzyskiwania dostępu do strony konfiguracji w przeglądarce internetowej. Należy podać adres URL HTTPS aplikacji ArcGIS Web Adaptor, np. https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor. Jeśli w portalu będzie używany alias DNS, aplikację Web Adaptor należy skonfigurować z użyciem aliasu DNS, korzystając z adresu URL, na przykład https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor.
   • <URL> — adres URL komputera hostującego oprogramowanie Portal for ArcGIS. W adresie URL podaj w pełni kwalifikowaną nazwę domeny komputera, np. https://portal.domain.com:7443.
   • <Username> — nazwa użytkownika konta, które ma uprawnienia administracyjne do oprogramowania Portal for ArcGIS. Zwykle należy użyć początkowego konta administratora, zdefiniowanego podczas pierwszej konfiguracji portalu.
   • <Password> — hasło do konta, które ma uprawnienia administracyjne do oprogramowania Portal for ArcGIS. Zwykle należy użyć początkowego konta administratora, zdefiniowanego podczas pierwszej konfiguracji portalu.

   Przykład polecenia

   configurewebadaptor.sh -m portal -w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor -g portal.domain.com -u initialadmin -p secret123

7. Skonfiguruj portal ze zwrotnym serwerem proxy lub modułem równoważenia obciążenia instytucji, tak aby użytkownicy mogli uzyskiwać dostęp do portalu z użyciem portów domyślnych. W tym celu należy podać w portalu pewne informacje dotyczące zwrotnego serwera proxy lub modułu równoważenia obciążenia. Szczegółowe instrukcje można znaleźć w temacie Korzystanie ze zwrotnego serwera proxy z oprogramowaniem Portal for ArcGIS.

Po zakończeniu procedury wykonywania zadań aplikacja ArcGIS Web Adaptor będzie skonfigurowana do użycia z portalem ArcGIS Enterprise. Użytkownicy będą mieć dostęp do portalu i aplikacji ArcGIS Portal Administrator Directory tylko za pomocą zwrotnego serwera proxy z użyciem adresu URL w formacie URL https://reverseproxy.domain.com/webadaptorname/home zamiast korzystania z portu 7443.