Halaman ini diterjemahkan oleh Cloud Translation API.

Roll back Apigee Edge 4.51.00

Jika mengalami error selama update ke Edge 4.51.00, Anda dapat melakukan rollback komponen yang menyebabkan error, lalu mencoba update lagi.

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

Versi 4.50.00
Versi 4.19.06

Ada dua skenario saat Anda mungkin ingin melakukan rollback:

Melakukan roll back ke Rilis Fitur sebelumnya. Misalnya dari 4.51.00 hingga 4.50.00.
Melakukan roll back ke versi update sebelumnya dalam rilis yang sama. Misalnya, dari 4.50.00.02 ke 4.50.00.01.

Untuk 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 berjalan sebagai root.

Secara default, komponen Edge berjalan 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, Anda harus menjalankan Router sebagai root atau sebagai pengguna dengan akses ke port tersebut. 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 rollback salah satu komponen ini di node, Anda harus melakukan rollback semua komponen ini yang ada di node tersebut.

edge-management-server (Server Pengelolaan)
edge-message-processor (Message Processor)
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 melakukan rollback ketiganya.

Melakukan roll back ke Rilis Fitur sebelumnya

Untuk melakukan rollback ke Rilis Fitur sebelumnya, lakukan hal berikut di setiap node yang menghosting komponen:

Download file bootstrap.sh untuk versi yang ingin Anda rollback:
- Untuk melakukan rollback ke 4.50.00, download bootstrap_4.50.00.sh:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh 
```
- Untuk melakukan rollback ke 4.19.06, download bootstrap_4.19.06.sh:
```
curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
```

Hentikan komponen untuk melakukan rollback:

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

Untuk mengembalikan komponen lain di node, hentikan komponen tersebut saja:
- ```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

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
```
Uninstal komponen untuk melakukan rollback di node:
1. Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen edge-gateway, seperti yang ditunjukkan pada contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
2. Untuk melakukan rollback komponen lain di node, cukup 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 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 *
```

Uninstal apigee-setup versi 4.51.00:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

Instal utilitas apigee-service versi 4.19.06 atau 4.50.00 dan dependensinya. Contoh berikut menginstal apigee-service versi 4.50.00:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

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

Instal apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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 Anda untuk versi lama.
Jika Anda melakukan rollback Qpid, hapus iptables:
```
sudo iptables -F
```
Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.

Melakukan roll back ke versi update sebelumnya

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

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.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
```
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.
Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.

Melakukan rollback update Postgres 10.17

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

Untuk melakukan rollback update Postgres saat mengupdate Postgres dalam konfigurasi master-standby:

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

Setelah Anda selesai melakukan rollback, node master lama tidak akan diperlukan lagi. Kemudian, Anda dapat menghentikan node master lama.

Pastikan node Postgres standby baru berjalan:

/opt/apigee/apigee-service/bin/apigee-all status

Jika Postgres tidak berjalan, mulailah:

/opt/apigee/apigee-service/bin/apigee-all start

Pastikan Postgres dihentikan di 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

Jika diinstal, mulai Qpid di node standby lama:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Catatan: Dalam banyak konfigurasi, node standby lama hanya akan menghosting Postgres, bukan Qpid.
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 pengguna 'apigee', yang secara default adalah "postgres".
2. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna 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. Konfigurasikan master baru:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
Jika sudah mengupgrade node standby lama ke versi yang lebih baru, Anda harus mendowngrade software Apigee di node standby lama terlebih dahulu. Jika Anda masih memiliki versi lama di node standby lama, 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 rollback) di node standby lama. Langkah-langkah persisnya dapat bervariasi berdasarkan apakah Anda menggunakan penginstalan berbasis internet atau offline. Menjalankan bootstrap Apigee versi lama akan menyiapkan 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. Periksa dan pastikan komponen Postgres di node standby lama telah di-roll back ke versi lama:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```

Buat ulang node standby lama:

Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna 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

Hapus direktori data di node standby lama:

cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

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

Pastikan Postgres berjalan di node standby lama:

/opt/apigee/apigee-service/bin/apigee-all status

Jika Postgres tidak berjalan, mulailah:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Verifikasi bahwa node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master baru.

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 di bagian consumer-groups. Fungsi ini juga menampilkan UUID master Postgres lama dan node standby 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" : {
  }
}

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"
```
Catatan: Layanan edge-postgres-server harus berjalan. Jika server Postgres tidak berjalan, Anda dapat menjalankan perintah berikut di Server Pengelolaan untuk menentukan UUID:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
Output perintah ini mencantumkan UUID untuk alamat IP setiap node Postres.
Ulangi langkah sebelumnya untuk mendapatkan alamat IP node standby lama dan master baru.
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 grup konsumen dan analisis. 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 kini harus kosong.

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 di bagian uuids kini seharusnya kosong.

Daftarkan master PG dan node standby baru dengan grup analisis dan konsumen:

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

Validasi grup analisis:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Anda akan melihat UUID node master dan standby baru yang tercantum di grup analisis dan grup konsumen.

Mulai ulang Server Pengelolaan Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Mulai ulang semua server Qpid:

/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Mulai ulang semua server Postgres:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Sistem akan menampilkan hasil yang sama di kedua server untuk memastikan replika berhasil:
Di master baru, jalankan:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Pastikan bahwa server tersebut adalah server master. Di node standby lama:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Pastikan perangkat dalam mode standby.
Ulangi langkah sebelumnya setelah membuat beberapa permintaan API untuk memastikan node sinkron.
Nonaktifkan master Postgres lama menggunakan prosedur dalam Mengupdate Apigee Edge 4.16.01/4.16.05 ke 4.17.09.
Catatan: Jika node master lama menjalankan Qpid, Anda dapat membiarkan server tersebut tetap aktif untuk menjalankan Qpid. Pastikan aplikasi tersebut berjalan. Jika tidak, mulai:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
Atau, Anda dapat meng-uninstal Qpid dari master lama dan menginstal Qpid di node master baru. Setelah meng-uninstal Qpid, Anda dapat menonaktifkan node master lama.

Melakukan roll back mTLS

Untuk melakukan rollback update mTLS, lakukan langkah-langkah berikut di semua host:

Menghentikan Apigee:
```
apigee-all stop
```
Menghentikan mTLS:
```
apigee-service apigee-mtls uninstall
```

Instal ulang mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf