Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Uaktualnianie systemu operacyjnego węzeł po węźle w Apigee Edge Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

W tym dokumencie opisujemy alternatywną metodę uaktualniania systemu operacyjnego serwerów w klastrze Apigee Edge Private Cloud. Zamiast konfigurować zupełnie nowe równoległe centrum danych, możesz uaktualnić system operacyjny w miejscu, na poszczególnych maszynach lub węzłach.

Zgodność

Zanim rozpoczniesz uaktualnianie systemu operacyjnego na poszczególnych węzłach, sprawdź, czy bieżąca wersja Apigee Edge dla chmury prywatnej obsługuje docelową wersję systemu operacyjnego. Aby to sprawdzić, zapoznaj się z tabelą zgodności systemów operacyjnych.

Wymagania wstępne

Zanim rozpoczniesz uaktualnianie węzła po węźle, sprawdź, czy wykonano te czynności:

Tworzenie kopii zapasowej wszystkich węzłów

Ze względów bezpieczeństwa przed wykonaniem tej procedury zalecamy utworzenie pełnej kopii zapasowej wszystkich węzłów, np. kopii zapasowej na poziomie maszyny wirtualnej lub na poziomie komponentu (lub obu tych kopii). Dzięki temu będziesz mieć plan awaryjny na wypadek, gdyby któryś z tych kroków nie działał prawidłowo. Więcej informacji o tworzeniu kopii zapasowych na poziomie komponentów znajdziesz w artykule Tworzenie kopii zapasowych i przywracanie.

Sprawdź, czy Edge jest uruchomiony.

Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia:

/opt/apigee/apigee-service/bin/apigee-all status

Kolejność wymiany węzłów

Zalecamy uaktualnianie węzłów w kolejności podanej poniżej, w zależności od typu komponentu:

Cassandra
Opiekun zwierząt
Postgres
LDAP
Qpid
Message-Processor
Router
Serwer zarządzający
UI/UE
SSO

Dodatkowe scenariusze

Jeśli podczas przeprowadzania aktualizacji systemu operacyjnego na poszczególnych węzłach w dotychczasowej konfiguracji występuje któryś z tych elementów, wykonaj dodatkowe czynności:

apigee-mtls – jeśli apigee-mtls jest włączony, aktualizacja systemu operacyjnego węzeł po węźle (stopniowa) nie jest obsługiwana w tej konfiguracji. Aby zaktualizować apigee-mtls, postępuj zgodnie z przewodnikiem po uaktualnianiu apigee-mtls.

Cassandra

Podczas zastępowania bazy danych Cassandra najpierw wymień węzły inne niż węzły początkowe, a potem węzły początkowe.

W przypadku bazy danych Cassandra należy wziąć pod uwagę te szczególne przypadki:

Cassandra Native-mTLS – jeśli natywne mTLS jest włączone i wymuszane, usuń wymuszanie na węzłach z włączonym mTLS, ustawiając conf_cassandra_client_encryption_optional=true. Więcej informacji znajdziesz w dokumentacji dotyczącej natywnego mTLS.
Szyfrowanie między węzłami Cassandra jest włączone – zapoznaj się z sekcją Włączanie szyfrowania między węzłami Cassandra, aby upewnić się, że certyfikaty istniejących węzłów Cassandra są uwzględnione w magazynie zaufanych certyfikatów nowo zastąpionego węzła i odwrotnie.

Aby zastąpić węzeł Cassandra:

Utwórz kopię zapasową węzła, robiąc migawki maszyn wirtualnych (jeśli to możliwe) i tworząc kopię zapasową Apigee dla Cassandry na wszystkich węzłach za pomocą tego polecenia:
```
apigee-service apigee-cassandra backup
```
Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz i uruchom plik Edge, aby zainstalować narzędzie apigee-service. Uruchom program rozruchowy używanej wersji Apigee, run bootstrap, aby pobrać apigee-service i zainstalować apigee-setup.
UWAGA: upewnij się, że nowy węzeł nie zawiera żadnego katalogu danych w ścieżce katalogu danych apigee-cassandra.

Wypisz węzły początkowe:

apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Zaktualizuj plik konfiguracji, zmieniając adres IP istniejącego węzła Cassandra i zastępując go adresem IP nowego węzła.
UWAGA: upewnij się, że kolejność zastępowanych adresów IP została zachowana. Na przykład jeśli zastępujesz IP2 adresem IP4.

Istniejące CASS_HOSTS
```
CASS_HOSTS="$IP1 $IP2 $IP3"
```
Ostatnio zaktualizowana lista CASS_HOSTS
```
CASS_HOSTS="$IP1 $IP4 $IP3"
```
Ponownie skonfiguruj istniejące węzły w klastrze, używając zaktualizowanego adresu IP nowego węzła Cassandra (z wyjątkiem węzła, który ma zostać zastąpiony). Skorzystaj z odniesienia do pliku konfiguracji.
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```

Zatrzymaj i wyrejestruj system Cassandra na starym węźle:

Zatrzymaj Cassandrę na węźle, który ma zostać zastąpiony:
```
apigee-service apigee-cassandra stop
```

Podaj identyfikator UUID węzła Cassandra, który ma zostać wycofany (jeśli masz wiele centrów danych, weź to pod uwagę):

apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost

Wyrejestruj typy magazynu danych powiązane z dotychczasowym identyfikatorem UUID Cassandra:

curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"

Usuń serwer.
UWAGA: nie wykonuj tego kroku, jeśli Cassandra i inne komponenty Edge, takie jak serwer zarządzania, znajdują się na tym samym węźle. Może tak być, jeśli konfiguracja korzysta ze standardowej 5-węzłowej konfiguracji Apigee.
```
curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
```

Przygotuj nowy węzeł dla hosta apigee-cassandra. Dodaj ten wiersz do pliku cassandra.properties w sekcji /opt/apigee/customer/application/cassandra.properties (utwórz, jeśli nie istnieje) na nowym węźle Cassandra:
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
Sprawdź, czy w pliku cassandra.properties właściciel i grupa mają wartość apigee:apigee. W razie potrzeby użyj tego polecenia, aby zaktualizować właściciela i grupę:
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```

Zainstaluj Cassandrę i uruchom konfigurację na nowo dodanym węźle:

apigee-service apigee-cassandra install

apigee-service apigee-cassandra setup -f updatedConfigFile

Po skonfigurowaniu nowego węzła usuń dodatkową konfigurację dodaną do /opt/apigee/customer/application/cassandra.properties i ponownie uruchom apigee-cassandra:
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
```
apigee-service apigee-cassandra restart
```

Sprawdź stan nowego węzła zastępczego:

apigee-service apigee-cassandra status

/opt/apigee/apigee-cassandra/bin/nodetool status

Odbuduj nowy węzeł dodany do klastra:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1

Ponownie skonfiguruj istniejące węzły serwerów Router, Message-Processor, Qpid, Postgres i Management, aktualizując adres IP nowego węzła Cassandra w pliku konfiguracyjnym:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
UWAGA: jeśli router i procesor komunikatów znajdują się w tym samym węźle, użyj -p rmp.
Usuń/odinstaluj system Cassandra ze starszego węzła:
```
apigee-service apigee-cassandra uninstall
```
Powtórz te czynności w przypadku innych węzłów Cassandra w klastrze.

Opiekun zwierząt

Aby zastąpić węzły Zookeeper, wykonaj poniższe czynności. Najpierw wymień węzły podrzędne, a potem węzły główne, aby zapewnić utrzymanie kworum przez zespół.

Utwórz kopię zapasową węzła, robiąc migawki maszyn wirtualnych (jeśli to możliwe) i tworząc kopię zapasową Apigee dla Zookeepera na wszystkich węzłach.

Zatrzymaj i odinstaluj Zookeepera na istniejącym węźle:

apigee-service apigee-zookeeper stop

apigee-service apigee-zookeeper uninstall

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Zaktualizuj plik konfiguracyjny, usuwając nieaktualne lub usunięte adresy IP węzłów i zastępując je nowymi adresami IP węzłów dla Zookeepera. Więcej informacji znajdziesz w dokumentacji pliku konfiguracyjnego:
UWAGA: zachowaj kolejność zastępowanych adresów IP. Na przykład jeśli zastępujesz IP2 adresem IP4.

