Fiziksel yedekleme kullanarak örnek verilerini kendi yönettiğiniz MongoDB veritabanına geri yükleme - ApsaraDB for MongoDB

Ön koşullar

Örnek bir çoğaltma kümesi örneğidir.
Örnek, verileri depolamak için yerel diskler kullanır.
Örnek için Şeffaf Veri Şifreleme (TDE) özelliği devre dışı bırakılmıştır. Daha fazla bilgi için bkz. Bir örnek için TDE yapılandırma.
Örneğin depolama altyapısı WiredTiger veya RocksDB'dir. Örneğin depolama altyapısı TerarkDB ise mantıksal yedekleme kullanarak örnek verilerini kendi yönettiğiniz bir veritabanına geri yükleyebilirsiniz. Daha fazla bilgi için bkz. Mantıksal yedekleme kullanarak örnek verilerini kendi yönettiğiniz MongoDB veritabanına geri yükleme.
Not
- ApsaraDB for MongoDB konsolunda Basic Information sayfasında örneğin depolama altyapısını görüntüleyebilirsiniz.
- Örneğin depolama altyapısı RocksDB ise RocksDB depolama altyapısına sahip bir MongoDB uygulamasını derlemeniz ve yüklemeniz gerekir.

Veritabanı sürümü gereksinimleri

Örneğin sürümü, kendi yönettiğiniz MongoDB veritabanının sürümüyle eşleşmelidir. Aşağıdaki tabloda örnek ile kendi yönettiğiniz MongoDB veritabanı arasındaki eşleştirmeler listelenmiştir.

ApsaraDB for MongoDB örneği	Kendi yönettiğiniz MongoDB veritabanı
MongoDB 3.2	MongoDB 3.2 veya 3,4
MongoDB 3,4	MongoDB 3,4
MongoDB 4.0	MongoDB 4.0
MongoDB 4.2	MongoDB 4.2

Fiziksel yedekleme dosyalarının biçimleri

Fiziksel yedekleme dosyası biçimi	Dosya adı uzantısı	Açıklama
TAR	.tar.gz	26 Mart 2019 tarihinden önce oluşturulan ApsaraDB for MongoDB örneklerinin fiziksel yedekleme dosyaları .tar biçimindedir.
xbstream	_qp.xb	26 Mart 2019 tarihinde veya sonrasında oluşturulan ApsaraDB for MongoDB örneklerinin fiziksel yedekleme dosyaları .xbstream biçimindedir. Not .xbstream biçimi yalnızca Linux için kullanılabilir. .xbstream biçimindeki dosyaların sıkıştırmasını açmak için kullanılan Percona XtraBackup aracını Windows desteklemediğinden bu biçim Windows'ta kullanılamaz.

Ortam

Aşağıdaki yordamda Ubuntu 16.04 64 bit görüntüsünden oluşturulan bir Elastic Compute Service (ECS) örneği kullanılır. Bir ECS örneği oluşturma hakkında daha fazla bilgi için bkz. Sihirbazı kullanarak örnek oluşturma.
Gerekli sürümdeki MongoDB, ECS örneğine yüklenmiştir. MongoDB yükleme hakkında daha fazla bilgi için bkz. MongoDB Sürücüsü Ekleme.
ECS örneğindeki kendi yönettiğiniz MongoDB veritabanı için ortam değişkenleri yapılandırılmıştır. Komutları çalıştırırken yürütülebilir dosya yollarını tekrar girmeniz gerekmez. Daha fazla bilgi için bkz. Adım 1: Ortam değişkenlerini yapılandırma.
ECS örneğinin /test/mongo/data dizini çoğaltma kümesi örneği için kullanılır.
ECS örneğinin /test/mongo/data1 ve /test/mongo/data2 dizinleri, çoğaltma kümesi düğümündeki kendi yönettiğiniz MongoDB veritabanı için kullanılır.

Adım 1: Ortam değişkenlerini yapılandırma

