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.5 konieczne jest również zaktualizowanie oprogramowania ArcGIS Notebook Server.
Pakiet instalacyjny oprogramowania ArcGIS Notebook Server 11.5 wykrywa, czy na komputerze istnieje instalacja poprzedniej wersji oprogramowania ArcGIS Notebook Server. Jeśli tak, można zaktualizować oprogramowanie do wersji 11.5.
Jeśli przeprowadzono uaktualnienie z wersji 10.8.1 lub wcześniejszej, podczas procesu uaktualniania konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 11.5.
Konieczne jest również zainstalowanie nowych obrazów kontenera od firmy Esri, aby udostępnić środowiska wykonawcze notatników użytkownikom z wersją 11.5. Ś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.5, muszą zaktualizować środowisko wykonawcze swoich notatników. Środowiska wykonawcze notatników odpowiadające wersji 11.5 są w wersji 11.1 (opcje ArcGIS Notebook Server Standard 11.1 i ArcGIS Notebook Server Advanced 11.1).
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. Środowisko wykonawcze notatnika zostanie wycofane w tym samym momencie, w którym zostanie wycofana powiązana wersja 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.
Obsługiwane są witryny ArcGIS Notebook Server z wieloma komputerami. Jeśli masz witrynę zawierającą jeden komputer i chcesz po uaktualnieniu rozbudować witrynę ArcGIS Notebook Server do wielu komputerów, wykonaj instrukcje, aby dołączyć dodatkowe komputery do witryny po zakończeniu uaktualniania do wersji 11.5.
Proces aktualizacji oprogramowania 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ć oprogramowanie ArcGIS Notebook Server do wersji 11.5, wykonaj następujące czynności.
Przygotowanie do aktualizacji
Przed przystąpieniem do uaktualniania przeczytaj 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.5.
- Aby oprogramowanie ArcGIS Notebook Server działała poprawnie, jej wersja musi być zgodna z wersją portalu, z którym jest sfederowana.
- Jeśli serwer notatników działa aktualnie w trybie tylko do odczytu, wyłącz ten tryb przed rozpoczęciem procesu uaktualniania.
- Uaktualnij oprogramowanie Docker do wersji 28.0.1 lub nowsza.
- Aby zaktualizować swoje wdrożenie ArcGIS Enterprise, wykonaj następujące czynności:
- Uaktualnij oprogramowanie Portal for ArcGIS.
- Uaktualnij aplikację ArcGIS Web Adaptor (dla portalu).
- Uaktualnij witrynę ArcGIS Server służącą jako serwer hostujący portalu.
- Uaktualnij aplikację ArcGIS Web Adaptor (dla serwera).
- Zaktualizuj aplikację ArcGIS Data Store (najpierw podstawową, potem zapasową).
- Zaktualizuj wszystkie pozostałe serwery, włącznie z oprogramowaniem 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.
- Na żadnym etapie procesu uaktualniania nie przeprowadzaj anulowania sfederowania witryny ArcGIS Notebook Server z portalu ani nie usuwaj jej wyznaczenia jako serwera notatników portalu. Niekorzystnie to wpływa na istniejące notatniki hostowane przez portal.
- Aby uaktualnić oprogramowanie ArcGIS Notebook Server, można użyć programu instalacyjnego lub instalatora działającego w wierszu polecenia. Wybierz jedną z tych metod aktualizacji.
- Przed aktualizacją wyczyść pamięć podręczną wszystkich przeglądarek internetowych używanych na komputerze ArcGIS Notebook Server.
Przenoszenie katalogu przestrzeni roboczej
Ten proces jest wymagany w przypadku wdrożeń serwera ArcGIS Notebook Server w systemie Linux na jednym komputerze, gdy katalog przestrzeni roboczej znajduje się w katalogu instalacyjnym serwera notatników.
Notatka:
Nie musisz wykonywać tej czynności, jeśli katalog przestrzeni roboczej znajduje się już poza katalogiem instalacyjnym oprogramowania Notebook Server.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Kliknij kartę Ustawienia.
- Kliknij opcję Katalogi.
- Ustal, czy bieżąca ścieżka do katalogu arcgisworkspace znajduje się w katalogu instalacyjnym programu ArcGIS Notebook Server.
<installdir>/arcgis/notebook/directories/arcgisworkspace
Jeśli katalog arcgisworkspace znajduje się w katalogu instalacyjnym programu ArcGIS Notebook Server, przed uaktualnieniem należy przenieść katalog przestrzeni roboczej do lokalizacji poza katalogiem instalacyjnym.
Jeśli katalog arcgisworkspace nie znajduje się w katalogu instalacyjnym programu ArcGIS Notebook Server, nie trzeba wykonywać pozostałych czynności wymienionych w tej sekcji.
- Kliknij przycisk Edytuj związany z katalogiem arcgisworkspace.
- Zastąp istniejącą ścieżkę katalogu arcgisworkspace nową ścieżką znajdującą się poza katalogiem instalacyjnym.
<installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace
- Kliknij przycisk Zapisz.
- Skopiuj ręcznie całą zawartość znajdującą się w poprzednim katalogu arcgisworkspace do nowego katalogu arcgisworkspace.
Aktualizowanie lokalizacji magazynu konfiguracji
Ten proces jest wymagany w przypadku wdrożeń oprogramowania ArcGIS Notebook Server w systemie Linux, gdy katalog przestrzeni roboczej znajduje się w katalogu instalacyjnym oprogramowania Notebook Server. Więcej informacji można znaleźć w temacie Określanie lokalizacji magazynu konfiguracji.
Notatka:
Nie musisz wykonywać tej czynności, jeśli witryna używa magazynu konfiguracji w chmurze lub jeśli magazyn konfiguracji znajduje się już poza katalogiem instalacyjnym oprogramowania Notebook Server.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Kliknij kartę Ustawienia.
- Kliknij opcję Magazyn konfiguracji.
- Sprawdź, czy magazyn konfiguracji znajduje się w katalogu instalacyjnym oprogramowania Notebook Server.
Przykładowy katalog: /installation_directory/arcgis/notebookserver/usr/config-store.
- Jeśli magazyn konfiguracji znajduje się w katalogu instalacyjnym oprogramowania Notebook Server, przenieś konfigurację do lokalizacji zewnętrznej, wykonując następujące czynności:
- Zaktualizuj ścieżkę, podając nową lokalizację.
Przykładowy katalog: /installation_directory/arcgisnotebookserver/usr/config-store.
- Kliknij przycisk Tak, aby przenieść bieżącą konfigurację.
- Kliknij przycisk Zapisz.
- Zaktualizuj ścieżkę, podając nową lokalizację.
Aktualizowanie katalogów serwera
Ten proces jest wymagany w przypadku wdrożeń oprogramowania ArcGIS Notebook Server w systemie Linux, gdy katalogi serwera znajdują się w katalogu instalacyjnym oprogramowania Notebook Server.
Notatka:
Nie musisz wykonywać tej czynności, jeśli katalog serwera znajduje się już poza katalogiem instalacyjnym oprogramowania Notebook Server.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Kliknij kartę Ustawienia.
- Kliknij opcję Katalogi.
- Sprawdź, czy w katalogu instalacyjnym znajdują się katalogi arcgisoutput, arcgisjobs i arcgissystem.
/installation_directory/arcgis/notebookserver/usr/directories
- Jeśli znajdują się w katalogu instalacyjnym, wykonaj następujące czynności dla każdego katalogu.
- Kliknij przycisk Edytuj.
- Zaktualizuj ścieżkę, podając nową lokalizację.
Przykładowy katalog: /installation_directory/arcgisnotebookserver/usr/directories/<server directory>.
- Kliknij przycisk Zapisz.
Aktualizowanie katalogu dzienników
Ten proces jest wymagany w przypadku wdrożeń oprogramowania ArcGIS Notebook Server w systemie Linux, gdy katalogi dzienników znajdują się w katalogu instalacyjnym oprogramowania Notebook Server.
Notatka:
Nie musisz wykonywać tej czynności, jeśli katalog dzienników znajduje się już poza katalogiem instalacyjnym oprogramowania Notebook Server.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Kliknij kartę Ustawienia.
- Kliknij opcję Dzienniki.
- Sprawdź, czy katalog Logs znajduje się w katalogu instalacyjnym.
/installation_directory/arcgis/notebookserver/usr/directories
- Jeśli znajduje się w katalogu instalacyjnym, wykonaj następujące czynności, aby przenieść go do lokalizacji zewnętrznej.
- Zaktualizuj ścieżkę, podając nową lokalizację.
Przykładowy katalog: /installation_directory/arcgisnotebookserver/logs.
- Kliknij przycisk Zapisz.
- Ręcznie skopiuj wszystkie zasoby ze starego katalogu Logs do nowej lokalizacji.
- Zaktualizuj ścieżkę, podając nową lokalizację.
Tworzenie kopii zapasowej wdrożenia
Przed uaktualnieniem zalecane jest wykonanie kopii zapasowych wdrożenia.
Więcej informacji można znaleźć w temacie Tworzenie i odtwarzanie kopii zapasowej aplikacji ArcGIS Notebook Server.
Uaktualnianie mechanizmu kontenerów
Uaktualnij mechanizm kontenerów do obsługiwanej wersji.
Notatka:
W przypadku witryny Notebook Server na wielu komputerach wykonaj tę czynność na każdym komputerze.
Aktualizacja za pomocą programu instalacyjnego
Notatka:
Użyj pliku instalacyjnego, aby zaktualizować oprogramowanie ArcGIS Notebook Server do wersji 11.5. 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.
Aby wykonać uaktualnienie za pomocą programu instalacyjnego, wykonaj następujące czynności:
- Uruchom program ./Setup w lokalizacji, w której zostało rozpakowane oprogramowanie ArcGIS Notebook Server i postępuj zgodnie z instrukcjami uaktualniania.
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.
Powoduje to odinstalowanie poprzedniej wersji oprogramowania ArcGIS Notebook Server i zainstalowanie zaktualizowanej wersji ArcGIS Notebook Server.
- Po zakończeniu działania narzędzia aktualizacji konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 11.5. Aby przeprowadzić autoryzację, użyj kreatora autoryzacji oprogramowania.
- Otwórz kreator konfiguracji, korzystając z adresu URL wymienionego na zakończenie uaktualniania instalacji i postępuj zgodnie z wyświetlanymi instrukcjami, aby uaktualnić witrynę.
- 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:
- Aby rozpocząć uaktualnienie, uruchom program ./Setup w lokalizacji, w której zostało rozpakowane oprogramowanie ArcGIS Notebook Server z argumentami przedstawionymi w poniższym przykładzie i postępuj zgodnie z instrukcjami uaktualnienia.
Powoduje to odinstalowanie poprzedniej wersji oprogramowania ArcGIS Notebook Server i zainstalowanie zaktualizowanej wersji ArcGIS Notebook Server.
<untar directory>/Setup -l yes -m silent - Po zakończeniu działania narzędzia aktualizacji konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 11.5. Uruchom autoryzację oprogramowania, używając następującej składni, aby autoryzować oprogramowanie ArcGIS Notebook Server w trybie dyskretnym:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftwareUruchom następujące polecenie, aby wyświetlić wszystkie opcje autoryzacji:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpNotatka:
Sekcja Autoryzacja w środowisku bez połączenia z siecią poniżej zawiera informacje o autoryzacji instalacji programu ArcGIS Notebook Server w środowisku bez połączenia z siecią. - Zaktualizuj witrynę, korzystając z narzędzia wiersza poleceń upgradesite.
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.
Domyślnie narzędzie upgradesite jest dostępne tutaj: ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.
Przed aktualizacją zapoznaj się z informacjami o przygotowaniu znajdującymi się na początku tego tematu. Gdy wszystko będzie gotowe do aktualizacji, otwórz terminal poleceń na aktualizowanym komputerze. Przejdź do katalogu, w którym znajduje się narzędzie i uruchom następujące polecenie:
> ./upgradesite.sh -sNarzędzie wyświetla raporty postępu i zatrzyma się po zakończeniu aktualizacji.
- W przypadku witryny z wieloma komputerami wykonaj czynności od 1 do 3 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.5.
Uruchom autoryzację oprogramowania, używając następującej składni, aby autoryzować oprogramowanie ArcGIS Notebook Server w trybie dyskretnym:<ArcGIS Notebook Server install directory>/tools/authorizeSoftware<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help
Autoryzacja w środowisku bez połączenia z siecią
Oprogramowanie 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.
- Po zakończeniu aktualizacji aplikacji oprogramowania ArcGIS Notebook Server i wyświetleniu monitu uruchom podane poniżej polecenie:
<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output> - Po utworzeniu pliku danych wynikowych wykonaj jedną z następujących czynności:
- Przejdź do witryny samoobsługowej firmy 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 authorize@esri.com. Firma Esri odeśle z powrotem plik autoryzacyjny .ecp pocztą elektroniczną.
- Po otrzymaniu pliku autoryzacyjnego .ecp jedną z powyższych metod uruchom ponownie skrypt authorizeSoftware, aby go przetworzyć i zakończyć proces autoryzacji serwera:
<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>
Powtórz tę procedurę wykonywania zadań dla każdego komputera z uruchomionym oprogramowaniem 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ć wystąpienia 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:
- Otwórz terminal przy użyciu konta użytkownika, który zainstalował aplikację ArcGIS Notebook Server.
- Przejdź do folderu narzędzi aplikacji ArcGIS Notebook Server. Domyślnie jest to ścieżka ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Opcjonalnie zapoznaj się z pomocą do tego narzędzia, uruchamiając następujące polecenie: ./PostInstallUtility.sh -h
- Aplikacja ArcGIS Notebook Server wymaga, aby na komputerze była zainstalowana platforma Docker Engine. Sprawdź, czy platforma Docker jest aktywna na komputerze, wykonując następujące polecenie: ./PostInstallUtility.sh -d
- Jeśli wymagania dotyczące instalacji platformy Docker nie są spełnione, przeprowadź instalację teraz.
- 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.sh -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.
Notatka:
Starsze obrazy nie są automatycznie usuwane. Przed usunięciem poprzednich obrazów środowiska wykonawczego należy ręcznie zaktualizować środowiska wykonawcze powiązane z poszczególnymi notatnikami do nowszej wersji.
Zastępowanie instancji aplikacji ArcGIS Web Adaptor
Aby zastąpić instancje aplikacji ArcGIS Web Adaptor, wykonaj następujące czynności:
- Wyrejestruj z witryny poprzedniej wystąpienie aplikacji ArcGIS Web Adaptor i odinstaluj je.
- Zaloguj się do aplikacji ArcGIS Notebook Server Administrator Directory.
- Przejdź do opcji System > Aplikacje Web Adaptor > zarejestrowany komputer.
- Kliknij opcję Wyrejestruj aplikację Web Adaptor.
- Zainstaluj nowe wystąpienie aplikacji ArcGIS Web Adaptor 11.5 i skonfiguruj je przy użyciu aplikacji ArcGIS Notebook Server.
- W przypadku aktualizacji z wersji 10.8 lub wcześniejszej, aby umożliwić planowanie notatników w portalu, wykonaj następujące czynności:
- Opcjonalnie zaktualizuj dowolną z ról niestandardowych zawierających uprawnienia do notatnika, aby dodać nowe uprawnienie Zaplanuj notatniki.
- Udziel autorom notatników instrukcji, aby zaktualizowali środowiska wykonawcze swoich poszczególnych notatników, jeśli chcą używać funkcji planowania.
Planowanie uruchamiania dotyczy tylko notatników korzystających ze środowiska wykonawczego 10.8.1 (wersja 4.0) lub nowszego.
Witryna ArcGIS Notebook Server 11.5 jest gotowa do hostowania aplikacji ArcGIS Notebooks.
Aktualizowanie środowisk wykonawczych istniejących notatników i narzędzi internetowych
Każdy autor notatników musi wykonać ten proces w celu uaktualnienia tych notatników i narzędzi internetowych notatników na potrzeby korzystania z najnowszych środowisk wykonawczych notatników.
- Wykonaj czynności opisane w temacie Zmienianie środowiska wykonawczego notatnika, aby zaktualizować środowisko wykonawcze każdego elementu notatnika do najnowszego środowiska wykonawczego notatnika.
- Jeśli notatnik jest opublikowany jako narzędzie internetowe, po zaktualizowaniu środowiska wykonawczego notatnika zastąp to narzędzie internetowe.
- Jeśli istnieją notatniki działające w niestandardowych środowiskach wykonawczych, zaktualizuj te środowiska niestandardowe, a następnie zaktualizuj ustawienia środowisk wykonawczych w powiązanych z nimi elementach notatników.
Usuwanie poprzednich środowisk wykonawczych notatników
Opcjonalnie można usunąć wcześniejsze wersje obrazu środowisk wykonawczych oprogramowania ArcGIS Notebook Server, aby zwolnić miejsce na dysku.
Uwaga:
Zanim usuniesz wcześniejsze wersje, sprawdź, czy wszystkie istniejące notatniki zostały zaktualizowane i korzystają z najnowszej wersji obrazu środowiska wykonawczego oprogramowania ArcGIS Notebook Server.
- Otwórz wiersz poleceń jako administrator.
- Wprowadź następujące polecenie, aby wyświetlić listę bieżących obrazów i zanotować identyfikator obrazu (IMAGE ID) wcześniejszej wersji, którą chcesz usunąć.
docker images -a - Wprowadź następujące polecenie, aby usunąć wcześniejszą wersję środowiska wykonawczego.
docker image rm <IMAGE ID>