Aktualizacja aplikacji ArcGIS Notebook Server

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

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

Jeśli przeprowadzono aktualizację z wersji 10.7.1 lub wcześniejszej, podczas procesu aktualizowania konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 10.8.1. Nie musisz wykonywać ponownej autoryzacji swojego oprogramowania, jeśli wykonujesz aktualizację z wersji 10.8 do wersji 10.8.1.

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

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 10.8.1.

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 10.8.1, 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 10.8.1.
• Aby aplikacja ArcGIS Notebook Server działała poprawnie, jej wersja musi być zgodna z wersją portalu, z którym jest sfederowana.
• 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.
• Nie należy odinstalowywać istniejącej wersji aplikacji ArcGIS Notebook Server. Program instalacyjny i instalator aplikacji ArcGIS Notebook Server korzystający z 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 ArcGIS hostowane przez portal.
• Aby zaktualizować oprogramowanie ArcGIS Notebook Server, można użyć programu instalacyjnego lub instalatora korzystającego z 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.

Wcześniejsze:

W wersji 10.7 trzeba ręcznie utworzyć kopię zapasową magazynu konfiguracji witryny i katalogów serwera.

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.
5. Po zakończeniu operacji eksportowania katalog będzie udostępniał łącze do lokalizacji pliku kopii zapasowej na serwerze. Tak szybko, jak to możliwe pobierz plik, który będzie mieć rozszerzenie nazwy pliku .agssite.

Aktualizacja za pomocą programu instalacyjnego

Notatka:

Do aktualizacji aplikacji ArcGIS Notebook Server do wersji 10.8.1 zalecane jest użycie pliku instalacyjnego. Jeśli ograniczenia instytucji uniemożliwiają użycie pliku instalacyjnego, można wywołać operację Aktualizuj witrynę z aplikacji ArcGIS Notebook Server Administrator Directory za pomocą skryptu.

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

1. Podczas instalacji przeczytaj treść umowy ramowej i zaakceptuj jej warunki lub opuść okno kreatora, jeśli nie wyrażasz na nie zgody.

   Program instalacyjny wyświetli funkcje, które zostaną zainstalowane, a także informacje o wymaganym wolnym miejscu na twardym dysku.

2. W następnym oknie dialogowym podaj poświadczenia logowania konta lub plik konfiguracyjny.

   Konto ArcGIS Notebook Server używane przez istniejącą instalację jest wstępnie wprowadzone w polu Konto ArcGIS Server. Podaj hasło konta ArcGIS Notebook Server. Zwykle jest to hasło zdefiniowane podczas instalacji oprogramowania.

   Jeśli hasło nie zostanie poprawnie zweryfikowane, pojawi się komunikat o błędzie z informacją o nieprawidłowym haśle. Jeśli nie masz pewności co do hasła do konta ArcGIS Notebook Server, skontaktuj się z administratorem systemu lub zresetuj hasło za pomocą aplikacji ArcGIS Notebook Server Administrator Directory.

   Jeśli podajesz plik konfiguracyjny, poświadczenia w pliku konfiguracyjnym serwera muszą być poświadczeniami używanymi przez istniejącą witrynę ArcGIS Notebook Server.

3. Po wybraniu opcji Wprowadź nazwę użytkownika i hasło tego konta i ręcznym wprowadzeniu informacji o koncie ArcGIS Notebook Server można wyeksportować plik konfiguracyjny serwera w wyświetlonym oknie dialogowym. Jeśli nie chcesz eksportować pliku konfiguracyjnego, kliknij przycisk Dalej i zaakceptuj domyślną opcję Nie eksportuj pliku konfiguracyjnego. Jeśli chcesz eksportować plik konfiguracyjny serwera na potrzeby przyszłych instalacji, kliknij przycisk Eksportuj plik konfiguracyjny, przejdź do chronionego folderu i podaj nazwę pliku konfiguracyjnego.

   Notatka:

   Eksport pliku konfiguracyjnego serwera może być potrzebny w następujących sytuacjach:

   • Tworzenie tego samego konta ArcGIS Notebook Server podczas instalacji na wielu komputerach.
   • Zapisanie konta do użycia przy aktualizacji do nowszej wersji.
   • Przeprowadzanie instalacji dyskretnej, w której nazwa użytkownika i hasło są szyfrowane.

   Uwaga:

   Przy eksportowaniu pliku konfiguracyjnego serwera do udziału sieciowego konto o nazwie System lokalny na komputerze, na którym instalowane jest oprogramowanie ArcGIS Notebook Server musi mieć uprawnienia do zapisu do tego udziału sieciowego. Jeśli uprawnienia nie są skonfigurowane, plik konfiguracyjny serwera może się nie wyeksportować pomyślnie. W razie wątpliwości odnośnie do prawidłowego przydzielania uprawnień do udziału sieciowego skontaktuj się z administratorem systemu lub wyeksportuj plik konfiguracyjny serwera lokalnie i skopiuj go do udziału sieciowego.

4. Aby ukończyć instalację, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
5. Po zakończeniu instalacji w przeglądarce zostanie otworzony kreator konfiguracji. Aby zakończyć proces aktualizacji, postępuj zgodnie z instrukcjami w kreatorze konfiguracji.
6. Jeśli masz witrynę z wieloma komputerami, wykonaj czynności od 1 do 5 dla pozostałych komputerów witryny. Jeśli masz witrynę z jednym komputerem i planujesz modernizację do witryny z wieloma komputerami, możesz teraz dołączyć dodatkowe komputery do witryny. Musisz również zmodyfikować ścieżki katalogów serwera i magazynu konfiguracji, aby użyć udostępnionych lokalizacji dostępnych na poszczególnych komputerach. Wyjątkami są katalog przestrzeni roboczej i wszystkie niestandardowe katalogi danych, które muszą pozostawać lokalne na każdym komputerze i muszą być replikowane za pomocą systemu, na przykład DFS.

Aktualizacja przy użyciu wiersza poleceń

Począwszy od wersji 10.8, możesz również zaktualizować aplikację ArcGIS Notebook Server w wierszu poleceń za pomocą narzędzia upgradesite.

To narzędzie ma tylko 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 znajduje się w katalogu C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

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.bat -s

Narzędzie będzie wyświetlać raporty postępu i zatrzyma się po zakończeniu aktualizacji. Jeśli w witrynie jest wiele komputerów, powtórz to polecenie na każdym komputerze, a następnie przejdź do czynności w następnej sekcji.

Autoryzowanie dyskretne

Po zakończeniu działania narzędzia aktualizacji, jeśli przeprowadzono aktualizację z wersji 10.7.1 lub wcześniejszej, konieczna jest ponowna autoryzacja oprogramowania ArcGIS Notebook Server dla wersji 10.8.1. Nie musisz wykonywać ponownej autoryzacji swojego oprogramowania, jeśli wykonujesz aktualizację z wersji 10.8 do wersji 10.8.1.

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\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.7 /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). W trakcie procesu zostanie wygenerowany plik, który należy wysłać do firmy Esri, aby dokończyć ten proces.

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

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\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 internetowej obsługi klienta Esri pod adresem https://service.esri.com/drm. Postępuj zgodnie z instrukcjami wyświetlonymi na ekranie, aby przesłać plik danych autoryzacji i pobrać swój plik autoryzacyjny .ecp.
   • Wyślij swój plik danych autoryzacji pocztą elektroniczną na adres [e-mail]. Firma Esri odeśle z powrotem Twój plik autoryzacyjny .ecp pocztą elektroniczną.
3. Po otrzymaniu swojego 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 zaktualizowanej 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ą.

1. Otwórz okno wiersza polecenia przy użyciu konta Uruchom jako aplikacji ArcGIS Notebook Server.
2. Zainstaluj obraz Docker, określając jego ścieżkę. Obraz powinien być skompresowany w formacie .tar.gz. Jeśli masz licencję Advanced, wykonaj to polecenie dwa razy, aby zainstalować standardowy i zaawansowany obraz kontenera, które pobrano z witryny My Esri. > 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.

3. Poprzednią instancję aplikacji ArcGIS Web Adaptor należy wyrejestrować z witryny i odinstalować.
   1. Zaloguj się w aplikacji ArcGIS Notebook Server Administrator Directory.
   2. Przejdź do opcji System > Aplikacje Web Adaptor > zarejestrowany komputer.
   3. Kliknij opcję Wyrejestruj aplikację Web Adaptor.
4. Zainstaluj nową instancję aplikacji ArcGIS Web Adaptor 10.8.1 i zarejestruj ją w aplikacji ArcGIS Notebook Server.
5. Po zakończeniu aktualizacji wdrożenia możesz korzystać z funkcjonalności wersji 10.8.1. Aby umożliwić planowane uruchamianie notatników w portalu, wykonaj następujące czynności:

   • Zaktualizuj dowolną z ról niestandardowych zawierających uprawnienia do notatnika, aby dodać nowe uprawnienie Zaplanuj notatniki, jeśli jest potrzebne.
   • 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).

Witryna ArcGIS Notebook Server 10.8.1 jest gotowa do hostowania notatników ArcGIS.