Instalacja dyskretna oprogramowania Portal for ArcGIS w systemie Linux

Poniższa instrukcja przeprowadzi Cię przez proces dyskretnej instalacji oprogramowania Portal for ArcGIS.

Notatka:

Jeśli dokonujesz aktualizacji do wersji 11.0, zapoznaj się z tematem Aktualizacja portalu ArcGIS Enterprise, aby uzyskać więcej informacji.

Przygotowanie do instalacji oprogramowania Portal for ArcGIS

1. Sprawdź, czy witryna spełnia minimalne wymagania systemowe.
2. Zaloguj się na komputerze jako użytkownik z uprawnieniami administratora. Nie można zainstalować oprogramowania Portal for ArcGIS z poziomu użytkownika root.
3. Otwórz porty zgodnie z opisem w sekcji Porty używane przez oprogramowanie Portal for ArcGIS.
4. Zamknij wszystkie uruchomione na serwerze aplikacje nie mające krytycznego znaczenia.
5. Przejdź do pobranego katalogu zawierającego program instalacyjny oprogramowania Portal for ArcGIS lub umieść nośnik z oprogramowaniem Portal for ArcGIS w odpowiednim napędzie, aby automatycznie uruchomić program instalacyjny.

Wszystko jest teraz gotowe do rozpoczęcia instalacji oprogramowania Portal for ArcGIS.

Instalacja dyskretna oprogramowania Portal for ArcGIS w systemie Linux

1. Zapoznaj się z treścią umowy licencyjnej znajdującej się w lokalizacji <CD_ROOT or untar directory>/Documentation/EULA.pdf i zaakceptuj jej warunki.
2. Po wyświetleniu monitu uruchom instalację w trybie dyskretnym. Zapoznaj się z przykładową składnią podaną poniżej:

   <CD_ROOT or untar directory>/Setup -m silent -l yes

   Składnia: Setup [opcje]

   Opcja	Opis
   -m; --mode MODE	Opcjonalne. Wartość domyślna to GUI. Parametr MODE ma jedną z następujących wartości: silent, console lub gui.
   -l; --license-agreement CHOICE	Wymagane dla instalacji dyskretnej. Parametr CHOICE może mieć wartość Yes (Tak) albo No (Nie). Wartość Yes oznacza, że zapoznano się z warunkami Umowy ramowej Esri (E204, E300) i wyrażono na nie zgodę. Odwiedź stronę http://www.esri.com/legal/licensing-translations, aby przeczytać umowę.
   -d; --directory DIRECTORY	Opcjonalne. Domyślnie oprogramowanie Portal for ArcGIS jest instalowane w katalogu $HOME użytkownika. Parametr DIRECTORY pozwala podać inny katalog instalacji. Do katalogu instalacji dołączana jest ścieżka /arcgis/portal. Jeśli podczas instalacji wskażesz poprzedni katalog instalacji, zawarte w nim zasoby zostają automatycznie użyte w nowej instalacji. Korzystanie z zasobów z poprzednich instalacji w wersjach starszych niż 10.2 nie jest obsługiwane.
   -v; --verbose	Instalator zostaje uruchomiony w trybie diagnostycznym (ang. verbose mode).
   -h; --help	Wyświetlenie Pomocy w wierszu poleceń i zakończenie działania.
   -e; --examples	Wyświetlenie przykładów użycia opcji i zakończenie działania.

   Notatka:

   Istnieje także możliwość użycia narzędzia wiersza poleceń createportal w celu utworzenia portalu po zainstalowaniu oprogramowania Portal for ArcGIS.

Użycie narzędzia wiersza poleceń createportal w celu utworzenia portalu

Istnieją następujące sposoby używania narzędzia createportal:

• Uruchomienie narzędzia createportal wiersza poleceń w roli administratora i określenie parametrów: imię, nazwisko, nazwę użytkownika, hasło, adres e-mail, pytanie weryfikacyjne, odpowiedź oraz katalog zasobów.
• Określenie pliku createportal.properties zawierającego podane parametry.

Aby użyć narzędzia wiersza poleceń createportal, uruchom skrypt createportal.sh z parametrem -h lub -help, jak pokazano poniżej:

<Portal for ArcGIS Installation Directory>/tools/createportal/createportal.sh -help

Przykład użycia narzędzia: createportal.sh [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [ -lf <arg>] [ -ut <arg>]

Przykład użycia z plikiem: createportal.sh [-f <FILE>]

Notatka:

Podając ścieżkę w pliku createportal.properties, należy poprzedzić ją znakiem odwrotnego ukośnika, na przykład C:\\arcgisportal lub \\\\<Absolute path to>\\<portal arcgisportal>.

Opcja	Opis
-fn; --firstname	Imię dla początkowego konta administratora używanego do konfiguracji portalu. Wpisy składające się z kilku wyrazów należy ująć w cudzysłów.
-ln; --lastname	Nazwisko dla początkowego konta administratora używanego do konfiguracji portalu. Wpisy składające się z kilku wyrazów należy ująć w cudzysłów.
-u; --username	Nazwa użytkownika dla początkowego konta administratora używanego do konfiguracji portalu. Nazwa użytkownika może składać się z cyfr 0–9, liter ASCII a–z i A–Z oraz ze znaku kropki (.).
-p; --password	Hasło dla początkowego konta administratora używanego do konfiguracji portalu. Hasło może składać się z cyfr 0–9, liter ASCII a–z i A–Z oraz ze znaku kropki (.).
-e; --email	Adres e-mail dla początkowego konta administratora używanego do konfiguracji portalu.
-qi; --question	Indeks pytania weryfikacyjnego służącego do przywracania zapomnianego hasła. Dostępne są następujące pytania weryfikacyjne podane wraz z odpowiadającym numerem indeksu: 1, W jakiej miejscowości się urodziłeś/-łaś? 2, Kto był patronem Twojej szkoły średniej? 3, Jak brzmi nazwisko panieńskie Twojej matki? 4, Jakiej marki był Twój pierwszy samochód? 5, Do jakiej szkoły średniej uczęszczałeś/-łaś? 6, Jakie jest nazwisko Twojego najlepszego przyjaciela/Twojej najlepszej przyjaciółki? 7, Jakie jest drugie imię Twojego najmłodszego brata/Twojej najmłodszej siostry? 8, Przy jakiej ulicy mieszkałeś/-łaś w dzieciństwie? 9, Jak nazywa się Twoja ulubiona postać fikcyjna? 10, Jak wabi się Twoje ulubione zwierzę domowe? 11, Jak nazywa się Twoja ulubiona restauracja? 12, Jaki jest tytuł Twojej ulubionej książki? 13, Jaka jest Twoja wymarzona praca? 14, Jakie było miejsce Twojej pierwszej randki?
-qa; --answer	Odpowiedź na pytanie weryfikacyjne określone za pomocą parametru -qi. Wpisy składające się z kilku wyrazów należy ująć w cudzysłów.
-d; --contentDirectory	Ścieżka bezwzględna i nazwa katalogu zasobów używanego do przechowywania danych hostowanych portalu. Domyślnie katalog zasobów portalu jest tworzony lokalnie w tej lokalizacji: <Portal for ArcGIS Installation Directory>/usr/arcgisportal
-f; --file	Plik właściwości dla narzędzia createportal. Domyślnie plik createportal.properties znajduje się w tej lokalizacji: <Portal for ArcGIS Installation Directory>\tools\createportal
-lf; --licenseFile	To jest ścieżka do pliku licencji portalu.
-ut; --userTypeID	To jest identyfikator typu użytkownika dla początkowego administratora. Ten parametr jest opcjonalny. Aby wygenerować dla parametru -ut listę zgodnych typów użytkowników, które są dostępne w instytucji, uruchom narzędzie listadministratorusertypes. Jeśli identyfikator typu użytkownika nie został podany, a plik licencji portalu zawiera jeden zgodny typ użytkownika, zostanie przypisany ten typ. Jeśli plik licencji zawiera wiele zgodnych typów użytkowników, zostanie przypisany tymczasowy typ użytkownika, a początkowy administrator będzie musiał wybrać typ użytkownika po zalogowaniu się.
-h; --help	Wyświetlenie pomocy w wierszu poleceń i zakończenie działania.

Poniżej znajduje się przykład pliku createportal.properties:

#
#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g [e-mail]
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally,
# e.g./<Portal for ArcGIS installation directory>/usr/arcgisportal.
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =

Pod koniec pracy narzędzia zostanie wyświetlony komunikat informujący o pomyślnym utworzeniu portalu.

Użycie narzędzia wiersza poleceń listadministratorusertypes do identyfikowania zgodnych typów użytkowników

Aby zidentyfikować listę identyfikatorów typów użytkowników, które zostały licencjonowane dla instytucji i są zgodne z rolą Administrator, uruchom narzędzie wiersza poleceń listadministratorusertypes. Spowoduje to uzyskanie listy danych wejściowych dla parametru -ut w narzędziu createportal. Uruchom narzędzie z parametrem -la, jak pokazano poniżej, używając pliku licencji portalu jako danych wejściowych:

<Portal for ArcGIS Installation Directory>/tools/createportal/listadministratorusertypes.sh

Przykład użycia narzędzia: listadministratorusertypes.sh [-la <arg>] lub listadministratorusertypes.sh [--listadministratorusertypes <arg>]

Konfiguracja po instalacji

Aby oprogramowanie Portal for ArcGIS było uruchamiane wraz z systemem operacyjnym, należy wykonać poniższe czynności specyficzne dla danego systemu operacyjnego.

Systemy operacyjne obsługujące usługę systemd

Jeśli system operacyjny obsługuje użycie usługi systemd do rozruchu i zarządzania procesami (jeśli na przykład jest używany system Red Hat 7.x), wykonaj następujące czynności w celu skonfigurowania uruchamiania oprogramowania Portal for ArcGIS wraz z systemem operacyjnym.

1. W wierszu poleceń przełącz się na użytkownika root.
2. Skopiuj plik jednostki <Portal for ArcGIS installation directory>/framework/etc/arcgisportal.service do katalogu /etc/systemd/system.. Po skopiowaniu pliku potwierdź, że plik /etc/systemd/system/arcgisportal.service ma skonfigurowane uprawnienia 600.

   Notatka:

   Ten plik jest instalowany z oprogramowaniem Portal for ArcGIS 11.0.

3. Nadal jako użytkownik root uruchom następujące polecenie, aby automatycznie utworzyć dowiązania w pliku /etc/systemd/system/multi-user.target.wants:

   # systemctl enable arcgisportal.service

4. Aby sprawdzić, czy usługa systemd została poprawnie skonfigurowana, uruchom ponownie usługę i sprawdź jej status.

   # systemctl stop arcgisportal.service
   # systemctl start arcgisportal.service
   # systemctl status arcgisportal.service

   Notatka:

   Aby uniemożliwić usłudze utworzenie zbyt wielu wątków i wykorzystanie wszystkich zasobów serwera, usługa systemd w wersji 228 lub nowszej, która jest dołączona do systemu SLES12 SP2 lub nowszego, konfiguruje maksymalną liczbę tworzonych wątków na 512. Użytkownicy systemu SLES12 mogą włączyć i zwiększyć ten limit, jeśli system jest mocno obciążony. Aby włączyć i podwyższyć ten limit, jako użytkownik root usuń znak komentarza i zmień następujący wiersz w pliku jednostki arcgisportal.service przed wdrożeniem go do katalogu /etc/systemd/system: # TasksMax=512

5. Zakończ sesję użytkownika root.
6. Uruchom ponownie system operacyjny i sprawdź, czy witryna Portal for ArcGIS uruchamia się poprawnie.

Systemy operacyjne obsługujące usługę SysV

Jeśli system operacyjny obsługuje użycie usługi SysV do rozruchu i zarządzania procesami, wykonaj następujące czynności w celu skonfigurowania uruchamiania witryny Portal for ArcGIS wraz z systemem operacyjnym.

1. W wierszu poleceń przełącz się na użytkownika root.
2. Skopiuj skrypt powłoki <Portal for ArcGIS installation directory>/framework/etc/arcgisportal i wklej go do odpowiedniej lokalizacji w obsługiwanym systemie Linux zależnie od używanej dystrybucji:
   • RHEL: /etc/rc.d/init.d/
   • SUSE: /etc/init.d/
3. Zmień katalog na odpowiedni w danym przypadku katalog init.d i sprawdź skrypt arcgisportal, aby upewnić się, że użytkownik root ma co najmniej uprawnienia odczytu i wykonywania.
4. Zmodyfikuj skrypt w następujący sposób:

   1. Zaktualizuj zmienną portalhome, podając jako jej wartość ścieżkę katalogu instalacyjnego witryny Portal for ArcGIS, na przykład /home/username/arcgis/portal.

   2. W systemie RHEL należy dodać poniższy wiersz przed parametrem # Description: Portal for ArcGIS Service:

      # chkconfig: 35 99 01

   3. Zapisz zmiany w skrypcie arcgisportal.

5. Korzystając nadal z konta użytkownika root, uruchom następujące polecenia, aby automatycznie utworzyć łącza w pliku /etc/rc*.d o odpowiednim poziomie uruchamiania:
   • RHEL:

     $ chkconfig --add arcgisportal
     $ chkconfig arcgisportal on

   • SUSE:

     $ insserv arcgisportal
     $ chkconfig arcgisportal on

6. Zakończ sesję użytkownika root.
7. Uruchom ponownie system operacyjny i sprawdź, czy witryna Portal for ArcGIS uruchamia się poprawnie.