

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mempertahankan Cluster DB Amazon Neptunus Anda
<a name="cluster-maintenance"></a>

Neptunus melakukan pemeliharaan secara berkala pada semua sumber daya yang digunakannya, termasuk:
+ **Mengganti perangkat keras yang mendasarinya seperlunya.** Ini terjadi di latar belakang, tanpa Anda harus mengambil tindakan apa pun, dan umumnya tidak berpengaruh pada operasi Anda.
+ **Memperbarui sistem operasi yang mendasarinya.** Upgrade sistem operasi dari instans di cluster DB Anda dilakukan untuk meningkatkan kinerja dan keamanan, jadi Anda biasanya harus menyelesaikannya sesegera mungkin. Pembaruan biasanya memerlukan waktu sekitar 10 menit. Pembaruan sistem operasi tidak akan mengubah versi mesin DB atau kelas instans DB dari instans DB.

  Biasanya yang terbaik adalah memperbarui instance pembaca di cluster DB terlebih dahulu, dan kemudian instance penulis. Memperbarui pembaca dan penulis pada saat yang sama dapat menyebabkan downtime jika terjadi failover. Perhatikan bahwa instans DB tidak secara otomatis dicadangkan sebelum pembaruan sistem operasi, jadi pastikan untuk membuat cadangan manual sebelum Anda menerapkan pembaruan sistem operasi.
+ **Memperbarui mesin database Neptunus.** Neptunus secara teratur merilis berbagai pembaruan mesin untuk memperkenalkan fitur dan peningkatan baru dan untuk memperbaiki bug.

## Nomor versi mesin
<a name="engine-version-numbers"></a>

### Penomoran versi sebelum rilis mesin 1.3.0.0
<a name="older-engine-numbers"></a>

Sebelum November 2019, Neptune hanya mendukung satu versi mesin pada satu waktu, dan versi mesin semuanya mengambil bentuk angka, `1.0.1.0.200<xxx>`, saat `xxx` adalah nomor patch. Semua versi mesin baru dirilis sebagai tambalan ke versi sebelumnya.

Pada November 2019, Neptunus mulai mendukung beberapa versi, memungkinkan pelanggan mengontrol jalur peningkatan mereka dengan lebih baik. Akibatnya, penomoran rilis mesin berubah.

Dari November 2019 hingga [rilis mesin 1.3.0.0](engine-releases-1.3.0.0.md), nomor versi mesin memiliki 5 bagian. Ambil nomor versi `1.0.2.0.R2` sebagai contoh:
+ Bagian pertama selalu 1.
+ Bagian kedua, `0` di`1.0.2.0.R2`), adalah nomor versi utama database.
+ Bagian ketiga dan keempat, `2.0` in`1.0.2.0.R2`) keduanya nomor versi minor.
+ Bagian kelima (`R2`in`1.0.2.0.R2`) adalah nomor patch.

Sebagian besar pembaruan adalah pembaruan tambalan, dan perbedaan antara tambalan dan pembaruan versi minor tidak selalu jelas.

### Penomoran versi dari rilis mesin 1.3.0.0 aktif
<a name="current-engine-numbers"></a>

Dimulai dengan [rilis mesin 1.3.0.0,](engine-releases-1.3.0.0.md) Neptunus mengubah cara pembaruan mesin diberi nomor dan dikelola.

Nomor versi mesin sekarang memiliki empat bagian, yang masing-masing sesuai dengan jenis rilis, sebagai berikut:

    *product-version***.***major-version***.***minor-version***.***patch-version*

Perubahan yang tidak melanggar dari jenis yang sebelumnya dirilis sebagai tambalan sekarang dirilis sebagai versi minor yang dapat Anda kelola menggunakan pengaturan [`AutoMinorVersionUpgrade`](engine-maintenance-management.md#using-amvu)instans.

Ini berarti bahwa jika Anda mau, Anda dapat menerima pemberitahuan setiap kali versi minor baru dirilis, dengan berlangganan [`RDS-EVENT-0156`](event-lists.md#RDS-EVENT-0156)acara (lihat [Berlangganan pemberitahuan acara Neptunus](events-subscribing.md)).

Rilis patch sekarang dicadangkan untuk perbaikan bertarget yang mendesak, dan diberi nomor menggunakan bagian terakhir dari nomor versi (`*.*.*.1`,`*.*.*.2`, dan sebagainya).

# Berbagai jenis rilis mesin di Amazon Neptunus
<a name="release-types"></a>

Empat jenis pelepasan mesin yang sesuai dengan empat bagian nomor versi mesin adalah sebagai berikut:
+ **Versi produk** — Ini hanya berubah jika produk mengalami perubahan mendasar dalam fungsionalitas atau antarmuka. Versi produk Neptunus saat ini adalah 1.
+ [**Versi utama — Versi**](#major-versions) utama memperkenalkan fitur baru yang penting dan melanggar perubahan, dan umumnya memiliki masa pakai yang berguna setidaknya dua tahun.
+ [**Versi minor - Versi**](#minor-versions) minor dapat berisi fitur baru, perbaikan, dan perbaikan bug tetapi tidak mengandung perubahan yang melanggar. Anda dapat memilih apakah akan menerapkannya secara otomatis atau tidak selama jendela pemeliharaan berikutnya, dan Anda juga dapat memilih untuk diberi tahu setiap kali dirilis.
+ [**Versi patch — Versi**](#patch-version-updates) patch dirilis hanya untuk mengatasi perbaikan bug yang mendesak atau pembaruan keamanan kritis. Mereka jarang mengandung perubahan yang melanggar, dan mereka secara otomatis diterapkan selama jendela pemeliharaan berikutnya setelah rilis mereka.

## Pembaruan versi utama Amazon Neptunus
<a name="major-versions"></a>

Pembaruan versi utama umumnya memperkenalkan satu atau lebih fitur baru yang penting dan sering kali berisi perubahan yang melanggar. Biasanya memiliki masa dukungan sekitar dua tahun. Versi utama Neptunus tercantum [dalam rilis Engine](engine-releases.md), bersama dengan tanggal rilis dan perkiraan akhir masa pakainya.

Pembaruan versi utama sepenuhnya opsional sampai versi utama yang Anda gunakan mencapai akhir masa pakainya. Jika Anda memilih untuk meningkatkan ke versi utama baru, Anda harus menginstal versi baru sendiri menggunakan AWS CLI atau konsol Neptunus seperti yang dijelaskan dalam. [Peningkatan versi mayor](engine-updates-manually.md)

Namun, jika versi utama yang Anda gunakan mencapai akhir masa pakainya, Anda akan diberi tahu bahwa Anda diminta untuk meningkatkan ke versi utama yang lebih baru. Kemudian, jika Anda tidak meningkatkan dalam masa tenggang setelah pemberitahuan, peningkatan ke versi utama terbaru secara otomatis dijadwalkan terjadi selama jendela pemeliharaan berikutnya. Untuk informasi selengkapnya, lihat [Rentang hidup versi mesin](engine-updates-eol-planning.md).

## Pembaruan versi minor Amazon Neptunus
<a name="minor-versions"></a>

Sebagian besar pembaruan mesin Neptunus adalah pembaruan versi minor. Mereka terjadi cukup sering dan tidak mengandung perubahan yang melanggar.

Jika Anda memiliki [`AutoMinorVersionUpgrade`](engine-maintenance-management.md#using-amvu)bidang yang disetel ke `true` dalam instance writer (primer) dari cluster DB Anda, pembaruan versi minor diterapkan secara otomatis ke semua instance di cluster DB Anda selama jendela pemeliharaan berikutnya setelah dirilis.

Jika Anda memiliki [`AutoMinorVersionUpgrade`](engine-maintenance-management.md#using-amvu)bidang yang disetel ke `false` dalam instance penulis cluster DB Anda, mereka diterapkan hanya jika Anda [menginstalnya secara eksplisit](engine-updates-manually.md).

**catatan**  
Pembaruan versi minor bersifat mandiri (tidak bergantung pada pembaruan versi minor sebelumnya ke versi utama yang sama), dan kumulatif (berisi semua fitur dan perbaikan yang diperkenalkan dalam pembaruan versi minor sebelumnya). Ini berarti Anda dapat menginstal pembaruan versi minor yang diberikan apakah Anda telah menginstal yang sebelumnya atau tidak.

Sangat mudah untuk melacak rilis versi minor dengan berlangganan [`RDS-EVENT-0156`](event-lists.md#RDS-EVENT-0156)acara (lihat Berlangganan pemberitahuan acara [Neptunus](events-subscribing.md)). Anda kemudian akan diberi tahu setiap kali versi minor baru dirilis.

Juga, apakah Anda berlangganan notifikasi atau tidak, Anda selalu dapat [memeriksa untuk melihat pembaruan apa yang tertunda](engine-maintenance-management.md#check-pending-updates).

## Pembaruan versi patch Amazon Neptunus
<a name="patch-version-updates"></a>

Dalam kasus masalah keamanan atau cacat serius lainnya yang memengaruhi keandalan instans, Neptunus menyebarkan patch wajib. Mereka diterapkan ke semua instance di cluster DB Anda selama jendela pemeliharaan berikutnya tanpa intervensi apa pun dari Anda.

Rilis patch hanya diterapkan ketika risiko tidak menerapkannya lebih besar daripada risiko dan waktu henti apa pun yang terkait dengan penerapannya. Rilis patch jarang terjadi (biasanya setiap beberapa bulan sekali) dan jarang membutuhkan lebih dari sebagian kecil jendela pemeliharaan Anda untuk diterapkan.

# Merencanakan masa pakai versi mesin utama Amazon Neptunus
<a name="engine-updates-eol-planning"></a>

Versi mesin Neptunus hampir selalu mencapai akhir masa pakainya pada akhir seperempat kalender. Pengecualian hanya terjadi ketika masalah keamanan atau ketersediaan penting muncul.

Ketika versi mesin mencapai akhir masa pakainya, Anda akan diminta untuk meningkatkan basis data Neptunus Anda ke versi yang lebih baru.

Secara umum, versi mesin Neptunus terus tersedia sebagai berikut:
+ **Versi mesin minor:** Versi mesin minor tetap tersedia setidaknya selama 6 bulan setelah dirilis.
+ **Versi mesin utama:** Versi mesin utama tetap tersedia setidaknya selama 12 bulan setelah dirilis. 

Setidaknya 3 bulan sebelum versi mesin mencapai akhir masa pakainya, AWS akan mengirimkan pemberitahuan email otomatis ke alamat email yang terkait dengan AWS akun Anda dan memposting pesan yang sama ke [Dasbor AWS Kesehatan](https://docs.aws.amazon.com/health/latest/ug/aws-health-dashboard-status.html) Anda. Ini akan memberi Anda waktu untuk merencanakan dan bersiap untuk meningkatkan.

Ketika versi mesin mencapai akhir masa pakainya, Anda tidak akan lagi dapat membuat cluster atau instance baru menggunakan versi itu, juga tidak akan dapat membuat instance menggunakan versi itu.

Versi mesin yang benar-benar mencapai akhir masa pakainya akan secara otomatis ditingkatkan selama jendela pemeliharaan. Pesan yang dikirimkan kepada Anda 3 bulan sebelum akhir masa pakai versi mesin akan berisi detail tentang apa yang akan melibatkan pembaruan otomatis ini, termasuk versi yang akan Anda upgrade secara otomatis, dampaknya pada cluster DB Anda, dan tindakan yang kami rekomendasikan.

**penting**  
Anda bertanggung jawab untuk menjaga versi mesin database Anda tetap terkini. AWS mendesak semua pelanggan untuk meningkatkan basis data mereka ke versi mesin terbaru untuk mendapatkan keuntungan dari perlindungan keamanan, privasi, dan ketersediaan terkini. Jika Anda mengoperasikan database Anda pada mesin atau perangkat lunak yang tidak didukung setelah tanggal penghentian (“Legacy Engine”), Anda menghadapi kemungkinan risiko keamanan, privasi, dan operasional yang lebih besar, termasuk peristiwa downtime.  
Pengoperasian database Anda pada mesin apa pun tunduk pada Perjanjian yang mengatur penggunaan AWS Layanan oleh Anda. Mesin Legacy umumnya tidak tersedia. AWS tidak lagi memberikan dukungan untuk Legacy Engine, dan AWS dapat membatasi akses atau penggunaan Legacy Engine kapan saja, jika AWS menentukan Legacy Engine menimbulkan risiko keamanan atau kewajiban, atau risiko bahaya, terhadap Layanan, Afiliasinya AWS, atau pihak ketiga mana pun. Keputusan Anda untuk terus menjalankan Konten Anda di Legacy Engine dapat mengakibatkan Konten Anda menjadi tidak tersedia, rusak, atau tidak dapat dipulihkan. Database yang berjalan pada Legacy Engine tunduk pada Pengecualian Perjanjian Tingkat Layanan (SLA).  
DATABASE DAN PERANGKAT LUNAK TERKAIT YANG BERJALAN PADA MESIN LAMA MENGANDUNG BUG, KESALAHAN, CACAT, KOMPONEN AND/OR BERBAHAYA. DENGAN DEMIKIAN, DAN TERLEPAS DARI APA PUN YANG BERTENTANGAN DALAM PERJANJIAN ATAU KETENTUAN LAYANAN, AWS MENYEDIAKAN MESIN LAMA “SEBAGAIMANA ADANYA.”

# Mengelola pembaruan mesin ke cluster DB Neptunus Anda
<a name="engine-maintenance-management"></a>

**catatan**  
Pembaruan diterapkan ke semua instans dalam klaster DB pada saat yang sama. Pembaruan memerlukan restart database pada instans tersebut, sehingga Anda mengalami downtime mulai dari 20 atau 30 detik hingga beberapa menit, setelah itu Anda dapat melanjutkan menggunakan cluster DB. Pada kesempatan yang jarang terjadi, failover multi-AZ mungkin diperlukan untuk pembaruan pemeliharaan pada instans untuk diselesaikan.  
Untuk upgrade versi utama yang dapat memakan waktu lebih lama untuk diterapkan, Anda dapat menggunakan [strategi penyebaran biru-hijau](neptune-BG-deployments.md) untuk meminimalkan waktu henti.

## Menentukan versi mesin mana yang saat ini Anda gunakan
<a name="check-current-engine-version"></a>

Anda dapat menggunakan AWS CLI [`get-engine-status`](access-graph-status.md)perintah untuk memeriksa versi rilis mesin mana yang saat ini digunakan cluster DB Anda:

```
aws neptunedata get-engine-status
```

[Output JSON](access-graph-status.md#access-graph-status-sample-output) mencakup `"dbEngineVersion"` bidang seperti ini:

```
  "dbEngineVersion": "1.3.0.0",
```

## Periksa untuk melihat pembaruan apa yang tertunda dan tersedia
<a name="check-pending-updates"></a>

Anda dapat memeriksa pembaruan yang tertunda ke cluster DB Anda menggunakan konsol Neptunus. Pilih **Database** di kolom kiri dan kemudian pilih cluster DB Anda di panel database. Pembaruan yang tertunda tercantum di kolom **Pemeliharaan**. Jika Anda memilih **Actions** dan kemudian **Maintenance**, Anda memiliki tiga pilihan tentang apa yang harus dilakukan:
+ Tingkatkan sekarang.
+ Upgrade di jendela berikutnya.
+ Tunda peningkatan.

Anda dapat membuat daftar pembaruan mesin yang tertunda menggunakan AWS CLI sebagai berikut:

```
aws neptune describe-pending-maintenance-actions \
  --resource-identifier (ARN of your DB cluster)
  --region (your region) \
  --engine neptune
```

Anda juga dapat membuat daftar pembaruan mesin yang tersedia menggunakan AWS CLI sebagai berikut:

```
aws neptune describe-db-engine-versions \
  --region (your region) \
  --engine neptune
```

Daftar rilis mesin yang tersedia hanya mencakup rilis yang memiliki nomor versi lebih tinggi dari yang sekarang dan yang jalur pemutakhiran ditentukan.

## Selalu uji sebelum Anda meningkatkan
<a name="always-test-before-upgrading"></a>

Saat versi mesin Neptunus mayor atau minor baru dirilis, selalu uji aplikasi Neptunus Anda terlebih dahulu sebelum memutakhirkannya. Peningkatan kecil dapat memperkenalkan fitur atau perilaku baru yang akan memengaruhi kode Anda bahkan tanpa perubahan yang merusak.

Mulailah dengan membandingkan halaman catatan rilis dari versi Anda saat ini dengan versi yang ditargetkan untuk melihat apakah akan ada perubahan dalam versi bahasa kueri atau perubahan melanggar lainnya.

Cara terbaik untuk menguji versi baru sebelum memutakhirkan cluster DB produksi Anda adalah dengan menggunakan solusi penerapan [Neptunus Biru-Hijau](neptune-BG-deployments.md). Dengan begitu Anda dapat menjalankan aplikasi dan kueri pada versi baru tanpa memengaruhi cluster DB produksi Anda.

## Selalu buat snapshot manual sebelum Anda meng-upgrade
<a name="engine-version-snapshot-before-upgrading"></a>

Sebelum melakukan upgrade, kami sangat menyarankan agar Anda selalu membuat snapshot manual cluster DB Anda. Memiliki snapshot otomatis hanya menawarkan perlindungan jangka pendek, sedangkan snapshot manual tetap tersedia sampai Anda menghapusnya secara eksplisit.

Dalam kasus tertentu Neptunus membuat snapshot manual untuk Anda sebagai bagian dari proses peningkatan, tetapi Anda tidak harus bergantung pada ini, dan harus membuat snapshot manual Anda sendiri dalam hal apa pun.

Ketika Anda yakin bahwa Anda tidak perlu mengembalikan cluster DB Anda ke status pra-pemutakhiran, Anda dapat secara eksplisit menghapus snapshot manual yang Anda buat sendiri, serta snapshot manual yang mungkin dibuat Neptunus. Jika Neptunus membuat snapshot manual, itu akan memiliki nama yang dimulai `preupgrade` dengan, diikuti dengan nama cluster DB Anda, versi mesin sumber, versi mesin target, dan tanggal.

## Jendela Pemeliharaan Neptune
<a name="manage-console-maintaining-window"></a>

Jendela perawatan mingguan adalah periode 30 menit di mana pembaruan mesin terjadwal dan perubahan sistem lainnya diterapkan. Sebagian besar acara pemeliharaan selesai selama jendela 30 menit, meskipun acara pemeliharaan yang lebih besar terkadang lebih lama untuk diselesaikan.

Setiap cluster DB memiliki jendela pemeliharaan 30 menit mingguan. Jika Anda tidak menentukan waktu yang disukai untuk itu saat Anda membuat cluster DB, Neptunus secara acak memilih satu hari dalam seminggu dan kemudian secara acak menetapkan periode 30 menit di dalamnya dari blok waktu 8 jam yang bervariasi dengan wilayah.

Di sini, misalnya, adalah blok waktu 8 jam untuk jendela pemeliharaan yang digunakan di beberapa AWS wilayah:


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/neptune/latest/userguide/engine-maintenance-management.html)

Jendela pemeliharaan menentukan kapan operasi yang tertunda dimulai, dan sebagian besar operasi pemeliharaan selesai di dalam jendela, tetapi tugas pemeliharaan yang lebih besar dapat berlanjut di luar waktu akhir jendela.

### Memindahkan jendela pemeliharaan cluster DB Anda
<a name="manage-console-maintaining-adjusting-window"></a>

Idealnya, jendela pemeliharaan Anda harus jatuh pada saat Anda cluster berada pada penggunaan terendah. Jika itu tidak benar untuk jendela Anda saat ini, Anda dapat memindahkannya ke waktu yang lebih baik, seperti ini:

**Untuk mengubah jendela pemeliharaan cluster DB**

1. [Masuk ke Konsol AWS Manajemen, dan buka konsol Amazon Neptunus di rumah. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)

1. Di panel navigasi, pilih **database**.

1. Pilih klaster DB yang periode pemeliharaannya ingin diubah.

1. Pilih **Ubah**.

1. Pilih **Tampilkan lebih banyak** di bagian bawah halaman **Modify cluster**.

1. Di bagian **jendela Pemeliharaan pilihan**, atur hari, waktu, dan durasi jendela pemeliharaan sesuai keinginan Anda.

1. Pilih **Berikutnya**.

   Di halaman konfirmasi, tinjau perubahan Anda.

1. Untuk menerapkan perubahan ke periode pemeliharaan secara langsung, pilih **Terapkan langsung**. 

1.  Pilih **Kirim** untuk menerapkan perubahan Anda. 

   Untuk mengedit perubahan, pilih **Sebelumnya**, atau membatalkan perubahan, pilih **Batalkan**. 

## Menggunakan AutoMinorVersionUpgrade untuk mengontrol pembaruan versi minor otomatis
<a name="using-amvu"></a>

**penting**  
`AutoMinorVersionUpgrade`hanya efektif untuk peningkatan versi minor di atas [rilis mesin 1.3.0.0](engine-releases-1.3.0.0.md).

Jika Anda memiliki `AutoMinorVersionUpgrade` bidang yang disetel ke `true` dalam instance writer (primer) dari cluster DB Anda, pembaruan versi minor diterapkan secara otomatis ke semua instance di cluster DB Anda selama jendela pemeliharaan berikutnya setelah dirilis.

Jika Anda memiliki `AutoMinorVersionUpgrade` bidang yang disetel ke `false` dalam instance penulis cluster DB Anda, mereka diterapkan hanya jika Anda [menginstalnya secara eksplisit](engine-updates-manually.md#engine-minor-updates-using-console).

**catatan**  
Rilis patch (`*.*.*.1``*.*.*.2`,, dll.) selalu diinstal secara otomatis selama jendela pemeliharaan Anda berikutnya, terlepas dari bagaimana `AutoMinorVersionUpgrade` parameter diatur.

Anda dapat mengatur `AutoMinorVersionUpgrade` menggunakan Konsol Manajemen AWS sebagai berikut:

**Untuk mengatur `AutoMinorVersionUpgrade` menggunakan konsol Neptunus**

1. [Masuk ke Konsol AWS Manajemen, dan buka konsol Amazon Neptunus di rumah. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)

1. Di panel navigasi, pilih **Basis data**.

1. Pilih instance utama (penulis) dari cluster DB yang ingin Anda atur`AutoMinorVersionUpgrade`.

1. Pilih **Ubah**.

1. Pilih **Tampilkan lebih banyak** di bagian bawah halaman **Modify cluster**.

1. Di bagian bawah halaman yang diperluas, pilih **Aktifkan peningkatan versi minor otomatis** atau **Matikan peningkatan versi minor otomatis**.

1. Pilih **Berikutnya**.

   Di halaman konfirmasi, tinjau perubahan Anda.

1. Untuk menerapkan perubahan pada peningkatan versi minor otomatis, pilih **Terapkan segera**. 

1.  Pilih **Kirim** untuk menerapkan perubahan Anda. 

   Untuk mengedit perubahan, pilih **Sebelumnya**, atau membatalkan perubahan, pilih **Batalkan**. 

Anda juga dapat menggunakan AWS CLI untuk mengatur `AutoMinorVersionUpgrade` bidang. Misalnya, untuk mengaturnya`true`, Anda dapat menggunakan perintah seperti ini:

```
1. aws neptune modify-db-instance \
2.   --db-instance-identifier (the ID of your cluster's writer instance) \
3.   --auto-minor-version-upgrade \
4.   --apply-immediately
```

Demikian pula, untuk mengaturnya`false`, gunakan perintah seperti ini:

```
1. aws neptune modify-db-instance \
2.   --db-instance-identifier (the ID of your cluster's writer instance) \
3.   --no-auto-minor-version-upgrade \
4.   --apply-immediately
```

# Menginstal pembaruan ke mesin Neptunus Anda secara manual
<a name="engine-updates-manually"></a>

## Menginstal upgrade mesin versi utama
<a name="engine-major-updates-manually"></a>

Rilis mesin utama harus selalu dipasang secara manual. Untuk meminimalkan waktu henti dan menyediakan banyak waktu untuk pengujian dan validasi, cara terbaik untuk menginstal versi utama baru umumnya dengan menggunakan solusi penyebaran Biru-Hijau [Neptunus](neptune-BG-deployments.md).

Dalam beberapa kasus Anda juga dapat menggunakan CloudFormation template yang Anda gunakan untuk membuat cluster DB Anda untuk menginstal upgrade versi utama (lihat[Menggunakan CloudFormation template untuk memperbarui versi mesin Cluster DB Neptunus Anda](cfn-engine-update.md)).

Jika Anda ingin segera menginstal pembaruan versi utama, Anda dapat menggunakan perintah CLI seperti berikut:

```
aws neptune modify-db-cluster \
  --db-cluster-identifier (identifier for your neptune cluster) \
  --engine neptune \
  --engine-version (the new engine version) \
  --apply-immediately
```

Pastikan untuk menentukan versi mesin yang ingin Anda tingkatkan. Jika tidak, mesin Anda dapat ditingkatkan ke versi yang bukan yang terbaru atau yang Anda harapkan.

Alih-alih`--apply-immediately`, Anda dapat menentukan`--no-apply-immediately`.

Jika klaster Anda menggunakan grup parameter cluster kustom, pastikan untuk menentukan menggunakan paramater ini:

```
  --db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```

Demikian pula, jika ada instance di cluster yang menggunakan grup parameter DB kustom, pastikan untuk menentukannya menggunakan parameter ini:

```
  ---db-instance-parameter-group-name (name of the custom instance parameter group)
```

## Menginstal upgrade mesin versi minor menggunakan Konsol Manajemen AWS
<a name="engine-minor-updates-using-console"></a>

**Untuk melakukan upgrade versi minor menggunakan konsol Neptunus**

1. [Masuk ke Konsol AWS Manajemen, dan buka konsol Amazon Neptunus di rumah. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)

1. Di panel navigasi, pilih **Databases**, lalu pilih cluster DB yang ingin Anda modifikasi.

1. Pilih **Ubah**.

1. Di bawah **Spesifikasi instans**, pilih versi baru yang ingin Anda tingkatkan.

1. Pilih **Berikutnya**.

1. Jika Anda ingin segera menerapkan perubahan, pilih **Terapkan segera**.

1. Pilih **Kirim** untuk memperbarui cluster DB Anda.

## Menginstal upgrade mesin versi minor menggunakan AWS CLI
<a name="engine-updates-using-cli"></a>

Anda dapat menggunakan perintah seperti berikut ini untuk melakukan upgrade versi minor tanpa menunggu jendela pemeliharaan berikutnya:

```
aws neptune modify-db-cluster \
  --db-cluster-identifier (your-neptune-cluster) \
  --engine-version (new-engine-version) \
  --apply-immediately
```

Jika Anda memutakhirkan secara manual menggunakan AWS CLI, pastikan untuk menyertakan versi mesin yang ingin Anda tingkatkan. Jika tidak, mesin Anda mungkin ditingkatkan ke versi yang bukan yang terbaru atau yang Anda harapkan.

# Upgrade ke engine versi 1.2.0.0 atau lebih tinggi dari versi yang lebih awal dari 1.2.0.0
<a name="engine-updates-1200-changes"></a>

[Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan beberapa perubahan signifikan yang dapat membuat upgrade dari versi sebelumnya lebih rumit dari biasanya:
+ [Engine release 1.2.0.0](engine-releases-1.2.0.0.md) memperkenalkan format baru untuk grup parameter kustom dan grup parameter cluster kustom. Akibatnya, jika Anda memutakhirkan dari versi engine lebih awal dari 1.2.0.0 ke engine versi 1.2.0.0 atau lebih tinggi, Anda harus membuat ulang semua grup parameter kustom yang ada dan grup parameter cluster kustom menggunakan keluarga grup parameter. `neptune1.2` Rilis sebelumnya menggunakan keluarga grup parameter`neptune1`, dan grup parameter tersebut tidak akan berfungsi dengan rilis 1.2.0.0 ke atas. Untuk informasi selengkapnya, lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
+ Engine release 1.2.0.0 memperkenalkan format baru untuk membatalkan log. Akibatnya, jika Anda memutakhirkan ke versi 1.2.0.0 atau lebih tinggi dari versi yang lebih awal dari 1.2.0.0, [`UndoLogListSize`](cw-metrics.md#cw-metrics-UndoLogListSize)metrik harus di bawah ambang batas tertentu. Jika tidak, tambalan akan berputar kembali dan gagal. Ambang batas didasarkan pada jenis instance: batas default adalah 40k untuk instance 4xlarge atau lebih besar, dan 10k untuk instance yang lebih kecil dari 4xlarge. Jika `UndoLogListSize` melebihi batas saat Anda mencoba memutakhirkan, proses tambalan akan kembali, pemutakhiran akan dibatalkan, dan acara dengan alasannya akan terlihat di halaman acara cluster. Batasan ini dapat berubah karena alasan operasional tanpa peringatan sebelumnya.

  Anda dapat mempercepat tingkat pembersihan dengan memutakhirkan instance penulis cluster, di mana pembersihan terjadi. Melakukan itu sebelum mencoba meningkatkan dapat membantu menurunkan batas `UndoLogListSize` di bawah ambang batas yang berlaku. Meningkatkan ukuran penulis ke jenis instans 24XL dapat meningkatkan tingkat pembersihan Anda menjadi lebih dari satu juta catatan per jam.

  Jika `UndoLogListSize` CloudWatch metriknya sangat besar, membuka kasus dukungan dapat membantu Anda mengeksplorasi strategi tambahan untuk menurunkannya di bawah batas yang diperlukan.
+ Akhirnya, ada perubahan besar dalam rilis 1.2.0.0 yang mempengaruhi kode sebelumnya yang menggunakan protokol Bolt dengan otentikasi IAM. Dimulai dengan rilis 1.2.0.0, Bolt membutuhkan jalur sumber daya untuk penandatanganan IAM. Di Java, pengaturan jalur sumber daya mungkin terlihat seperti ini:`request.setResourcePath("/openCypher"));`. Dalam bahasa lain, `/openCypher` dapat ditambahkan ke URI endpoint. Lihat [Menggunakan protokol Bolt](access-graph-opencypher-bolt.md) sebagai contoh.