Istniejąca konfiguracja ZK
```
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
    
```
Zaktualizowano konfigurację ZK
```
ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
    
```
Zainstaluj, skonfiguruj i uruchom Zookeepera na nowym węźle, używając zaktualizowanego pliku konfiguracji:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Wprowadź zmiany w istniejącym węźle Zookeeper za pomocą updatedConfigFile:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Zresetuj istniejące węzły serwerów Router, Message-Processor, Qpid, Postgres i Management, aktualizując adres IP nowego węzła Zookeeper w pliku konfiguracyjnym:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
UWAGA: jeśli router i procesor komunikatów znajdują się w tym samym węźle, użyj -p rmp.
Powtórz te czynności dla wszystkich węzłów Zookeeper.

Postgres

W tej sekcji opisujemy podejście do uaktualniania węzłów Postgres bez przestojów, w ramach którego wykonasz opisane kroki. Szczegółowe instrukcje dotyczące wykonywania poszczególnych czynności znajdziesz w podsekcjach poniżej.

Zastąp dowolny istniejący węzeł rezerwowy docelowym systemem operacyjnym.
Promuj nowy węzeł rezerwowy do roli węzła głównego.
Wycofaj stary serwer główny.
Kontynuuj wymianę kolejnych węzłów rezerwowych.

Przed rozpoczęciem wymiany zalecamy zatrzymanie serwera edge-qpid-server, aby zminimalizować potencjalną utratę wiadomości analitycznych.

apigee-service edge-qpid-server stop

Tryb gotowości

Pobierz identyfikator UUID węzłów edge-postgres-server:
```
curl http://pg_standby_ip:8084/v1/servers/self
```

Zatrzymaj Postgres:

apigee-service edge-postgres-server stop

apigee-service apigee-postgresql stop

Usuń istniejący serwer rezerwowy Postgres z grupy analitycznej wykonując te czynności.

Odinstaluj apigee-postgres i postgres-server:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Skonfiguruj replikację master-standby na istniejącym serwerze głównym, aktualizując plik konfiguracji za pomocą wartości EXISTING_PG_MASTER_IP i NEW_PG_STANDBY_IP. Więcej informacji znajdziesz w materiałach referencyjnych dotyczących plików konfiguracji:
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Zainstaluj, skonfiguruj i uruchom Postgres z konfiguracjami master-standby na nowym węźle rezerwowym:

PG_MASTER=EXISTING_PG_MASTER_IP

PG_STANDBY=NEW_PG_STANDBY_IP

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Sprawdź konfigurację trybu gotowości:

apigee-service apigee-postgresql postgres-check-standby

Główna

Uzyskaj identyfikator UUID istniejącego węzła głównego Postgres:
```
curl http://pg_ip:8084/v1/servers/self
```
Promuj nowy uaktualniony węzeł gotowości systemu operacyjnego do roli węzła głównego.

Zatrzymaj Postgres na dotychczasowej instancji głównej:

apigee-service apigee-postgresql stop

apigee-service edge-postgres-server stop

Promuj nowy węzeł rezerwowy do roli węzła głównego:

apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP

Usuń stary węzeł główny z grup analitycznych i konsumenckich.
Dodaj nowy węzeł główny do grup analitycznych i konsumenckich.
Jeśli korzystasz z zarabiania, zaktualizuj nowy węzeł główny Postgres i wykonaj te czynności.
Po wymianie węzła głównego można uruchomić edge-qpid-server z aktualną konfiguracją węzła głównego:
```
apigee-service edge-qpid-server start
```
Jeśli korzystasz z zarabiania, uruchom ponownie serwer zarządzania i procesor komunikatów:
```
apigee-service edge-management-server restart
```

