Uaktualnianie serwera ArcGIS Notebook Server w systemie Windows Server 2019 (kontenery systemu Linux)

Aktualizacja serwera ArcGIS Notebook Server zapewnia instytucji najnowsze funkcje i udoskonalenia oprogramowania, zachowując istniejące notatniki użytkowników. W przypadku aktualizacji wdrożenia ArcGIS Enterprise do wersji 11.2 konieczne jest również zaktualizowanie aplikacji ArcGIS Notebook Server.

Pakiet instalacyjny aplikacji ArcGIS Notebook Server 11.2 wykrywa, czy na komputerze istnieje instalacja poprzedniej wersji aplikacji ArcGIS Notebook Server. Jeśli tak, można zaktualizować oprogramowanie do wersji 11.2.

Jeśli przeprowadzono aktualizację z wersji 10.8.1 lub wcześniejszej, podczas procesu aktualizacji konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 11.2.

Konieczne jest również zainstalowanie nowych obrazów kontenera od firmy Esri, aby udostępnić środowiska wykonawcze notatników użytkownikom z wersją 11.2. Środowiska wykonawcze notatników z poprzedniej wersji pozostaną w witrynie, użytkownicy wciąż mogą nadal uruchamiać notatniki z ich użyciem. Jednak jeśli użytkownicy chcą skorzystać z nowej funkcjonalności w wersji 11.2, muszą zaktualizować środowisko wykonawcze swoich notatników. Środowiska wykonawcze notatników odpowiadające wersji 11.2 są w wersji 9.0 (ArcGIS Notebook Server Standard 9.0 i ArcGIS Notebook Server Advanced 9.0).

Notatka:

Jeśli istnieją notatniki używające niestandardowych środowisk wykonawczych, należy odbudować i ponownie zarejestrować te środowiska w programie Notebook Server w systemie Windows, a następnie zaktualizować ustawienia środowisk wykonawczych w powiązanych z nimi elementami notatników.

Notatka:

Środowiska wykonawcze notatników zostaną wycofane po zakończeniu cyklu życia oprogramowania ArcGIS Enterprise. Notatniki nie powinny używać przestarzałych środowisk wykonawczych i powinny zostać zaktualizowane do obsługiwanego środowiska wykonawczego.

Aktualizacja portalu ArcGIS Enterprise zaktualizuje również przykładowe notatniki dostępne w galerii witryny.

Witryny z wieloma komputerami aplikacji ArcGIS Notebook Server są obsługiwane w wersji 10.7.1 i nowszych. Jeśli masz witrynę zawierającą jeden komputer i chcesz po aktualizacji rozbudować swoją witrynę ArcGIS Notebook Server do wielu komputerów, wykonaj instrukcje, aby dołączyć dodatkowe komputery do witryny po zakończeniu aktualizacji do wersji 11.2.

Proces aktualizacji aplikacji ArcGIS Notebook Server jest aktualizacją bez zmiany jej lokalizacji i nie wymaga odinstalowania i ponownego instalowania oprogramowania. W czasie trwania procesu aktualizacji witryna będzie wyłączona i użytkownicy nie będą mieć dostępu ani możliwości uruchamiania notatników, dopóki aktualizacja nie zostanie zakończona.

Aby zaktualizować aplikację ArcGIS Notebook Server do wersji 11.2, wykonaj następujące czynności.

Przygotowanie do aktualizacji

Przed przystąpieniem do aktualizacji przeczytaj uważnie poniższe informacje:

• Przed aktualizacją możesz uzyskać dostęp do wszystkich niezbędnych plików w witrynie My Esri, w tym do obrazów kontenera 11.2.
• Aby aplikacja ArcGIS Notebook Server działała poprawnie, jej wersja musi być zgodna z wersją portalu, z którym jest sfederowana.
• Jeśli serwer Notebook Server działa aktualnie w trybie tylko do odczytu, wyłącz ten tryb przed rozpoczęciem procesu aktualizacji.
• Uaktualnij oprogramowanie Docker Desktop for Windows do wersji 4.19.0 lub nowszej.
• Aby zaktualizować swoje wdrożenie ArcGIS Enterprise, wykonaj następujące czynności:
  1. Zaktualizuj oprogramowanie Portal for ArcGIS.
  2. Zaktualizuj aplikację ArcGIS Web Adaptor (dla portalu).
  3. Zaktualizuj witrynę ArcGIS Server służącą jako serwer hostujący portalu.
  4. Zaktualizuj aplikację ArcGIS Web Adaptor (dla serwera).
  5. Zaktualizuj aplikację ArcGIS Data Store (najpierw podstawową, potem zapasową).
  6. Zaktualizuj wszystkie pozostałe serwery, włącznie z aplikacją ArcGIS Notebook Server.
  7. Zainstaluj przykładowe dane aplikacji ArcGIS Notebook Server
