Roll back Apigee Edge 4.19.06

Jika mengalami error selama update ke Edge 4.19.06, Anda dapat me-roll back komponen yang menyebabkan error, lalu mencoba update lagi.

Anda dapat melakukan roll back Edge 4.19.06 ke versi Rilis Fitur berikut:

  • Versi 4.19.01
  • Versi 4.18.05
  • Versi 4.18.01

Ada dua skenario yang memungkinkan Anda melakukan rollback:

  1. Melakukan roll back ke Rilis Fitur sebelumnya. Misalnya dari 4.19.06 hingga 4.18.05.
  2. Roll back ke versi update sebelumnya dalam rilis yang sama. Misalnya, dari 4.19.01.02 hingga 4.19.01.01.

Untuk mengetahui informasi selengkapnya, lihat proses rilis Apigee Edge.

Siapa yang dapat melakukan rollback

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

Secara default, komponen Edge dijalankan sebagai pengguna "apigee". Dalam beberapa kasus, Anda mungkin menjalankan komponen Edge sebagai pengguna yang berbeda. Misalnya, jika Router harus mengakses port dengan hak istimewa, seperti port di bawah 1.000, maka Anda harus menjalankan Router sebagai root atau sebagai pengguna yang memiliki akses ke port tersebut. Atau, Anda dapat menjalankan satu komponen sebagai satu pengguna, dan komponen lainnya 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 pada node, Anda harus me-roll back semua komponen yang ada di 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 memiliki Server Pengelolaan, Router, dan Pemroses Pesan yang diinstal di node, untuk melakukan roll back salah satunya, Anda harus me-roll back ketiganya.

Melakukan roll back ke Rilis Fitur sebelumnya

Untuk melakukan roll back ke Rilis Fitur sebelumnya, lakukan hal berikut pada setiap node yang menghosting komponen:

  1. Download file bootstrap.sh untuk versi yang ingin Anda roll back:

    • Untuk melakukan roll back ke versi 4.19.01, download bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • Untuk melakukan roll back ke versi 4.18.05, download bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    • Untuk melakukan roll back ke versi 4.18.01, download bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Hentikan komponen untuk melakukan roll back:
    1. Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus menghentikan semuanya, seperti yang ditunjukkan 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 melakukan roll back komponen lain pada node, hentikan hanya komponen tersebut: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jika Anda melakukan roll back Monetisasi, uninstal dari semua node Server Pengelolaan dan Pemroses Pesan: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Uninstal komponen untuk melakukan roll back pada node:
    1. Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen edge-gateway, seperti yang ditunjukkan contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Untuk me-roll back komponen lain pada node, hanya uninstal komponen tersebut, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dengan component adalah nama komponen.

    3. Untuk me-roll back Router Edge, 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.19.06: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Instal utilitas apigee-service versi 4.19.01, 4.18.05, atau 4.18.01 beserta dependensinya. Contoh berikut menginstal apigee-service versi 4.18.01: 
    sudo bash /tmp/bootstrap_4.18.01.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 menerima pesan error, pastikan Anda telah mendownload file bootstrap.sh pada 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 file konfigurasi untuk versi yang lebih lama.

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

Melakukan roll back ke versi update sebelumnya

Untuk me-roll back komponen ke versi rilis tertentu, lakukan hal berikut pada setiap node yang menghosting komponen tersebut:

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

    Dengan component_version adalah komponen dan versi update yang akan diinstal. Contoh: 

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-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 menetapkan nama komponen saat menginstalnya, bukan versinya.

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