Roll back Apigee Edge 4.19.06

Jika Anda mengalami kesalahan selama pembaruan Edge 4.19.06, Anda dapat melakukan roll back yang menyebabkan {i>error<i} dan kemudian mencoba pembaruannya 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 mungkin perlu Anda lakukan untuk 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 dengan cara sama rilis. Misalnya, dari 4.19.01.02 hingga 4.19.01.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 berjalan sebagai {i>root<i}.

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 menggunakan 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 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 lempar kembali:

    • Untuk melakukan roll back ke 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 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 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 Anda harus menghentikan semuanya, seperti 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 roll back Monetisasi, uninstal dari semua Server dan Pesan Pengelolaan Node pemroses: 
    /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 komponen edge-gateway , seperti yang ditampilkan 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 roll back Router Edge, Anda harus menghapus konten /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 apigee-service versi 4.19.01, 4.18.05, atau 4.18.01 utilitas dan dependensinya. Contoh berikut menginstal versi 4.18.01 apigee-service: 
    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 terjadi error, pastikan Anda mendownload file bootstrap.sh di langkah Akun Layanan 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 versi update sebelumnya

Untuk melakukan roll back komponen ke versi rilis 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 sebagai komponen dan update versi 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 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.