Kendi yönettiğiniz MongoDB veritabanı için ortam değişkenlerini yapılandırın. Bu şekilde, komutları çalıştırırken yürütülebilir dosya yollarını girmeniz gerekmez. Bu adımı uygulamadan önce MongoDB'nin yüklü olduğundan emin olun. Daha fazla bilgi için MongoDB Yükleme adresini ziyaret edin.

MongoDB için ortam değişkenleri zaten yapılandırıldıysa bu adımı atlayıp 2. Adımdaki işlemleri uygulayın. Daha fazla bilgi için bkz. Adım 2: Fiziksel yedekleme dosyasını indirme ve sıkıştırmayı açma.

Linux'ta profile dosyasını açmak için aşağıdaki komutu çalıştırın:
```
sudo vi /etc/profile
```
Düzenleme moduna girmek için i tuşuna basın. Ardından son satıra aşağıdaki kodu girin:
```
export PATH=$PATH:/<The path of the MongoDB server>/bin
```
Not
/test/mongo/bin bu örnekte MongoDB sunucusunun yolu olarak kullanılmıştır. Ortam değişkenlerini yapılandırırken gerçek yolu kullanın.
Örnek:
```
export PATH=$PATH:/test/mongo/bin
```
Düzenleme modundan çıkmak için Esc tuşuna basın ve dosyayı kaydedip çıkmak için :wq girin.
Yapılandırdığınız ortam değişkenlerinin etkili olması için aşağıdaki komutu çalıştırın:
```
source /etc/profile
```

Adım 2: Fiziksel yedekleme dosyasını indirme ve sıkıştırmayı açma

ApsaraDB for MongoDB konsolunda örneğin fiziksel yedekleme verilerini indirmek için aşağıdaki komutu çalıştırın. Daha fazla bilgi için bkz. Çoğaltma kümesi örneğinin fiziksel yedekleme verilerini indirme.
```
wget -c '<External download URL of the data backup file>' -O <Custom name of the downloaded data backup file>.<File name extension>
```
Not
Dosya adı uzantısının .tar.gz veya _qp.xb olduğundan emin olun.
/test/mongo/ dizininde data adlı bir dizin oluşturmak için aşağıdaki komutu çalıştırın. Ardından indirilen örnek fiziksel yedekleme dosyasını /test/mongo/data/ dizinine taşıyın.
```
mkdir -p /test/mongo/data && mv <Name of the physical backup file.Extension> /test/mongo/data
```
Fiziksel yedekleme dosyasının sıkıştırmasını açın.
- Fiziksel yedekleme dosyasının adında .tar.gz gibi bir uzantı varsa (örneğin hins20190412.tar.gz) dosyanın sıkıştırmasını açmak için aşağıdaki komutu çalıştırın:
```
cd /test/mongo/data/ && tar xzvf hins20190412.tar.gz 
```
- Fiziksel yedekleme dosyasının adında _qp.xb gibi bir uzantı varsa (örneğin hins20190412_qp.xb) dosyanın sıkıştırmasını açmak için aşağıdaki işlemleri uygulayın:
  1. Percona XtraBackup ve qpress araçlarını yükleyin. Daha fazla bilgi için Debian ve Ubuntu'ya Percona XtraBackup Yükleme adresini ziyaret edin.
  2. Fiziksel yedekleme dosyasının sıkıştırmasını açın. Bu örnekte dosya adı hins20190412_qp.xb'dir.
```
# Go to the directory where the file is located. 
cd /test/mongo/data/
# Decompress the package. 
cat hins20190412_qp.xb | xbstream -x -v
# Decompress the physical backup file. 
innobackupex --decompress --remove-original /test/mongo/data
```

Adım 3: Verileri tek düğümlü moddaki kendi yönettiğiniz MongoDB veritabanına geri yükleme