• Nie należy odinstalowywać istniejącej instalacji ArcGIS Notebook Server. Instalatory konfiguracji i wiersza poleceń ArcGIS Notebook Server i wiersza poleceń są zaprojektowane do wykrywania i aktualizowania istniejącej instalacji komponentów ArcGIS Notebook Server.
• Nie przeprowadzaj anulowania sfederowania witryny ArcGIS Notebook Server z portalu ani nie usuwaj jej wyznaczenia jako serwer notatników portalu w żadnym momencie procesu aktualizacji. Niekorzystnie to wpływa na istniejące notatniki hostowane przez portal.
• Aby zaktualizować oprogramowanie ArcGIS Notebook Server, można użyć instalatora konfiguracji lub instalatora wiersza poleceń. Wybierz jedną z tych metod aktualizacji.
• Przed aktualizacją wyczyść pamięć podręczną wszystkich przeglądarek internetowych używanych na komputerze ArcGIS Notebook Server.
• Konto usługi Windows dla witryny ArcGIS Notebook Server (jej konto Uruchom jako) musi pozostać takie samo przy aktualizacji.

Tworzenie kopii zapasowej wdrożenia

Przed aktualizacją zalecane jest wykonanie kopii zapasowych wdrożenia.

Notatniki zostaną dołączone do kopii zapasowych portalu za pomocą narzędzia webgisdr.

Do utworzenia kopii zapasowej magazynu konfiguracji serwera witryny można użyć operacji exportSite w aplikacji ArcGIS Notebook Server Administrator Directory, jak opisano poniżej. Oprócz kopii zapasowej konfiguracji tej witryny rozważ utworzenie ręcznych kopii zapasowych systemu plików.

Aby uruchomić operację tworzenia kopii zapasowej, wykonaj następujące czynności:

1. Otwórz aplikację ArcGIS Notebook Server Administrator Directory i zaloguj się jako użytkownik z uprawnieniami administratora.

   Adres URL to zwykle: https://notebookserver.domain.com:11443/arcgis/admin.

2. Przejdź do opcji witryna > Eksportuj witrynę.
3. Podaj pełną ścieżkę lokalizacji na komputerze, do której ma zostać wyeksportowany plik.

   Witryna musi mieć dostęp do tego katalogu.

4. Kliknij przycisk Eksportuj.

   Po zakończeniu operacji eksportowania katalog udostępnia łącze do lokalizacji pliku kopii zapasowej na serwerze.

5. Tak szybko, jak to możliwe pobierz plik, który będzie mieć rozszerzenie nazwy pliku .agssite.

Aktualizacja za pomocą programu instalacyjnego

Notatka:

Użyj pliku instalacyjnego, aby zaktualizować aplikację ArcGIS Notebook Server do wersji 11.2. Po zaktualizowaniu programu instalacyjnego należy zaktualizować witrynę ArcGIS Notebook Server, korzystając z kreatora konfiguracji lub narzędzia do aktualizacji witryny.

Jeśli masz witrynę z wieloma komputerami, wykonaj czynności od 1 do 3 dla jednego komputera i ponów te czynności dla każdego komputera w witrynie.

Program ArcGIS Notebook Server jest zaprojektowany do wykrywania i aktualizowania istniejącej instalacji komponentów ArcGIS Notebook Server.

1. Aby rozpocząć aktualizację, uruchom program ./Setup w miejscu, w którym zostało rozpakowane oprogramowanie ArcGIS Notebook Server i postępuj zgodnie z instrukcjami aktualizacji.

   Program instalacyjny należy uruchomić z konta użytkownika, który zainstalował istniejące oprogramowanie ArcGIS Notebook Server. Podczas instalacji program instalacyjny identyfikuje istniejącą instalację i prosi o potwierdzenie aktualizacji. Aby kontynuować instalację, wprowadź wybór y.

   Spowoduje to odinstalowanie poprzedniej wersji oprogramowania ArcGIS Notebook Server i zainstalowanie zaktualizowanej wersji ArcGIS Notebook Server.

2. Po zakończeniu działania narzędzia aktualizacji konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 11.2. Aby przeprowadzić autoryzację, użyj kreatora autoryzacji oprogramowania.
3. Otwórz kreator konfiguracji, korzystając z adresu URL wymienionego na zakończenie aktualizowania instalacji i postępuj zgodnie z wyświetlanymi instrukcjami, aby zaktualizować witrynę.
4. W przypadku witryny z wieloma komputerami wykonaj czynności od 1 do 3 dla każdego komputera w witrynie.

Aktualizacja przy użyciu wiersza poleceń

Aby przeprowadzić uaktualnienie z poziomu wiersza polecenia, wykonaj następujące czynności:

