Melakukan roll back Apigee Edge 4.52.01

Jika Anda mengalami kesalahan selama pembaruan Edge 4.52.01, Anda dapat melakukan roll back yang menyebabkan {i>error<i} dan kemudian mencoba pembaruannya lagi.

Anda dapat melakukan roll back Edge 4.52.01 ke versi rilis utama berikut:

  • Versi 4.52.00
  • Versi 4.51.00

Ada dua skenario yang mungkin perlu Anda lakukan untuk melakukan rollback:

  1. Melakukan roll back ke rilis besar atau kecil sebelumnya. Misalnya dari 4.52.01 ke 4.52.00.
  2. Roll back ke rilis patch sebelumnya dengan cara rilis. Misalnya, dari 4.52.00.02 ke 4.52.00.01.

Untuk informasi selengkapnya, lihat rilis Apigee Edge {i>checkout<i}.

Siapa yang dapat melakukan rollback

Pengguna yang melakukan rollback harus sama dengan pengguna yang awalnya mengupdate Edge, atau pengguna yang berjalan sebagai root.

Secara default, komponen Edge dijalankan sebagai "apigee" pengguna. Dalam beberapa kasus, Anda mungkin menjalankan Edge komponen sebagai pengguna yang berbeda. Misalnya, jika {i>Router<i} harus mengakses porta dengan hak istimewa, seperti di bawah 1000, maka Anda harus menjalankan {i>Router<i} sebagai {i>root<i} atau sebagai pengguna yang memiliki akses ke porta. Atau, Anda dapat menjalankan satu komponen sebagai satu pengguna, dan komponen lain sebagai pengguna lain.

Komponen dengan kode umum

Komponen Edge berikut memiliki kode yang sama. Oleh karena itu, untuk melakukan roll back salah satu komponen ini di node, Anda harus melakukan roll back semua komponen yang ada pada node tersebut.

  • edge-management-server (Server Pengelolaan)
  • edge-message-processor (Pemroses Pesan)
  • edge-router (Router)
  • edge-postgres-server (Server Postgres)
  • edge-qpid-server (Server Qpid)

Misalnya, jika Anda menginstal Server Pengelolaan, Router, dan Pemroses Pesan di node, untuk melakukan rollback salah satunya, Anda harus me-roll back ketiganya.

Roll back ke rilis besar atau kecil sebelumnya

Untuk melakukan roll back ke rilis utama atau minor sebelumnya, lakukan hal berikut di setiap node yang menghosting komponen:

  1. Download file bootstrap.sh untuk versi yang ingin Anda lempar kembali:

    • Untuk melakukan rollback ke 4.51.00, download bootstrap_4.51.00.sh:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
  2. Hentikan komponen untuk melakukan roll back:
    1. Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus menghentikan semuanya, seperti yang ditunjukkan pada contoh berikut:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Untuk me-roll back komponen lainnya pada node, hentikan komponen tersebut saja:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jika Anda melakukan rollback Monetisasi, uninstal dari semua node Server Pengelolaan dan Message Processor:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Uninstal komponen untuk melakukan rollback di node:
    1. Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus meng-uninstal semuanya dengan meng-uninstal komponen edge-gateway , seperti yang ditunjukkan contoh berikut:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Untuk melakukan roll back komponen lain pada {i>node<i}, copot instalasi komponen itu saja, karena contoh berikut menunjukkan:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dengan component adalah nama komponennya.

    3. Untuk melakukan rollback Edge Router, Anda harus menghapus konten file /opt/nginx/conf.d selain meng-uninstal grup komponen edge-gateway:
      cd /opt/nginx/conf.d
      rm -rf *
  5. Uninstal apigee-setup versi 4.52.01:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Instal apigee-service versi 4.51.00 utilitas dan dependensinya. Contoh berikut menginstal apigee-service versi 4.51.00:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.

    Jika Anda mendapatkan error, pastikan Anda mendownload file bootstrap.sh di langkah 1.

  7. Instal apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Instal komponen versi lama:
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Dengan component adalah komponen yang akan diinstal dan configFile adalah komponen file konfigurasi untuk versi lama.

  9. Jika Anda melakukan roll back Qpid, flush iptables:
    sudo iptables -F
  10. Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda roll back.

Roll back ke rilis patch sebelumnya

Untuk melakukan roll back komponen ke rilis patch tertentu, lakukan hal berikut pada setiap node yang menghosting komponen:

  1. Mendownload versi komponen tertentu:
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Dengan component_version adalah rilis komponen dan patch yang akan diinstal. Contoh:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

    Jika menggunakan repo online Apigee, Anda dapat menentukan versi komponen yang tersedia menggunakan perintah berikut:

    yum --showduplicates list comp

    Contoh:

    yum --showduplicates list edge-ui
  2. Gunakan apigee-setup untuk menginstal komponen:
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Contoh:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Perhatikan bahwa Anda hanya menentukan nama komponen saat menginstalnya, bukan versinya.

  3. Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda roll back.

Roll back update Postgres 10.17

Jika Anda mengupgrade ke 4.52.01 dari versi 4.50.00 atau 4.51.00, Anda harus melakukan rollback update Postgres selain komponen Edge.

Untuk melakukan rollback update Postgres saat memperbarui Postgres dalam konfigurasi standby master:

  • Promosikan node standby baru untuk menjadi master Postgres. Master Postgres baru akan versi yang sama dengan penginstalan Edge Anda sebelumnya.
  • Konfigurasikan node standby lama menjadi node standby dari master baru. Node standby lama akan sama dengan versi penginstalan Edge Anda sebelumnya.
  • Daftarkan node master dan standby baru ke grup analisis dan konsumen.