/test/mongo dizininde mongod.conf adlı bir yapılandırma dosyası oluşturmak için aşağıdaki komutu çalıştırın:
```
touch /test/mongo/mongod.conf
```

Komut satırında mongod.conf dosyasını açmak için vi /test/mongo/mongod.conf girin. Ardından düzenleme moduna girmek için i tuşuna basın.

Örneğin depolama altyapısına göre bir yapılandırma şablonu seçebilir ve seçilen yapılandırma şablonunu mongod.conf yapılandırma dosyasına kopyalayabilirsiniz.

Not

Bu dosyada tek düğümlü başlatmayı ve yetkilendirmeyi etkinleştirin.

WiredTiger

systemLog:
    destination: file
    path: /test/mongo/mongod.log
    logAppend: true
security:
    authorization: enabled
storage:
    dbPath: /test/mongo/data
    directoryPerDB: true
net:
    port: 27017
    unixDomainSocket:
        enabled: false
processManagement:
    fork: true
    pidFilePath: /test/mongo/mongod.pid

Not

ApsaraDB for MongoDB varsayılan olarak WiredTiger depolama altyapısını kullanır ve directoryPerDB seçeneği etkindir. Bu nedenle yukarıdaki yapılandırmada directoryPerDB seçeneği true olarak ayarlanmıştır.

RocksDB

systemLog:
    destination: file
    path: /test/mongo/logs/mongod.log
    logAppend: true
security:
    authorization: enabled
storage:
    dbPath: /test/mongo/data
        engine: rocksdb
net:
    port: 27017
    unixDomainSocket:
        enabled: false
processManagement:
    fork: true
    pidFilePath: /test/mongo/mongod.pid

Düzenleme modundan çıkmak için Esc tuşuna basın ve dosyayı kaydedip çıkmak için :wq girin.
MongoDB'yi başlatmak için mongod.conf yapılandırma dosyasını kullanın.
```
mongod -f /test/mongo/mongod.conf
```
MongoDB'yi başlattıktan sonra kendi yönettiğiniz MongoDB veritabanında oturum açmak ve mongo kabuğuna gitmek için aşağıdaki komutu çalıştırın:
```
mongo --host 127.0.0.1 -u <username> -p <password> --authenticationDatabase admin
```
- <username>: Kendi yönettiğiniz MongoDB veritabanında oturum açmak için kullanılan hesap. Varsayılan değer root'tur.
- <password>: Kendi yönettiğiniz MongoDB veritabanında oturum açmak için kullanılan parola.
  
  Not
  Parola özel karakterler içeriyorsa parolayı tek tırnak işaretleri (' ') içine almanız gerekir. Örnek: 'test123!@#' Aksi takdirde veritabanında oturum açamayabilirsiniz.
Geri yüklemenin başarılı olup olmadığını kontrol etmek için mongo kabuğunda MongoDB sunucusundaki tüm kullanılabilir veritabanlarını sorgulamak üzere show dbs komutunu çalıştırın.
Mongo kabuğundan çıkmak için mongo kabuğunda exit komutunu çalıştırın.

Yukarıdaki adımları tamamladıktan sonra MongoDB veritabanını tek düğümlü modda başlatabilirsiniz. Veritabanını çoğaltma kümesi modunda başlatmak için 4. Adımdaki işlemleri uygulayın.

Adım 4: Kendi yönettiğiniz MongoDB veritabanını çoğaltma kümesi modunda başlatma

Varsayılan olarak örneğin fiziksel yedekleme dosyaları onun çoğaltma kümesi yapılandırmalarını içerir. Kendi yönettiğiniz MongoDB veritabanını çoğaltma kümesi modunda başlatmak için yapılandırmaları fiziksel yedeklemelerden silmeniz gerekir. Kendi yönettiğiniz MongoDB veritabanını çoğaltma kümesi modunda başlatmak için aşağıdaki işlemleri uygulayın:

