İ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?
data/kök dizini kontrol edilir, yoksa oluşturulurdata/master/klasörü oluşturulur- Konsoldan
saşifresi iki kez alınır (doğrulama) - 16-byte rastgele salt üretilir
- Şifre hash’lenerek güvenli biçimde saklanır
- Sistem Parquet dosyaları seed verileriyle oluşturulur:
| Dosya | İçerik |
|---|---|
mnz_users.parquet | sa kullanıcısı (hash + salt) |
mnz_roles.parquet | 4 yerleşik rol |
mnz_user_roles.parquet | sa → mnz_sys_admin eşlemesi |
mnz_role_permissions.parquet | Rol-permission eşlemeleri |
mnz_tables.parquet | Tablo katalog meta verileri (boş) |
Normal Başlatma
İlk kurulumdan sonraki her başlatmada:
data/master/dizini tespit edilir- Sistem tabloları kaydedilir
- Katalog meta verileri yüklenir (
mnz_tables.parquet+catalog.delta) - Kullanıcı veritabanları taranır ve tabloları kaydedilir
- WAL dosyaları kontrol edilir; varsa kurtarma (replay) yapılır
- Bloom filter dosyaları yüklenir
- Hiyerarşik ad alanı oluşturulur
- Bağlantı havuzu ön-ısınma (warm_up) yapılır
- 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_PASSWORDortam değişkeni yalnızca ilk kurulumda (bootstrap) kullanılır. Sonraki başlatmalarda etkisizdir.