Setelah Anda selesai melakukan rollback, node master lama tidak akan diperlukan lagi. Anda dapat {i>node <i}master lama akan dinonaktifkan.

  1. Pastikan node Postgres standby baru berjalan:
    /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres tidak berjalan, mulai:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Pastikan Postgres dihentikan pada node master lama dan node standby lama:
    /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres berjalan, hentikan:

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

  3. Jika diinstal, mulai Qpid di node standby lama:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. Promosikan node standby baru sebagai master Postgres:
    1. Promosikan node standby baru menjadi master baru:
      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      Jika diminta, masukkan sandi Postgres untuk 'apigee' , yang secara default "postgres".

    2. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan hal berikut:
      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP
    3. Konfigurasi master baru:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Jika Anda telah mengupgrade node standby lama ke versi yang lebih baru, Anda harus terlebih dahulu mendowngrade software Apigee pada node standby lama. Jika Anda masih memiliki versi yang lebih lama di standby, Anda dapat melewati langkah ini dan melanjutkan ke langkah 6.
    1. Hentikan Postgres di node standby lama:
      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop
    2. Uninstal Postgres dari node standby lama:
      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall
    3. Hapus direktori data Postgres dari node standby lama:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. Download dan jalankan bootstrap versi lama (untuk versi Apigee yang Anda jalankan ke) pada node standby lama. Langkah-langkah yang tepat dapat bervariasi berdasarkan apakah Anda sedang menggunakan instalasi berbasis internet atau {i>offline<i}. Menjalankan versi lama Apigee bootstrap akan siapkan repositori yum dengan data Apigee versi lama.
    5. Siapkan komponen Postgres di node standby lama:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Memeriksa dan memverifikasi bahwa komponen Postgres pada node standby lama telah di-roll back ke versi lama:
      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version
  6. Buat ulang node standby lama:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan hal berikut:
      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP
    2. Hapus direktori data di node standby lama:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    3. Konfigurasi ulang node standby lama menjadi node standby master baru:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. Pastikan Postgres berjalan di node standby lama:
      /opt/apigee/apigee-service/bin/apigee-all status

      Jika Postgres tidak berjalan, mulai:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. Pastikan bahwa node standby baru telah ditambahkan dengan menampilkan /opt/apigee/apigee-postgresql/conf/pg_hba.conf file di master baru.
  8. Lihat informasi grup konsumen dan analisis saat ini dengan menjalankan perintah berikut di Server Pengelolaan:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Perintah ini menampilkan nama grup analisis di kolom name, dan nama grup konsumen di kolom name pada bagian consumer-groups. Anda juga akan menampilkan UUID master Postgres dan node standby lama di Kolom postgres-server, dan di kolom datastores. Anda akan melihat output dalam bentuk:

    {
      "name" : "axgroup-001",
      "properties" : {
      },
      "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
      "uuids" : {
        "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
        "postgres-server" : [
          "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
        ]
      },
      "consumer-groups" : [ {
        "name" : "consumer-group-001",
        "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
        "datastores" :
          [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
          "properties" : {     }
        }
      ],
      "data-processors" : {
      }
    }

  9. Dapatkan alamat UUID master lama dengan menjalankan perintah curl berikut di node master lama:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Anda akan melihat UUID node di akhir output, dalam bentuk:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. Ulangi langkah sebelumnya untuk mendapatkan alamat IP node standby lama dan master baru.
  11. Hapus node master dan standby lama dari grup konsumen:
    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    Dengan axgroup-001 dan consumer-group-001 adalah nama default dari analitik dan kelompok konsumen. masterUUID,standbyUUID berada dalam urutan yang sama seperti yang muncul di atas saat Anda melihat informasi analisis dan grup konsumen saat ini di atas. Anda mungkin harus menentukannya sebagai standbyUUID,masterUUID.

    Properti datastores untuk consumer-groups sekarang seharusnya menjadi kosong.

  12. Hapus node master dan standby lama dari grup analisis:
    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    Properti postgres-server dalam uuids sekarang harus kosong.

  13. Daftarkan node standby dan master PG baru dengan grup konsumen dan analisis:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. Validasi grup analisis:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Anda akan melihat UUID node master dan standby baru tercantum dalam grup analisis dan kelompok konsumen.

  15. Mulai ulang Server Pengelolaan Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. Mulai ulang semua server Qpid:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. Mulai ulang semua server Postgres:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:

    Di master baru, jalankan:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Verifikasi bahwa instance tersebut adalah master. Di node standby lama:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Pastikan perangkat dalam mode standby.

  19. Ulangi langkah sebelumnya setelah membuat beberapa permintaan API untuk memastikan bahwa node berada dalam sinkronisasi.
  20. Nonaktifkan master Postgres lama menggunakan prosedur dalam Menonaktifkan node Postgres.

    Atau, Anda dapat meng-uninstal Qpid dari master lama dan instal Qpid di node master baru. Setelah meng-uninstal Qpid, Anda dapat menonaktifkan node master lama.

Roll back mTLS

Untuk me-roll back update mTLS, lakukan langkah-langkah berikut pada semua host:

  1. Hentikan Apigee:
    apigee-all stop
  2. Hentikan mTLS:
    apigee-service apigee-mtls uninstall
  3. Instal ulang mTLS:
    apigee-service apigee-mtls install
    apigee-service apigee-mtls setup -f /opt/silent.conf