Komut satırında mongo kabuğunu kullanarak test kullanıcısı olarak veritabanında oturum açın:
```
mongo --host 127.0.0.1 -u test -p <Password of the test account> --authenticationDatabase admin
```
Not
Parola özel karakterler içeriyorsa parolayı tek tırnak işaretleri (' ') içine almanız gerekir. Örnek: 'test123!@#' Aksi takdirde veritabanında oturum açamayabilirsiniz.

Veritabanında oturum açtıktan sonra aşağıdaki işlemleri gerçekleştirmek için örnek kodda yer alan komutları çalıştırın:

Admin veritabanında geçici bir kullanıcı oluşturun ve bu kullanıcıya local veritabanında okuma ve yazma izinleri verin.
Geçici kullanıcıya geçin ve local veritabanının orijinal çoğaltma kümesi yapılandırmasını silin.
Test kullanıcısına geri dönün ve geçici kullanıcıyı ile geçici izinleri silin.

Not
Aşağıdaki kodda <Password of the test account> ifadesini test hesabınızın parolasıyla değiştirin.

use admin
db.runCommand({
    createRole: "tmprole",
    roles: [
        {
            role: "test",
            db: "admin"
        }
    ],
    privileges: [
        {
            resource: {
                db: 'local',
                collection: 'system.replset'
            },
            actions: [
                'remove'
            ]
        }
    ]
})
db.runCommand({
    createUser: "tmpuser",
    pwd: "tmppwd",
    roles: [
        'tmprole'
    ]
})
db.auth('tmpuser','tmppwd')
use local
db.system.replset.remove({})
use admin
db.auth('test','<Password of the test account>')
db.dropRole('tmprole')
db.dropUser('tmpuser')

MongoDB hizmetini kapatmak ve mongo kabuğundan çıkmak için aşağıdaki komutları çalıştırın:
```
use admin
db.shutdownServer()
exit
```
Çoğaltma kümesinde kimlik doğrulama dosyasını oluşturun.

Veritabanını çoğaltma kümesi modunda başlatmak için tüm çoğaltma kümesi düğümlerinin birbirlerini doğrulaması amacıyla bir anahtar dosyası oluşturmanız gerekir.
1. Kimlik doğrulama dosyası dizini olarak mongo dizininde keyFile klasörünü oluşturmak ve kimlik doğrulama dosyası dizininde bir anahtar dosyası oluşturmak için aşağıdaki komutu çalıştırın:
```
mkdir -p /test/mongo/keyFile && touch /test/mongo/keyFile/mongodb.key
```
2. mongodb.key dosyasını açmak için vi /test/mongo/keyFile/mongodb.key komutunu çalıştırın. Ardından düzenleme moduna girmek için i tuşuna basın. Örnek:
```
MongoDB Encrypting File
```
  Not
  Verileri şifrelemek için kullanılan anahtarın aşağıdaki sınırlamaları vardır:
  - Anahtarın uzunluğu 6 ila 1.024 karakter arasında olmalıdır.
  - Anahtar yalnızca Base64 ile kodlanmış karakterler içerebilir.
  - Anahtar eşittir işaretleri (=) içeremez.
3. Düzenleme modundan çıkmak için Esc tuşuna basın ve dosyayı kaydedip çıkmak için :wq girin.
4. Komut satırında kimlik doğrulama dosyasının izinlerini 400 olarak değiştirmek için aşağıdaki komutu çalıştırın. Bu şekilde dosyanın içeriğini yalnızca dosyanın sahibi görüntüleyebilir.
```
sudo chmod 400 /test/mongo/keyFile/mongodb.key
```
Not
Bu kimlik doğrulama dosyası tüm çoğaltma kümesi düğümleri için geçerlidir.
Çoğaltma kümesi için iki boş düğüm hazırlamak üzere aşağıdaki işlemleri uygulayın:
1. Diğer iki düğüm için yapılandırma dosyası olarak kullanılmak üzere mongod.conf dosyasının iki kopyasını oluşturmak için aşağıdaki komutu çalıştırın.
```
cp /test/mongo/mongod.conf /test/mongo/mongod1.conf && cp /test/mongo/mongod.conf /test/mongo/mongod2.conf
```
3. Diğer iki düğüm için veri dizinleri oluşturmak için aşağıdaki komutu çalıştırın:
```
mkdir -p /test/mongo/data1 && mkdir -p /test/mongo/data2
```
4. Aşağıdaki işlemleri uygulayarak her düğümün yapılandırma dosyasını değiştirin:
  - Düğümün yapılandırma dosyasını açmak ve dosyayı aşağıdaki içeriğe göre değiştirmek için vi /test/mongo/mongod.conf komutunu çalıştırın. Ardından yapılandırma dosyasını kaydedip çıkın.
