Przenoszenie serwerów Apigee

Edge for Private Cloud w wersji 4.18.01

Komponenty Apigee komunikują się ze sobą za pomocą adresów IP. Przeniesienie komponentów z jednego komputera do drugiej może spowodować niezgodność konfiguracji. Aby poprawić niezgodności konfiguracji, postępuj zgodnie z odpowiednimi instrukcjami poniżej.

Zmiana adresu IP węzła Cassandra

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

Na potrzeby konfiguracji z jednym węzłem Cassandra

  1. Edytuj plik /opt/apigee/customer/application/cassandra.properties w zmodyfikowanym systemie. Jeśli plik nie istnieje, utwórz go.
  2. Zmień te parametry:
    • Ustaw parametry conf_cassandra_seeds i conf_cassandra_listen_address, aby określić nowy adres IP systemu.
    • Zmień conf_cassandra_rpc_address, aby używać nowego adresu IP lub 0.0.0.0 (co umożliwia Cassandra Thrift nasłuchiwanie we wszystkich interfejsach).
  3. Otwórz w edytorze plik /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties. Stary adres IP i ustawienia domyślne powinny mieć postać:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

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

    Upewnij się, że po tym samym adresie IP wstaw „\n” i po tym samym adresie wpisz „\n”
  5. Uruchom ponownie Cassandra:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Jeśli to konieczne, napraw również ZooKeeper (patrz poniżej). W przeciwnym razie uruchom ponownie każdy komponent platformy Apigee, zaczynając od serwera zarządzania.

Na potrzeby konfiguracji z wieloma węzłami Cassandra (pierścień)

  1. Jeśli zmieniany węzeł jest węzłem wyjściowym, edytuj plik /opt/apigee/customer/application/cassandra.properties w każdym systemie w pierścieniu i zmień parametr conf_cassandra_seeds, aby uwzględnić nowy adres IP zmodyfikowanego systemu. Jeśli plik cassandra.properties nie istnieje, utwórz go.
  2. Edytuj plik /opt/apigee/customer/application/cassandra.properties w zmodyfikowanym systemie i zmień te parametry:
    • W parametrze conf_cassandra_listen_address należy użyć nowego adresu IP.
    • Ustaw adres conf_cassandra_rpc_address, aby używać nowego adresu IP lub 0.0.0.0 (co umożliwia Cassandra Thrift nasłuchiwanie we wszystkich interfejsach).
  3. Otwórz w edytorze plik /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties. Wszystkie adresy IP i ustawienia domyślne Cassandra powinny mieć format:
    192.168.56.101=dc-1:ra-1
    192.168.56.102=dc-1:ra-1
    192.168.56.103=dc-1:ra-1:
    informacja, która ma być zapisywana.

  4. Edytuj adres /opt/apigee/customer/application/cassandra.properties, aby zmienić stary adres IP podany na nowy adres IP:
    /opt/apigee/customer/application/cassandra.properties

  5. Uruchom ponownie Cassandra w zmodyfikowanym systemie. Jeśli zmodyfikowany system jest węzłem wyjściowym, uruchom też 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 polecenie nodetool ring w zmodyfikowanym węźle, aby mieć pewność, że pierścień jest kompletny. To narzędzie znajdziesz na stronie opt/apigee/apigee-cassandra/bin.
    > nodetool -h localhost ring
  7. Uruchom naprawę narzędzia węzła w zmodyfikowanym węźle. Pamiętaj, że ten proces może zająć trochę czasu, dlatego zdecydowanie zalecamy, aby nie wykonywać go w godzinach szczytu ruchu przez interfejsy API.
    > nodetool -h localhost napraw
  8. W razie potrzeby napraw ZooKeeper (patrz poniżej), a następnie uruchom ponownie każdy komponent platformy Apigee, zaczynając od serwera zarządzania

Zaktualizuj rejestracje w magazynie danych

  1. Znajdź identyfikatory UUID rejestracji magazynu danych określające stary adres IP za pomocą poniższych poleceń. Zwróć uwagę na parametry „type” i „UUID”:
    • 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 '(typ|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 przypadku pojedynczej instalacji centrum danych wartość to zwykle „dc-1”.
  2. Zarejestruj nowe adresy IP za pomocą jednego z poniższych poleceń. Wymagane polecenie zależy od typu zmienionego węzła.

    Uwaga: poniższy parametr REGION odnosi się do centrum danych, w którym znajduje się klaster. Na przykład w przypadku wysokiej dostępności zwykle klaster jest w dc-1 (Centrum danych 1) i klaster w dc-2 (Centrum danych 2). Ten parametr jest definiowany podczas instalacji. Wartością domyślną jest dc-1.
    • 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: X-encoded-www-form url'
    • W przypadku type="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 &region:{Internal/POD${NEWIP}&region=${Internal-datastore&Type=}”-datastore &region=${project=${NEWIP}&region=$
    • W przypadku type="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: X application/x'www-form-url
  3. Usuń stare rejestracje identyfikatora UUID systemu, w którym został zmieniony adres IP. W przypadku każdego z tych problemów z identyfikatorem 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:

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

  1. Otwórz w edytorze plik /opt/apigee/apigee-zookeeper/conf/zoo.cfg. Wszystkie adresy IP ZooKeeper i ustawienia domyślne powinny mieć format:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168.58.10
    server.2=192.168.56.102:2888:3888
    server.3=192.168.58.10
  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, utwórz go.
    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: 388\n i każdy adres IP wstawiany w ten sam sposób:

  3. Znajdź lidera zespołu ZooKeeper, używając tego polecenia (zastąp ciąg <node> adresem IP maszyny Zookeeper):
    echo srvr | nc <node> 2181

    Wiersz Mode w danych wyjściowych powinien zawierać słowo „leader”.
  4. Uruchom ponownie jeden ZooKeeper po drugim, zaczynając od repliki wiodącej i kończąc węzłem, w którym został zmieniony adres IP. Jeśli więcej niż 1 węzeł zookeeper zmienił adresy IP, może być konieczne ponowne uruchomienie wszystkich węzłów.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Aby sprawdzić 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 zmodyfikuj plik /opt/apigee/customer/application/router.properties. 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 zawierał nowy adres IP
  2. W każdym węźle procesora wiadomości zmodyfikuj 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, by zawierał nowy adres IP
  3. W węźle serwera zarządzania zmodyfikuj plik /opt/apigee/customer/application/management-server.properties. 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, by zawierał nowy adres IP
  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 parametr conf_security_ldap.server.host powinien być ustawiony na nowy adres IP.
  3. Ponownie uruchom serwer zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart

Zmiana adresu IP innych typów węzłów Apigee

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

  1. Aby zarejestrować nowy wewnętrzny i zewnętrzny adres IP, użyj tego polecenia cURL:
    curl -u $ADMINEMAIL:$PW -X PUT


    uuid

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

  • Router: curl http://<adres_IP_routera>: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