1. Aby rozpocząć aktualizację, uruchom polecenie instalacji serwera ArcGIS Notebook Server z argumentami przedstawionymi w poniższym przykładzie. Konieczne jest użycie tego samego konta ArcGIS Notebook Server, które jest używane przez istniejącą instalację.

   Powoduje to odinstalowanie poprzedniej wersji oprogramowania ArcGIS Notebook Server i zainstalowanie zaktualizowanej wersji ArcGIS Notebook Server.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Użyj narzędzia upgradesite i przeprowadź aktualizację, uruchamiając następujące polecenie. Domyślnie narzędzie upgradesite znajduje się w katalogu C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

   upgradesite.bat -s

   Narzędzie wyświetla raporty postępu i zatrzymuje się po zakończeniu aktualizacji. To narzędzie ma dwa parametry:

   • -s — gdy zostanie dołączony do polecenia, narzędzie uruchomi aktualizację. Aktualizacja nie zostanie uruchomiona bez parametru -s. Ma to na celu zapewnienie, że aktualizacja zostanie uruchomiona dopiero po osiągnięciu gotowości.
   • -h — wyświetla pomoc dla narzędzia. Gdy polecenie zostanie uruchomione bez parametru -s, zostanie również wyświetlona pomoc.

3. W przypadku witryny z wieloma komputerami powtórz czynności 1 i 2 dla każdego komputera w witrynie i przejdź do czynności przedstawionych w następnej sekcji.

Autoryzowanie dyskretne

Po zakończeniu działania narzędzia aktualizacji konieczna jest ponowna autoryzacja serwera ArcGIS Notebook Server dla wersji 11.2.

Uruchom polecenie SoftwareAuthorization.exe, używając następującej składni, aby autoryzować oprogramowanie ArcGIS Notebook Server w trybie dyskretnym. Przed uruchomieniem tego pliku wszystkie informacje o użytkowniku muszą zostać wprowadzone w pliku autoryzacji lub w pliku wsadowym licencji.

Jeśli masz plik autoryzacji i komputer jest połączony z internetem, uruchom następujące elementy:

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

Autoryzacja w środowisku bez połączenia z siecią

Aplikację ArcGIS Notebook Server można autoryzować w środowisku bez połączenia z siecią, korzystając z pliku wsadowego licencji (.prvc). Podczas procesu jest generowany plik do wysłania do firmy Esri w celu zakończenia procesu.

1. Po zakończeniu aktualizacji aplikacji ArcGIS Notebook Server i wyświetleniu monitu uruchom podane poniżej polecenie:

   <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. Po utworzeniu pliku danych wynikowych wykonaj jedną z następujących czynności:
   • Przejdź do witryny samoobsługowej Esri. Postępuj zgodnie z instrukcjami wyświetlonymi na ekranie, aby przesłać plik danych autoryzacji i pobrać plik autoryzacyjny .ecp.
   • Wyślij plik danych autoryzacji pocztą elektroniczną na adres [e-mail]. Firma Esri odeśle z powrotem plik autoryzacyjny .ecp pocztą elektroniczną.
3. Po otrzymaniu pliku autoryzacyjnego .ecp jedną z powyższych metod uruchom ponownie skrypt authorizeSoftware, aby go przetworzyć i zakończyć proces autoryzacji serwera:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

Powtórz tę procedurę wykonywania zadań dla każdego komputera z uruchomioną aplikacją ArcGIS Notebook Server.

Czynności po zaktualizowaniu

Przed użyciem uaktualnionej i ponownie autoryzowanej witryny ArcGIS Notebook Server należy uruchomić narzędzie poinstalacyjne, aby dodać nowe obrazy kontenera Docker do witryny. Należy również zastąpić instancje aplikacji ArcGIS Web Adaptor zarejestrowane w witrynie, aby były zgodne z nową wersją.

Uruchamianie narzędzia poinstalacyjnego

Aby uruchomić narzędzie poinstalacyjne, wykonaj następujące czynności:

1. Otwórz okno wiersza poleceń jako administrator.
2. Przejdź do folderu narzędzi aplikacji ArcGIS Notebook Server. Domyślnie jest to ścieżka C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility..
3. Opcjonalnie zapoznaj się z pomocą do tego narzędzia, uruchamiając następujące polecenie: PostInstallUtility.bat -h
4. Aplikacja ArcGIS Notebook Server wymaga, aby na komputerze była zainstalowana platforma Docker Engine Community Edition. Sprawdź, czy platforma Docker jest aktywna na komputerze, wykonując następujące polecenie: PostInstallUtility.bat -d
5. Jeśli platforma Docker Desktop nie jest zainstalowana, zainstaluj ją teraz.

   Program ArcGIS Notebook Server działa w kontenerach systemu Linux na platformie Docker Desktop. Podczas instalowania platformy Docker Desktop trzeba wybrać kontenery systemu Linux — nie wolno klikać opcji Przełącz na kontenery systemu Windows.