```
systemLog:
    destination: file
    path: /test/mongo/mongod.log
    logAppend: true
security:
    authorization: enabled
    keyFile: /test/mongo/keyFile/mongodb.key
storage:
    dbPath: /test/mongo/data
    directoryPerDB: true
net:
    bindIp: 127.0.0.1
    port: 27017
    unixDomainSocket:
        enabled: false
processManagement:
    fork: true
    pidFilePath: /test/mongo/mongod.pid
replication:
    replSetName: "rs0"
```
  - Düğümün yapılandırma dosyasını açmak ve dosyayı aşağıdaki içeriğe göre değiştirmek için vi /test/mongo/mongod1.conf komutunu çalıştırın. Ardından yapılandırma dosyasını kaydedip çıkın.
```
systemLog:
    destination: file
    path: /test/mongo/mongod1.log
    logAppend: true
security:
    authorization: enabled
    keyFile: /test/mongo/keyFile/mongodb.key
storage:
    dbPath: /test/mongo/data1
    directoryPerDB: true
net:
    bindIp: 127.0.0.1
    port: 27018
    unixDomainSocket:
        enabled: false
processManagement:
    fork: true
    pidFilePath: /test/mongo/mongod1.pid
replication:
    replSetName: "rs0"
```
  - Düğümün yapılandırma dosyasını açmak ve dosyayı aşağıdaki içeriğe göre değiştirmek için vi /test/mongo/mongod2.conf komutunu çalıştırın. Ardından yapılandırma dosyasını kaydedip çıkın.
```
systemLog:
    destination: file
    path: /test/mongo/mongod2.log
    logAppend: true
security:
    authorization: enabled
    keyFile: /test/mongo/keyFile/mongodb.key
storage:
    dbPath: /test/mongo/data2
    directoryPerDB: true
net:
    bindIp: 127.0.0.1
    port: 27019
    unixDomainSocket:
        enabled: false
processManagement:
    fork: true
    pidFilePath: /test/mongo/mongod2.pid
replication:
    replSetName: "rs0"
```
  Yapılandırma dosyalarında aşağıdaki parametreleri değiştirebilirsiniz:
  - path içindeki systemLog.path: Geçerli düğümde MongoDB günlük dosyalarının depolandığı yol.
  - dbpath: Geçerli düğümde MongoDB veri dosyalarının depolandığı yol.
  - pidFilePath: Geçerli düğümde MongoDB işlem kimliği (PID) dosyalarının depolandığı yol.
  - keyFile: Çoğaltma kümesi için kimlik doğrulama dosyasının depolandığı yol. Çoğaltma kümesindeki tüm düğümler aynı kimlik doğrulama dosyasını kullanmalıdır.
  - bindIp: Geçerli düğümün IP adresi. Çoğaltma kümesindeki tüm düğümler aynı sunucuda dağıtıldıysa aynı IP adresini kullanabilirler.
  - port: Geçerli düğümün bağlantı noktası numarası. Çoğaltma kümesindeki tüm düğümler aynı sunucuda dağıtıldıysa farklı bağlantı noktası numaraları kullanmaları gerekir.
  - replication: Çoğaltma kümesinin yapılandırması.
  - replSetName: Çoğaltma kümesinin adı.
