Przenoszenie serwerów Apigee

Edge for Private Cloud w wersji 4.18.05

Komponenty Apigee komunikują się ze sobą za pomocą adresów IP. Przenoszenie komponentów z jednego może spowodować niezgodność konfiguracji. Aby naprawić niezgodności konfiguracji, postępuj zgodnie z odpowiednie instrukcje znajdziesz poniżej.

Zmienianie adresu IP węzła Cassandra

Aby zmienić adres IP węzła Cassandra, wykonaj te czynności:

Dla: konfiguracje z jednym węzłem Cassandra

  1. Edytuj /opt/apigee/customer/application/cassandra.properties w modyfikowanym systemie. Jeśli plik nie istnieje, utwórz go.
  2. Zmień te parametry:
    • Ustaw conf_cassandra_seeds i conf_cassandra_listen_address podając nowy adres IP systemu.
    • Zmień conf_cassandra_rpc_address, którego chcesz używać nowego adresu IP lub adresu 0.0.0.0 (co umożliwia Cassandra Thrift nasłuchiwanie ).
  3. Otwórz aplikację /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties w edytorze. Stary adres IP i ustawienie domyślne powinny być widoczne w następującym formacie: 
    192.168.56.101=dc-1:ra-1
default=dc-1:ra-1

    Zapisz te informacje.

  4. Edytuj /opt/apigee/customer/application/cassandra.properties aby zmienić stary adres IP na nowy: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Pamiętaj, aby wstawić „\n” po adresie IP i określić te same ustawienia domyślne, znalezionym powyżej w kroku 3.

  5. Uruchom ponownie Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. W razie potrzeby możesz też naprawić ZooKeeper (patrz poniżej), a w przeciwnym razie ponownie uruchomić każdą platformę Apigee. komponentem rozpoczynający się od serwera zarządzania.

Dla: konfiguracje z wieloma węzłami (pierścieniem) Cassandra

  1. Jeśli zmieniany węzeł jest węzłem początkowym, edytuj /opt/apigee/customer/application/cassandra.properties w każdym systemie w pierścieniu, a potem zmień parametr conf_cassandra_seeds, tak by uwzględniał nowego adresu IP zmodyfikowanego systemu. Jeśli plik cassandra.properties nie istnieje, utwórz .
  2. Edytuj /opt/apigee/customer/application/cassandra.properties w zmodyfikowanym systemie i zmień następujące parametry:
    • Ustaw conf_cassandra_listen_address tak, aby używał nowego adresu IP.
    • Ustaw conf_cassandra_rpc_address tak, aby używał nowego adresu IP lub adresu „0.0.0.0” (dzięki czemu Cassandra Thrift może nasłuchiwać przez wszystkie interfejsy).
  3. Otwórz aplikację /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties w edytorze. Powinny być widoczne wszystkie adresy IP Cassandra oraz domyślne ustawienia w formularz: 
    192.168.56.101=dc-1:ra-1
192.168.56.102=dc-1:ra-1
192.168.56.103=dc-1:ra-1
default=dc-1:ra-1

    Zapisz te informacje.

  4. Edytuj /opt/apigee/customer/application/cassandra.properties aby zmienić stary adres IP na nowy: 
    conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Pamiętaj, aby wstawić „\n” po każdym adresie IP i użyć tych samych ustawień domyślnych zanotowaliśmy powyżej w kroku 3.

  5. Uruchom ponownie Cassandra w zmodyfikowanym systemie. Jeśli zmodyfikowany system jest węzłem początkowym, Uruchom ponownie każdy system, który używał zmodyfikowanego węzła wyjściowego. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Uruchom: nodetool ring na zmodyfikowanym węźle, aby upewnić się, że pierścień jest zakończony. Narzędzie to jest dostępne pod adresem /opt/apigee/apigee-cassandra/bin 
    nodetool -h localhost ring
  7. Uruchom nodetool repair w zmodyfikowany węzeł. Pamiętaj, że ten proces może zająć trochę czasu, dlatego zdecydowanie zalecamy ten proces. Należy pamiętać, że nie należy tego robić w godzinach największego ruchu interfejsów API. 
    nodetool -h localhost repair
  8. W razie potrzeby napraw aplikację ZooKeeper (patrz poniżej), a następnie ponownie uruchom każdy komponent platformy Apigee. zaczynając od serwera zarządzania.

Zaktualizowanie magazynu danych Rejestracje

  1. Znajdź identyfikatory UUID rejestracji w magazynie danych zawierające stary adres IP, korzystając z metody poniżej. Zanotuj „typ”, i „UUID” parametry: 
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'
       
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'
       
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

      Gdzie DC to nazwa centrum danych. W ramach jednej instalacji centrum danych to zwykle „dc-1”.

  2. Zarejestruj nowe adresy IP, używając jednego z poniższych poleceń. Potrzebne polecenie będzie zależą od typu zmienionego węzła.
    • W przypadku type="application-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP&region=REGION&pod=central" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
    • W przypadku typu="kms-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore \
  &InternalIP=NEWIP&region=REGION&pod=GATEWAY_POD" -H 'content-type: \
  application/x-www-form-urlencoded' -X POST
    • W przypadku typu="reportcrud-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \
  "Type=reportcrud-datastore&InternalIP=NEW_IP&region=REGION&pod=analytics" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
  3. Usuń stare rejestracje identyfikatora UUID systemu, w którym znajdował się adres IP została zmieniona. W przypadku każdego z tych problemów z identyfikatorami UUID: 
    curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

