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

# Memutakhirkan domain OpenSearch Layanan Amazon
<a name="version-migration"></a>

**catatan**  
OpenSearch dan peningkatan versi Elasticsearch berbeda dari pembaruan perangkat lunak layanan. Untuk informasi tentang memperbarui perangkat lunak layanan untuk domain OpenSearch Layanan Anda, lihat[Pembaruan perangkat lunak layanan di Amazon OpenSearch Service](service-software.md).

Amazon OpenSearch Service menawarkan peningkatan di tempat untuk domain yang menjalankan OpenSearch 1.0 atau yang lebih baru, atau Elasticsearch 5.1 atau versi lebih baru. Jika Anda menggunakan layanan seperti Amazon Data Firehose atau Amazon CloudWatch Logs untuk mengalirkan data ke OpenSearch Layanan, periksa apakah layanan ini mendukung versi yang lebih baru sebelum bermigrasi. OpenSearch 

## Jalur pemutakhiran yang didukung
<a name="supported-upgrade-paths"></a>

Saat ini, OpenSearch Layanan mendukung jalur pemutakhiran berikut:


| Dari versi | Ke versi | 
| --- | --- | 
| OpenSearch 1.3, 2. x, atau 3. x |  OpenSearch 3. *x* Jika Anda menjalankan OpenSearch 1.3 atau 2.x, Anda harus terlebih dahulu meningkatkan ke OpenSearch 2.19 *sebelum* memutakhirkan ke 3.x. OpenSearch Saat memutakhirkan dari OpenSearch 2.19 ke OpenSearch 3.x, Anda mungkin perlu mengatasi pengaturan indeks yang tidak kompatibel berikut. Ini tidak digunakan lagi sebelumnya di 2.x dan akan menyebabkan kegagalan validasi pemeriksaan pemutakhiran jika tidak dihapus. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html) [Untuk informasi selengkapnya tentang setelan indeks yang tidak digunakan lagi dan langkah-langkah untuk memulihkannya, lihat Pengaturan indeks.](https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings) Untuk daftar lengkap perubahan yang melanggar untuk OpenSearch 3.x, lihat [3.0.0](https://docs.opensearch.org/latest/breaking-changes/#300). Jika domain Anda berisi indeks yang dibuat di OpenSearch 1.3, Elasticsearch 7.10, atau versi sebelumnya, Anda harus mengindeks ulang mereka sebelum memutakhirkan ke 3.x. OpenSearch OpenSearch 3.x tidak mendukung indeks lama ini, terlepas dari apakah mereka berada di penyimpanan panas UltraWarm, atau dingin. Untuk mengindeks ulang indeks yang tidak kompatibel UltraWarm atau dingin: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html) Atau, hapus indeks jika Anda tidak lagi membutuhkannya.  | 
| OpenSearch 1.3 atau 2. x |  OpenSearch 2. *x* OpenSearch 2.17 akan mengaktifkan pencarian segmen bersamaan secara default dengan mode auto jika domain memenuhi kondisi berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html) Versi 2.3 memiliki perubahan melanggar berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html)  | 
| OpenSearch 1. x | OpenSearch 1. x | 
| Elasticsearch 7. x |  Elasticsearch 7. *x* atau OpenSearch 1. *x*  OpenSearch 1. *x* memperkenalkan banyak perubahan yang melanggar. Lihat perinciannya di [Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan](rename.md).   | 
|  Elasticsearch 6.8  |  Elasticsearch 7. *x* atau OpenSearch 1. *x*  Elasticsearch 7.0 dan OpenSearch 1.0 mencakup banyak perubahan yang melanggar. Sebelum memulai peningkatan di tempat, kami sarankan untuk [mengambil snapshot manual dari 6](managedomains-snapshots.md). *x* domain, memulihkannya pada tes 7. *x* atau OpenSearch 1. *x* domain, dan menggunakan domain uji itu untuk mengidentifikasi potensi masalah peningkatan. Untuk melanggar perubahan di OpenSearch 1.0, lihat[Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan](rename.md). Seperti Elasticsearch 6. *x*, indeks hanya dapat berisi satu jenis pemetaan, tetapi tipe itu sekarang harus diberi nama. `_doc` Akibatnya, tertentu APIs tidak lagi memerlukan tipe pemetaan di badan permintaan (seperti `_bulk` API). Untuk indeks baru, Elasticsearch 7 yang dihosting sendiri. *x* dan OpenSearch 1. *x* memiliki jumlah pecahan default satu. OpenSearch Domain layanan di Elasticsearch 7. *x* dan kemudian mempertahankan default sebelumnya dari lima.   | 
| Elasticsearch 6. *x* | Elasticsearch 6. *x* | 
| Elasticsearch 5.6 |  Elasticsearch 6. *x*  Indeks dibuat dalam versi 6. *x* tidak lagi mendukung beberapa jenis pemetaan. Indeks dibuat dalam versi 5. *x* masih mendukung beberapa jenis pemetaan saat dikembalikan ke 6. *x* gugus. Periksa apakah kode klien Anda hanya membuat satu jenis pemetaan per indeks. Untuk meminimalkan waktu henti selama pemutakhiran dari Elasticsearch 5.6 ke 6. *x*, OpenSearch Service mengindeks ulang `.kibana` indeks ke`.kibana-6`, menghapus, membuat alias bernama `.kibana``.kibana`, dan memetakan indeks baru ke alias baru.   | 
| Elasticsearch 5. x | Elasticsearch 5. x | 