Zatrzymaj i odinstaluj apigee-postgres i postgres-server na starym serwerze głównym:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Dodawanie nowego urządzenia w trybie gotowości

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Skonfiguruj replikację typu master-standby, używając nowego adresu IP węzła głównego i nowego adresu IP węzła rezerwowego w nowym pliku konfiguracji węzła głównego i nowego pliku konfiguracji węzła rezerwowego. Więcej informacji znajdziesz w materiałach referencyjnych dotyczących plików konfiguracji:
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Zainstaluj i skonfiguruj nowy węzeł rezerwowy:

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Dodaj nowy serwer rezerwowy do grup analitycznych, wykonując czynności konfiguracyjne serwera głównego i rezerwowego.
Uwaga: podczas dodawania nowych węzłów rezerwowych do grup analitycznych upewnij się, że istniejący Postgres został najpierw usunięty, a następnie jednocześnie dodany z węzłem rezerwowym.

LDAP

Zastąpienie węzła LDAP wymaga zatrzymania serwera zarządzania, a wszystkie interfejsy Management API będą niedostępne przez czas zastępowania węzła.

Zatrzymaj serwer zarządzania na wszystkich węzłach:
```
apigee-service edge-management-server stop
```
Wyłączanie istniejącego węzła LDAP:
UWAGA: jeśli używasz wersji 4.53.01 lub nowszej, w konfiguracjach LDAP używaj mdb. Jeśli używasz wersji 4.53.00 lub starszej, w konfiguracji LDAP użyj znaku bdb.
1. Utwórz kopię zapasową lub migawkę węzła LDAP na poziomie maszyny wirtualnej.
2. Przed zatrzymaniem LDAP sprawdź liczbę danych LDAP, którą można później zweryfikować, np.:
```
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
```
3. W przypadku konfiguracji aktywnej i pasywnej:
  1. Zmień bieżący węzeł pasywny na aktywny, dodając w nim plik mark_writable.ldif o tej treści:
```
dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
```
  2. Aby uaktywnić węzeł pasywny, wykonaj w nim to polecenie:
```
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
```
  3. W przypadku konfiguracji active-active przejdź do kroku d), aby wycofać węzły.
4. W konfiguracji LDAP typu Active-Active przerwij replikację między 2 węzłami LDAP i zaktualizuj konfiguracje. Wykonaj czynności opisane w dokumencie dotyczącym wycofania LDAP.
5. Zatrzymaj i wykonaj kopię zapasową danych LDAP, a następnie odinstaluj istniejący węzeł LDAP (w przypadku konfiguracji active-active pomiń ten krok, jeśli został już wykonany):
```
apigee-service apigee-openldap stop
```
```
apigee-service apigee-openldap backup
```
```
apigee-service apigee-openldap uninstall
```
Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Skonfiguruj nowy węzeł LDAP:
1. Zaktualizuj configFile dla nowego węzła na podstawie konfiguracji. Możesz skorzystać z dokumentacji pliku konfiguracji Edge, która zawiera informacje o konfiguracji aktywnej lub aktywnej-aktywnej:
  - LDAP_TYPE
  - LDAP_PEER
  - LDAP_SID
  - USE_LDAP_REMOTE_HOST=y/n
    Uwaga: ustaw wartość USE_LDAP_REMOTE_HOST na „y” lub „n” w zależności od tego, czy LDAP jest skonfigurowany na tym samym węźle co serwer zarządzania.
2. Skonfiguruj i uruchom LDAP na nowym węźle za pomocą updatedConfigFile:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
```
3. Utwórz kopię zapasową danych LDAP ze starszych węzłów (jeśli konfigurację aktywna-aktywna można pominąć):
  1. Utwórz przykładową kopię zapasową w nowym węźle, aby wygenerować domyślny folder lub ścieżkę kopii zapasowej:
```
apigee-service apigee-openldap backup
```
  2. Przenieś dane z kopii zapasowej ze starego węzła do wygenerowanego folderu kopii zapasowej.
  3. Zatrzymaj apigee-openldap przed przywróceniem danych:
```
apigee-service apigee-openldap stop
```
  4. Przywróć kopię zapasową utworzoną na starszym węźle:
```
apigee-service apigee-openldap restore backup_file
```
    Na przykład:
```
apigee-service apigee-openldap restore 2026.02.09,10.28.20
```
Powtórz tę czynność w przypadku innych węzłów LDAP (jeśli są aktywne).
Ponownie skonfiguruj i uruchom serwer zarządzania z zaktualizowanymi konfiguracjami hosta LDAP:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```