Zmiana adresu IP węzła ZooKeeper

Aby zmienić adres IP węzła ZooKeeper, wykonaj te czynności:

Zmień adres IP i ponownie uruchom zbiór ZooKeeper (w przypadku konfiguracji z wieloma węzłami tylko)

  1. Otwórz plik /opt/apigee/apigee-zookeeper/conf/zoo.cfg w edytorze. Zobaczysz, że wszystkie adresy IP ZooKeeper i domyślne ustawienia w postaci: 
    server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888

    Zapisz te informacje.

  2. W każdym węźle ZooKeeper edytuj plik /opt/apigee/customer/application/zookeeper.properties. aby ustawić we właściwości conf_zoo_quorum prawidłowe adresy IP. Jeśli plik nie istnieje, należy go utworzyć. 
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n

    Pamiętaj, aby wstawić „\n” po każdym adresie IP i że wpisy są w tej samej kolejności każdego węzła.

  3. Znajdź lidera zespołu ZooKeeper, używając następującego polecenia (zastąp node za pomocą adresu IP komputera Zookeeper): 
    echo srvr | nc node 2181

    Wiersz trybu w danych wyjściowych powinien zawierać tekst „leader”.

  4. Uruchamiaj ponownie jeden ZooKeeper po drugim, zaczynając od lidera, a kończąc na węźle. którego adres IP został zmieniony. Jeśli więcej niż jeden węzeł zookeeper zmienił adresy IP, może to spowodować może być konieczne ponowne uruchomienie wszystkich węzłów. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Aby zweryfikować każdy węzeł ZooKeeper, użyj opisanego powyżej polecenia echo.

Poinformuj węzły Apigee o zmienionej konfiguracji

  1. W każdym węźle routera edytuj plik /opt/apigee/customer/application/router.properties. w następujący sposób. Jeśli plik nie istnieje, utwórz go.
    • Zmień parametr conf_zookeeper_connection.string, aby uwzględnić nowy adres IP adres
    • Zmień parametr conf_zookeeper_zk1.host, aby uwzględnić nowy adres IP adres
  2. W każdym węźle procesora wiadomości edytuj plik /opt/apigee/customer/application/message-processor.properties. w następujący sposób. Jeśli plik nie istnieje, utwórz go.
    • Zmień parametr conf_zookeeper_connection.string, aby uwzględnić nowy Adres IP
    • Zmień parametr conf_zookeeper_zk1.host, aby uwzględnić nowy adres IP adres
  3. W węźle serwera zarządzania edytuj plik /opt/apigee/customer/application/management-server.properties. w następujący sposób. Jeśli plik nie istnieje, utwórz go.
    • Zmień parametr conf_zookeeper_connection.string, aby uwzględnić nowy Adres IP
    • Zmień parametr conf_zookeeper_zk1.host, aby uwzględnić nowy adres IP adres
  4. Ponownie uruchom cały komponent platformy Apigee, uruchamiając w każdym węźle to polecenie: 
    /opt/apigee/apigee-service/bin/apigee-all restart

Zmiana adresu IP serwera LDAP (OpenLDAP)

Aby zmienić adres IP węzła OpenLDAP, wykonaj te czynności:

  1. W węźle serwera zarządzania edytuj plik /opt/apigee/customer/application/management-server.properties. . Jeśli plik nie istnieje, utwórz go.
  2. W pliku management-server.properties ustaw conf_security_ldap.server.host na nowy adres IP.
  3. Ponownie uruchom serwer zarządzania: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Zmienianie adresu IP innego węzła Apigee Typy

Aby zmienić adres IP dowolnego z tych typów węzłów (router, procesor wiadomości, Postgres: Server (nie postgresql) i Qpid Server (nie qpidd):

  1. Aby zarejestrować nowy wewnętrzny i zewnętrzny adres IP, użyj tego polecenia curl: 
    curl -u ADMINEMAIL:PW -X PUT \
  http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
curl -u ADMINEMAIL:PW -X PUT \
  http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

    Gdzie uuid to identyfikator UUID węzła.

Jeśli nie znasz identyfikatora UUID węzła, możesz go wyświetlić za pomocą następującego polecenia:

  • Router: 
    curl http://router_IP:8081/v1/servers/self
  • Procesor wiadomości: 
    curl http://mp_IP:8082/v1/servers/self
  • Qpid: 
    curl http://qp_IP:8083/v1/servers/self
  • Postgres 
    curl http://pg_IP:8084/v1/servers/self