6. Podczas korzystania z platformy Docker Desktop zmodyfikuj każde z następujących ustawień:
   1. Kliknij prawym przyciskiem myszy przycisk Docker na pasku zadań i kliknij opcję Ustawienia. W obszarze Ogólne zaznacz opcję Ujawnij demona w tcp://localhost:2375 bez szyfrowania TLS.

      Używany będzie protokół Docker Remote API, który wymaga portu 2375.

   2. Kliknij prawym przyciskiem myszy przycisk Docker na pasku zadań i kliknij opcję Ustawienia. W menu Ustawienia kliknij opcję Zasoby > Udostępnianie plików i dodaj katalog na dysku, który będzie używany jako magazyn konfiguracji aplikacji ArcGIS Notebook Server.

      Notatka:

      Środowisko Docker dla systemu Windows obsługuje tylko katalogi lokalne w systemie Windows, które mają być udostępniane kontenerom Linux.

7. Zainstaluj obraz Notebooks, określając jego ścieżkę. Obraz powinien być skompresowany w formacie .tar.gz. Jeśli masz licencję Advanced i platformę Docker Desktop, wykonaj to polecenie dwa razy, aby zainstalować standardowy i zaawansowany obraz kontenera, które pobrano z witryny My Esri.

   Notatka:

   Sprawdź, czy na komputerze jest co najmniej 75 GB wolnego miejsca na dysku.

   Uruchom następujące polecenie: PostInstallUtility.bat -l <path of .tar.gz Docker image>

   Notatka:

   Należy pamiętać, aby zainstalować obydwa obrazy kontenerów. Nawet jeśli używana jest licencja Advanced, użytkownicy mogą potrzebować standardowego środowiska wykonawczego.

Instalowanie i konfigurowanie przykładowych danych aplikacji ArcGIS Notebook Server

Przy konfigurowaniu witryny aplikacji ArcGIS Notebook Server z wieloma komputerami należy zainstalować i skonfigurować przykładowe dane tylko na pierwszym komputerze, na którym została zainstalowana aplikacja Notebook Server i utworzona witryna.

Aby zainstalować i skonfigurować przykładowe dane, wykonaj następujące czynności:

1. Uruchom kreatora instalacji przykładowych danych aplikacji ArcGIS Notebook Server pobranego z witryny My Esri.

   Przykładowe dane są zainstalowane w katalogu, w którym jest zainstalowana aplikacja ArcGIS Notebook Server.

2. Otwórz okno wiersza poleceń jako administrator.
3. Przejdź do folderu narzędzi aplikacji ArcGIS Notebook Server.

   Domyślnie jest to ścieżka C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

4. Opcjonalnie zapoznaj się z pomocą narzędzia, uruchamiając następujące polecenie:

    > PostInstallUtility.bat -h

5. Uruchom narzędzie poinstalacyjne, aby wydzielić przykładowe dane w katalogu arcgisworkspace witryny serwera notatników:

    PostInstallUtility.bat -x

Zastępowanie instancji aplikacji ArcGIS Web Adaptor

Aby zastąpić instancje aplikacji ArcGIS Web Adaptor, wykonaj następujące czynności:

1. Poprzednią instancję aplikacji ArcGIS Web Adaptor należy wyrejestrować z witryny i odinstalować.
   1. Zaloguj się do aplikacji ArcGIS Notebook Server Administrator Directory.
   2. Przejdź do opcji System > Aplikacje Web Adaptor > zarejestrowany komputer.
   3. Kliknij opcję Wyrejestruj aplikację Web Adaptor.
2. Zainstaluj nowe wystąpienie aplikacji ArcGIS Web Adaptor 11.2 i skonfiguruj je przy użyciu aplikacji ArcGIS Notebook Server.
Po zakończeniu aktualizacji wdrożenia możesz korzystać z funkcji wersji 11.2.
3. W przypadku aktualizacji z wersji 10.8 lub wcześniejszej, aby umożliwić planowanie notatników w portalu, wykonaj następujące czynności:
   1. Opcjonalnie zaktualizuj dowolną z ról niestandardowych zawierających uprawnienia do notatnika, aby dodać nowe uprawnienie Zaplanuj notatniki.
   2. Udziel autorom notatników instrukcji, aby zaktualizowali czas wykonywania swoich poszczególnych notatników, jeśli chcą użyć funkcji planowanego uruchamiania.

      Planowanie uruchamiania dotyczy tylko notatników korzystających ze środowiska wykonawczego 10.8.1 (wersja 4.0) lub nowszego.

Witryna ArcGIS Notebook Server 11.2 jest gotowa do hostowania aplikacji ArcGIS Notebooks.