Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

İlk Çalıştırma

MenzeletDB’yi ilk kez çalıştırmanın iki yolu vardır: Kurulum Sihirbazı (önerilen) veya Docker.

Kurulum Sihirbazı ile (Önerilen)

Kurulum sihirbazını (menzelet-setup) kullandıysanız, tüm yapılandırma ve bootstrap işlemleri otomatik olarak tamamlanmıştır. Sunucuyu doğrudan başlatabilirsiniz:

Windows:

"C:\Program Files\MenzeletDB\menzelet-server.exe"

Linux:

/opt/menzelet/menzelet-server

Veya servis olarak kurulduysa:

Linux (systemd):

sudo systemctl start menzelet
sudo systemctl status menzelet

Windows (servis):

Start-Service MenzeletDB
Get-Service MenzeletDB

Kurulum sihirbazı hakkında detaylı bilgi için bkz: Kurulum


Konsol ile Bootstrap

Kurulum sihirbazı kullanmadan, sunucuyu doğrudan çalıştırarak da ilk kurulumu yapabilirsiniz.

Windows:

"C:\Program Files\MenzeletDB\menzelet-server.exe" --config "C:\Program Files\MenzeletDB\menzelet.toml"

Linux:

/opt/menzelet/menzelet-server --config /etc/menzelet/menzelet.toml

Bootstrap (İlk Kurulum)

Sunucu ilk kez başlatıldığında data/master/ dizini otomatik oluşturulur. Bu sırada konsoldan sa (süper kullanıcı) şifresi istenir:

menzelet başlıyor...
Konfigürasyon yüklendi: menzelet.toml
İlk kurulum: sa şifresi belirleniyor...
sa şifresi: ________
sa şifresi (tekrar): ________
master DB oluşturuldu.
TCP sunucu başladı: 127.0.0.1:4600

Önemli: sa şifresini güvenli bir yerde saklayın. Bu şifre tek yönlü hash olarak saklanır ve geri alınamaz.

Bootstrap Sırasında Neler Olur?

  1. data/ kök dizini kontrol edilir, yoksa oluşturulur
  2. data/master/ klasörü oluşturulur
  3. Konsoldan sa şifresi iki kez alınır (doğrulama)
  4. 16-byte rastgele salt üretilir
  5. Şifre hash’lenerek güvenli biçimde saklanır
  6. Sistem Parquet dosyaları seed verileriyle oluşturulur:
Dosyaİçerik
mnz_users.parquetsa kullanıcısı (hash + salt)
mnz_roles.parquet4 yerleşik rol
mnz_user_roles.parquetsamnz_sys_admin eşlemesi
mnz_role_permissions.parquetRol-permission eşlemeleri
mnz_tables.parquetTablo katalog meta verileri (boş)

Normal Başlatma

İlk kurulumdan sonraki her başlatmada:

  1. data/master/ dizini tespit edilir
  2. Sistem tabloları kaydedilir
  3. Katalog meta verileri yüklenir (mnz_tables.parquet + catalog.delta)
  4. Kullanıcı veritabanları taranır ve tabloları kaydedilir
  5. WAL dosyaları kontrol edilir; varsa kurtarma (replay) yapılır
  6. Bloom filter dosyaları yüklenir
  7. Hiyerarşik ad alanı oluşturulur
  8. Bağlantı havuzu ön-ısınma (warm_up) yapılır
  9. TCP sunucu başlatılır
TCP sunucu başladı: 127.0.0.1:4600

Docker ile İlk Çalıştırma

Docker kullanılırken sa şifresi ortam değişkeniyle belirlenir:

docker run -d \
  --name menzelet \
  -p 4600:4600 \
  -e MENZELET_SA_PASSWORD=güçlüŞifre123 \
  atifdag/menzelet:latest

Not: MENZELET_SA_PASSWORD ortam değişkeni yalnızca ilk kurulumda (bootstrap) kullanılır. Sonraki başlatmalarda etkisizdir.