Ponownie skonfiguruj i uruchom logowanie jednokrotne (w stosownych przypadkach):

apigee-service apigee-sso setup -f updatedConfigFile

apigee-service apigee-sso restart

(Opcjonalnie) Skonfiguruj drugi katalog aktywny jako tylko do odczytu, wykonując czynności opisane w dokumentacji.

Qpid

Aby zastąpić istniejący węzeł Qpid węzłem z zaktualizowanym systemem operacyjnym, musimy wykonać te czynności:

przestać otrzymywać wiadomości do istniejącej kolejki węzła z procesorów wiadomości;
Opróżnij kolejkę z dotychczasowych wiadomości.
Zatrzymaj i wycofaj istniejący węzeł.

Wycofywanie istniejących węzłów. Aby mieć pewność, że żadne wiadomości nie zostaną utracone, podejmij dodatkowe środki:

Zatrzymaj brokera Qpid:
```
apigee-service apigee-qpidd stop
```
Zablokuj ruch przychodzący na porcie 5672 ze wszystkich procesorów wiadomości:
```
iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
```
Ponownie uruchom brokera Qpid, aby opróżnić istniejące wiadomości:
```
apigee-service apigee-qpidd start
```
Zanim zaczniesz wycofywać usługę, upewnij się, że wszystkie wiadomości w kolejce zostały przekazane do odbiorcy.
Pobierz identyfikator UUID węzła edge-qpid-server:
```
curl http://qpid_node_ip:8083/v1/servers/self
```
Wykonaj czynności związane z wycofaniem lub usunięciem Qpid z analityki w przypadku usług apigee-qpidd i edge-qpid-server.

Zatrzymaj i odinstaluj zarówno apigee-qpidd, jak i edge-qpid-server:

apigee-service apigee-qpidd stop

apigee-service edge-qpid-server stop

apigee-service apigee-qpidd uninstall

apigee-service edge-qpid-server uninstall

Dodaj nowy węzeł:

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Skonfiguruj i uruchom usługi Qpid na nowym węźle i dodaj je do grup odbiorców, wykonując te czynności. Aby dodać inne grupy, np. do zarabiania, wykonaj te same czynności.
Jeśli usługa zarabiania jest włączona, uruchom ponownie serwer zarządzania i procesor komunikatów:
```
apigee-service edge-management-server restart
```
```
apigee-service edge-message-processor restart
```
Powtórz te czynności na wszystkich węzłach Qpid.

Procesor wiadomości

Pobierz identyfikator UUID węzła edge-message-processor:
```
curl http://mp_ip:8082/v1/servers/self
```
Wycofaj i odinstaluj węzeł procesora komunikatów.
Jeśli usługa zarabiania jest włączona, odinstaluj edge-mint-message-processor.

Odinstaluj procesor komunikatów:

apigee-service edge-message-processor uninstall

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Dodaj, skonfiguruj i uruchom procesor komunikatów w klastrze, wykonując te czynności.
Jeśli zarabianie jest włączone, skonfiguruj usługę zarabiania wraz z procesorem komunikatów. Więcej informacji znajdziesz w tej dokumentacji.

Router

Pobierz identyfikator UUID węzła edge-router:
```
curl http://router_ip:8081/v1/servers/self
```

Wyłącz osiągalność i sprawdź, czy jest osiągalna:

iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable

Wycofaj z eksploatacji i odinstaluj węzeł routera.
Odinstalowywanie routera:
```
apigee-service edge-router uninstall
```
Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Dodaj, skonfiguruj i uruchom router w klastrze.

Serwer zarządzania