5. Üç düğümü başlatmak için aşağıdaki komutu çalıştırın:
```
mongod -f /test/mongo/mongod.conf && mongod -f /test/mongo/mongod1.conf && mongod -f /test/mongo/mongod2.conf
```
6. Üç düğümü başlattıktan sonra test hesabını kullanarak kendi yönettiğiniz MongoDB veritabanında oturum açın.
```
mongo --host 127.0.0.1 -u test -p <Password of the test account> --authenticationDatabase admin
```
  Not
  Parola özel karakterler içeriyorsa parolayı tek tırnak işaretleri (' ') içine almanız gerekir. Örnek: 'test123!@#' Aksi takdirde veritabanında oturum açamayabilirsiniz.
7. Mongo kabuğunda önceden oluşturduğunuz düğümleri çoğaltma kümesine eklemek ve çoğaltma kümesini başlatmak için aşağıdaki komutu çalıştırın:
```
rs.initiate( {
   _id : "rs0",
   version : 1,
   members: [
      { _id: 0, host: "127.0.0.1:27017" , priority : 1},
      { _id: 1, host: "127.0.0.1:27018" , priority : 0},
      { _id: 2, host: "127.0.0.1:27019" , priority : 0}
   ]
})
```
  Başarılı bir başlatma işlemi aşağıdaki çıktıyı döndürür:
```
> rs.initiate( {
...    _id : "rs0",
...    version : 1,
...    members: [
...       { _id: 0, host: "127.0.0.1:27017" , priority : 1},
...       { _id: 1, host: "127.0.0.1:27018" , priority : 0},
...       { _id: 2, host: "127.0.0.1:27019" , priority : 0}
...    ]
... })
{ "ok" : 1 }
rs0:SECONDARY>
```
  Not
  Bu adımda rs.initiate() komutu kullanılır. Komut hakkında daha fazla bilgi için rs.initiate() adresini ziyaret edin.
  
  Komut yürütüldükten sonra eklenen iki düğüm ile birincil düğüm arasında veriler senkronize edilir. Bu işlemin süresi yedekleme dosyasının boyutuna bağlı olarak değişir. Veriler senkronize edildikten sonra kendi yönettiğiniz MongoDB veritabanı çoğaltma kümesi modunda başlatılır.
8. Çoğaltma kümesi modundaki kendi yönettiğiniz MongoDB veritabanının başlatılıp başlatılmadığını kontrol etmek için aşağıdaki işlemleri uygulayın:
  1. Mongo kabuğundan çıkmak için exit komutunu çalıştırın.
  2. Kendi yönettiğiniz MongoDB veritabanında tekrar oturum açmak için aşağıdaki komutu çalıştırın:
```
mongo -u <username> -p <password> --authenticationDatabase admin
```
    - <username>: Kendi yönettiğiniz MongoDB veritabanında oturum açmak için kullanılan hesap. Varsayılan değer root'tur.
    - <password>: Kendi yönettiğiniz MongoDB veritabanında oturum açmak için kullanılan parola.
      
      Not
      Parola özel karakterler içeriyorsa parolayı tek tırnak işaretleri (' ') içine almanız gerekir. Örnek: 'test123!@#' Aksi takdirde veritabanında oturum açamayabilirsiniz.
  3. Kendi yönettiğiniz MongoDB veritabanının çoğaltma kümesi modunda başlatılıp başlatılmadığını kontrol edin. Mongo kabuğundaki komut satırının sol tarafında <Name of the replica set>:PRIMARY> görüntüleniyorsa kendi yönettiğiniz MongoDB veritabanı çoğaltma kümesi modunda başlatılmış demektir.

ApsaraDB for MongoDB:Fiziksel yedekleme kullanarak örnek verilerini kendi yönettiğiniz MongoDB veritabanına geri yükleme