Proses peningkatan terdiri dari tiga langkah:

1. **Pemeriksaan pra-peningkatan** — OpenSearch Layanan memeriksa masalah yang dapat memblokir peningkatan dan tidak melanjutkan ke langkah berikutnya kecuali pemeriksaan ini berhasil.

1. **Snapshot** — OpenSearch Layanan mengambil snapshot dari cluster OpenSearch atau Elasticsearch dan tidak melanjutkan ke langkah berikutnya kecuali snapshot berhasil. Jika pemutakhiran gagal, OpenSearch Service menggunakan snapshot ini untuk mengembalikan cluster ke keadaan semula. Untuk mengetahui informasi selengkapnya, lihat [Tidak dapat menurunkan versi setelah peningkatan](handling-errors.md#troubleshooting-upgrade-snapshot).

1. **Upgrade** - OpenSearch Layanan memulai peningkatan, yang dapat memakan waktu dari 15 menit hingga beberapa jam untuk menyelesaikannya. OpenSearch Dasbor mungkin tidak tersedia selama beberapa atau semua peningkatan.

# Memutakhirkan domain (konsol)
<a name="starting-upgrades"></a>

Proses pemutakhiran tidak dapat diubah dan tidak dapat dijeda atau dibatalkan. Selama peningkatan, Anda tidak dapat membuat perubahan konfigurasi pada domain. Sebelum memulai peningkatan, periksa kembali apakah Anda ingin melanjutkan. Anda dapat menggunakan langkah-langkah yang sama ini untuk melakukan pemeriksaan pra-peningkatan tanpa benar-benar memulai peningkatan.

Jika cluster memiliki node master khusus, OpenSearch upgrade selesai tanpa downtime. Jika tidak, klaster mungkin tidak responsif untuk beberapa detik pasca-peningkatan saat klaster memilih simpul utama.

**Untuk meng-upgrade domain ke versi yang lebih baru dari OpenSearch atau Elasticsearch**

1. [Ambil snapshot manual](managedomains-snapshots.md) dari domain Anda. Snapshot ini berfungsi sebagai cadangan yang dapat Anda [pulihkan pada domain baru](managedomains-snapshot-restore.md) jika Anda ingin kembali menggunakan OpenSearch versi sebelumnya.

1. Buka [https://aws.amazon.com](https://console.aws.amazon.com/)dan pilih **Masuk ke Konsol**.

1. Di bawah **Analytics**, pilih ** OpenSearch Layanan Amazon**.

1. Di panel navigasi, di bawah **Domain**, pilih domain yang ingin Anda tingkatkan.

1. Pilih **Tindakan** dan **Tingkatkan**.

1. Pilih versi untuk meng-upgrade ke. Jika Anda memutakhirkan ke OpenSearch versi, opsi **Aktifkan mode kompatibilitas** akan muncul. Jika Anda mengaktifkan pengaturan ini, OpenSearch laporkan versinya sebagai 7.10 untuk memungkinkan klien dan plugin Elasticsearch OSS seperti Logstash untuk terus bekerja dengan Amazon Service. OpenSearch Anda dapat menonaktifkan pengaturan ini nanti

1. Pilih **Tingkatkan**.

1. Periksa **Status** di dasbor domain untuk memantau status peningkatan.

# Memutakhirkan domain (CLI)
<a name="starting-upgrades-cli"></a>

Anda dapat menggunakan operasi berikut untuk mengidentifikasi versi OpenSearch atau Elasticsearch yang benar untuk domain Anda, memulai pemutakhiran di tempat, melakukan pemeriksaan pra-pemutakhiran, dan melihat kemajuan:
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)

Untuk informasi selengkapnya, lihat [referensi perintah AWS CLI dan Referensi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) [API OpenSearch Layanan Amazon](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).

# Memutakhirkan domain (SDK)
<a name="starting-upgrades-sdk"></a>

Contoh ini menggunakan klien Python [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)tingkat rendah dari AWS SDK for Python (Boto) untuk memeriksa apakah domain memenuhi syarat untuk ditingkatkan ke versi tertentu, memutakhirkannya, dan terus memeriksa status pemutakhiran.

```
import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default Region.

DOMAIN_NAME = ''  # The name of the domain to upgrade
TARGET_VERSION = ''  # The version you want to upgrade the domain to. For example, OpenSearch_1.1

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)
client = boto3.client('opensearch', config=my_config)


def check_versions():
    """Determine whether domain is eligible for upgrade"""
    response = client.get_compatible_versions(
        DomainName=DOMAIN_NAME
    )
    compatible_versions = response['CompatibleVersions']
    for i in range(len(compatible_versions)):
        if TARGET_VERSION in compatible_versions[i]["TargetVersions"]:
            print('Domain is eligible for upgrade to ' + TARGET_VERSION)
            upgrade_domain()
            print(response)
        else:
            print('Domain not eligible for upgrade to ' + TARGET_VERSION)


def upgrade_domain():
    """Upgrades the domain"""
    response = client.upgrade_domain(
        DomainName=DOMAIN_NAME,
        TargetVersion=TARGET_VERSION
    )
    print('Upgrading domain to ' + TARGET_VERSION + '...' + response)
    time.sleep(5)
    wait_for_upgrade()


def wait_for_upgrade():
    """Get the status of the upgrade"""
    response = client.get_upgrade_status(
        DomainName=DOMAIN_NAME
    )
    if (response['UpgradeStep']) == 'UPGRADE' and (response['StepStatus']) == 'SUCCEEDED':
        print('Domain successfully upgraded to ' + TARGET_VERSION)
    elif (response['StepStatus']) == 'FAILED':
        print('Upgrade failed. Please try again.')
    elif (response['StepStatus']) == 'SUCCEEDED_WITH_ISSUES':
        print('Upgrade succeeded with issues')
    elif (response['StepStatus']) == 'IN_PROGRESS':
        time.sleep(30)
        wait_for_upgrade()


def main():
    check_versions()


if __name__ == "__main__":
    main()
```

## Memecahkan masalah kegagalan validasi
<a name="upgrade-validation"></a>

Saat Anda memulai pemutakhiran versi OpenSearch atau Elasticsearch, OpenSearch Layanan terlebih dahulu melakukan serangkaian pemeriksaan validasi untuk memastikan bahwa domain Anda memenuhi syarat untuk peningkatan. Jika salah satu pemeriksaan ini gagal, Anda menerima pemberitahuan yang berisi masalah spesifik yang harus Anda perbaiki sebelum memutakhirkan domain Anda. Untuk daftar potensi masalah dan langkah-langkah untuk menyelesaikannya, lihat[Memecahkan masalah kesalahan validasi](managedomains-configuration-changes.md#validation).

## Memecahkan masalah peningkatan
<a name="upgrade-failures"></a>

Upgrade di tempat membutuhkan domain yang sehat. Domain Anda mungkin tidak memenuhi syarat untuk peningkatan atau gagal ditingkatkan karena berbagai alasan. Tabel berikut menunjukkan masalah yang paling umum.


| Masalah | Deskripsi | 
| --- | --- | 
| Plugin opsional tidak didukung |  Ketika Anda meng-upgrade domain dengan plugin opsional, OpenSearch Layanan secara otomatis meningkatkan plugin juga. Oleh karena itu, versi target untuk domain Anda juga harus mendukung plugin opsional ini. Jika domain memiliki plugin opsional diinstal yang tidak tersedia untuk versi target, permintaan upgrade gagal.  | 
| Terlalu banyak serpihan per simpul | OpenSearch, serta 7. x versi Elasticsearch, memiliki pengaturan default tidak lebih dari 1.000 pecahan per node. Jika node di kluster Anda saat ini melebihi setelan ini, OpenSearch Service tidak mengizinkan Anda untuk memutakhirkan. Lihat [Melampaui batas serpihan maksimum](handling-errors.md#troubleshooting-shard-limit) untuk opsi pemecahan masalah. | 
| Domain sedang diproses | Domain sedang di tengah-tengah perubahan konfigurasi. Periksa kelayakan peningkatan setelah operasi selesai. | 
| Status klaster merah | Satu atau lebih indeks di cluster berwarna merah. Untuk langkah-langkah pemecahan masalah, lihat [Status klaster merah](handling-errors.md#handling-errors-red-cluster-status). | 
| Tingkat kesalahan tinggi | Cluster mengembalikan sejumlah besar kesalahan 5 xx saat mencoba memproses permintaan. Masalah ini biasanya merupakan hasil dari terlalu banyaknya permintaan baca atau tulis secara bersamaan. Pertimbangkan untuk mengurangi lalu lintas ke klaster atau menskalakan domain Anda. | 
| Split brain | Otak terbelah berarti bahwa cluster Anda memiliki lebih dari satu simpul master dan telah dibagi menjadi dua cluster yang tidak akan pernah bergabung kembali dengan sendirinya. Anda dapat menghindari split brain dengan menggunakan jumlah yang direkomendasikan untuk [simpul utama terdedikasi](managedomains-dedicatedmasternodes.md). Untuk bantuan pemulihan dari split brain, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Simpul utama tidak ditemukan | OpenSearch Layanan tidak dapat menemukan simpul master cluster. Jika domain Anda menggunakan [multi-AZ](managedomains-multiaz.md), kegagalan Availability Zone mungkin telah menyebabkan klaster kehilangan kuorum dan tidak dapat memilih [simpul utama](managedomains-dedicatedmasternodes.md) yang baru. Jika masalah tidak teratasi sendiri, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Terlalu banyak tugas yang tertunda | Simpul utama berada di bawah beban berat dan memiliki banyak tugas yang tertunda. Pertimbangkan untuk mengurangi lalu lintas ke klaster atau menskalakan domain Anda. | 
| Volume penyimpanan yang terganggu | Volume disk dari satu atau lebih simpul tidak berfungsi dengan benar. Masalah ini sering terjadi bersamaan dengan masalah lainnya, seperti tingkat kesalahan yang tinggi atau terlalu banyak tugas yang tertunda. Jika terjadi dalam isolasi dan tidak teratasi sendiri, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Masalah kunci KMS | Kunci KMS yang digunakan untuk mengenkripsi domain tidak dapat diakses atau hilang. Untuk informasi selengkapnya, lihat [Memantau domain yang mengenkripsi data saat tidak digunakan](encryption-at-rest.md#monitoring-ear). | 
| Snapshot sedang berlangsung | Domain saat ini sedang mengambil snapshot. Periksa kelayakan peningkatan setelah snapshot selesai. Juga periksa apakah Anda dapat mencantumkan repositori snapshot manual, mencantumkan snapshot dalam repositori tersebut, dan mengambil snapshot manual. Jika OpenSearch Layanan tidak dapat memeriksa apakah snapshot sedang berlangsung, pemutakhiran dapat gagal. | 
| Waktu habis atau kegagalan snapshot | Snapshot pra-peningkatan terlalu lama untuk diselesaikan atau gagal. Periksa kesehatan klaster, dan coba lagi. Jika masalah berlanjut, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Indeks yang tidak kompatibel | Satu atau lebih indeks tidak kompatibel dengan versi target. Masalah ini dapat terjadi jika Anda memigrasikan indeks dari versi lama OpenSearch atau Elasticsearch. Indeks ulang indeks dan coba lagi. | 
| Penggunaan disk yang tinggi | Penggunaan disk untuk klaster di atas 90%. Hapus data atau skalakan domain, dan coba lagi. | 
| Penggunaan JVM yang tinggi | Tekanan memori JVM di atas 75%. Kurangi lalu lintas ke klaster atau skalakan domain, dan coba lagi. | 
| OpenSearch Masalah alias dasbor | .dashboardssudah dikonfigurasi sebagai alias dan memetakan ke indeks yang tidak kompatibel, kemungkinan dari versi Dasbor sebelumnya. OpenSearch Index ulang dan coba lagi. | 
| Status Dasbor Merah | OpenSearch Status dasbor berwarna merah. Coba gunakan Dasbor saat pemutakhiran selesai. Jika status merah tetap ada, selesaikan secara manual, dan coba lagi. | 
| Kompatibilitas lintas klaster |  Anda hanya dapat memutakhirkan jika kompatibilitas lintas cluster dipertahankan antara domain sumber dan tujuan setelah pemutakhiran. Selama proses peningkatan, koneksi apa pun yang tidak kompatibel akan diidentifikasi. Untuk melanjutkan, tingkatkan domain jarak jauh atau hapus koneksi yang tidak kompatibel. Perhatikan bahwa jika replikasi aktif di domain, Anda tidak dapat melanjutkannya setelah Anda menghapus koneksi.   | 
| Masalah OpenSearch layanan layanan lainnya | Masalah dengan OpenSearch Layanan itu sendiri dapat menyebabkan domain Anda ditampilkan sebagai tidak memenuhi syarat untuk peningkatan. Jika tidak ada syarat sebelumnya yang berlaku untuk domain Anda dan masalah berlanjut selama lebih dari satu hari, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 

# Menggunakan snapshot untuk memigrasi data
<a name="snapshot-based-migration"></a>

Peningkatan di tempat adalah cara yang lebih mudah, lebih cepat, dan lebih andal untuk meningkatkan domain ke versi yang lebih baru OpenSearch atau Elasticsearch. Snapshot adalah opsi yang baik jika Anda perlu bermigrasi dari versi Elasticsearch sebelum 5.1 atau ingin bermigrasi ke klaster yang sepenuhnya baru.

Tabel berikut menunjukkan cara menggunakan snapshot untuk memigrasikan data ke domain yang menggunakan versi berbeda OpenSearch atau Elasticsearch. Untuk informasi selengkapnya tentang mengambil dan memulihkan snapshots, lihat [Membuat snapshot indeks di Amazon Service OpenSearch](managedomains-snapshots.md).


| Dari versi | Ke versi | Proses migrasi | 
| --- | --- | --- | 
| OpenSearch 1.3 atau 2. x | OpenSearch 2. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| OpenSearch 1. x | OpenSearch 1. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6. x atau 7. x | OpenSearch 1. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6. x | Elasticsearch 7. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6. x | Elasticsearch 6.8 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 5. x | Elasticsearch 6. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 5. x | Elasticsearch 5.6 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 2.3 | Elasticsearch 6. x |  Snapshot Elasticsearch 2.3 tidak kompatibel dengan 6.*x*. Untuk memigrasikan data Anda secara langsung dari 2.3 ke 6. *x*, Anda harus secara manual membuat ulang indeks Anda di domain baru. Bergantian, Anda dapat mengikuti 2.3 hingga 5. *x* langkah dalam tabel ini, melakukan `_reindex` operasi di 5 baru. *x* domain untuk mengonversi indeks 2.3 Anda menjadi 5. *x* indeks, dan kemudian ikuti 5. *x* sampai 6. *x* langkah.  | 
| Elasticsearch 2.3 | Elasticsearch 5. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 1.5 | Elasticsearch 5. x |  Snapshot Elasticsearch 1.5 tidak kompatibel dengan 5.*x*. Untuk memigrasikan data Anda dari 1,5 ke 5. *x*, Anda harus secara manual membuat ulang indeks Anda di domain baru.  1.5 snapshot *kompatibel* dengan 2.3, tetapi domain OpenSearch Layanan 2.3 tidak mendukung operasi. `_reindex` Karena Anda tidak dapat mengindeks ulang mereka, indeks yang berasal dari domain 1.5 masih gagal memulihkan dari 2.3 snapshot ke 5. *x* domain.   | 
| Elasticsearch 1.5 | Elasticsearch 2.3 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/snapshot-based-migration.html)  |