Tylko jeden serwer zarządzania

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Dodaj serwer zarządzający, używając zaktualizowanego adresu IP i pliku konfiguracji, do którego możesz się odwołać tutaj, a następnie uruchom polecenie konfiguracji:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Ponownie skonfiguruj i uruchom interfejs użytkownika z nową konfiguracją adresu IP zarządzania.
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
Ponownie skonfiguruj logowanie jednokrotne z nową konfiguracją adresu IP zarządzania (w stosownych przypadkach):
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
Ponownie skonfiguruj nowy interfejs użytkownika z nową konfiguracją adresu IP zarządzania (w stosownych przypadkach):
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Jeśli zarabianie jest włączone:
1. Ponownie skonfiguruj zarabianie w usłudze MS z nową konfiguracją adresu IP zarządzania (w stosownych przypadkach), korzystając z dokumentacji konfiguracji zarabiania.
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
```
2. Ponownie uruchom serwer zarządzania:
```
apigee-service edge-management-server restart
```
Wycofaj serwer zarządzający na istniejącym/starym węźle, wykonując te czynności.

Jeśli zarabianie jest włączone, usuń identyfikator UUID serwera zarządzania z grup analitycznych. Przykład:

curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"

Odinstaluj serwer zarządzania zarabianiem:

apigee-service edge-mint-management-server uninstall

Wiele serwerów zarządzania

Wyłącz jeden z serwerów zarządzających, korzystając z drugiego na istniejącym węźle. Wykonaj te czynności.

Zatrzymaj i odinstaluj serwer zarządzania:

apigee-service edge-management-server stop

apigee-service edge-management-server uninstall

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Dodaj serwer zarządzający, używając zaktualizowanego adresu IP i pliku konfiguracji, do którego możesz się odwołać tutaj, a następnie uruchom polecenie konfiguracji:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Ponownie skonfiguruj i uruchom interfejs z zaktualizowaną konfiguracją adresu IP zarządzania:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Tylko jeśli logowanie jednokrotne jest włączone) Ponownie skonfiguruj i uruchom logowanie jednokrotne ze zaktualizowaną konfiguracją adresu IP zarządzania:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(Tylko jeśli włączony jest nowy interfejs) Ponownie skonfiguruj i uruchom nowy interfejs ze zaktualizowaną konfiguracją adresu IP zarządzania:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Powtórz te czynności w przypadku innego serwera zarządzającego.

UI/UE

Utwórz kopię zapasową lub zrzut maszyny wirtualnej węzła interfejsu.

Zatrzymywanie i odinstalowywanie interfejsu:

apigee-service edge-ui stop

apigee-service edge-ui uninstall

(Tylko w przypadku korzystania z nowego interfejsu) Zatrzymaj i odinstaluj nowy interfejs:
```
apigee-service edge-management-ui stop
```
```
apigee-service edge-management-ui uninstall
```
Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Skonfiguruj i uruchom edge-ui na nowym węźle ze zaktualizowanymi konfiguracjami IP:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Tylko jeśli logowanie jednokrotne jest włączone) Ponownie skonfiguruj i uruchom logowanie jednokrotne z nowymi adresami IP węzłów interfejsu konfiguracji:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```

(Tylko jeśli włączony jest nowy interfejs) Skonfiguruj i uruchom nowy interfejs na nowym węźle ze zaktualizowanymi konfiguracjami IP:

/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

Utwórz kopię zapasową lub zrzut maszyny wirtualnej węzła interfejsu.

Zatrzymaj i odinstaluj logowanie jednokrotne:

apigee-service apigee-sso stop

apigee-service apigee-sso uninstall

Uzyskaj nowy węzeł z zaktualizowanym systemem operacyjnym.
Spełnij wymagania wstępne dotyczące systemu operacyjnego.
Pobierz program bootstrap wersji Apigee, której używasz, uruchom go, aby uzyskać apigee-service, i zainstaluj apigee-setup.
Dodaj konfiguracje i klucze logowania jednokrotnego zgodnie z przewodnikiem, uwzględniając nowy adres IP węzła.

Skonfiguruj i uruchom logowanie jednokrotne:

/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

Zaktualizuj konfigurację o nowe adresy IP węzła logowania jednokrotnego i ponownie skonfiguruj logowanie jednokrotne w interfejsie:
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```

(Jeśli używasz nowego interfejsu) Uruchom polecenie configure-sso na węźle nowego interfejsu, korzystając z dokumentacji:

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile