Metin2 db conf.txt Ayarları: SQL Satırları, BIND_PORT ve ITEM_ID_RANGE

conf.txt, db çekirdeğinin klasöründe (srv1/db) duran ve yalnız db açılırken okunan ayar dosyasıdır. Satırlar ANAHTAR = DEĞER biçimindedir, boşluk içeren değerler çift tırnağa alınır. db'nin açılabilmesi için dört SQL satırı (SQL_PLAYER, SQL_ACCOUNT, SQL_COMMON, SQL_HOTBACKUP) ile CLIENT_HEART_FPS, PLAYER_ID_START ve ITEM_ID_RANGE gerekir. db'nin auth ve oyun çekirdeklerini beklediği port BIND_PORT'tur ve CONFIG dosyalarındaki DB_PORT ile aynı olmalıdır.

Aşağıdaki davranışlar db çekirdeğinin kaynak kodundan çıkarıldı. PROTO_FROM_DB ve MIRROR2DB gibi bazı satırlar incelenen kaynağa sonradan eklenmiş özelliklerdir, başka bir derlemede bulunmayabilir. Satırların kısa listesi CONFIG ayarları listesinde db başlığı altında da var.

db çekirdeği ne yapar, conf.txt ne zaman okunur?

db çekirdeği MySQL ile auth ve oyun çekirdekleri arasında durur. Açılışta eşya, canavar, beceri ve market tablolarını yükleyip çekirdeklere dağıtır; oyuncu ve eşya verisini önbellekte tutup aralıklarla MySQL'e yazar; çekirdeklere birbirlerinin adresini ve haritalarını bildirir. Bu yüzden sunucuda ilk açılan çekirdek db'dir. Veritabanlarının ve tabloların ne tuttuğu Metin2 veritabanları yazısında.

conf.txt yalnız açılışta okunur; çalışan db'de dosyayı değiştirmek hiçbir şeyi etkilemez. db çevrimiçi oyuncuların verisini önbellekte tuttuğu için değişiklikten sonra sunucunun tamamını stop.py ile durdurup yeniden açmak en güvenli yoldur. Düzgün kapanışta db önbellekteki her şeyi MySQL'e yazar.

Yazım kuralları: CONFIG'ten farkları

conf.txt'nin okuyucusu game çekirdeğinin CONFIG okuyucusundan tamamen farklıdır. İki dosyayı birbirine benzeterek yazmak en sık hata kaynağıdır.

Okuyucu dosyayı satır satır değil, kelime kelime okur: önce anahtarı, sonra = ile başlayan kelimeyi, sonra değeri arar. Bunun beklenmedik bir sonucu var. = unutulursa okuyucu, bir sonraki = işaretine kadar gelen her kelimeyi atlar ve o satırın değerini eksik satırın anahtarına yazar:

CLIENT_HEART_FPS 25
PLAYER_ID_START = 100

Bu iki satırda CLIENT_HEART_FPS 100 olur, PLAYER_ID_START hiç yazılmamış sayılır ve db "PLAYER_ID_START not configured" diyerek kapanır. Hata iletisi bu yüzden asıl bozuk satırı değil, ondan sonrakini gösterebilir. ANAHTAR=DEĞER biçiminde bitişik yazmak da aynı kaymaya yol açar, çünkü bitişik yazı tek bir kelime sayılır.

// yalnız ayrı bir kelime olduğunda yorum açar: // not çalışır, //not ise anahtar sanılır ve sonraki satırı kaydırır. # işareti yorum değildir; #BIND_PORT = 30000 yazılırsa db #BIND_PORT adında tanımadığı bir anahtar okur, gerçek BIND_PORT tanımsız kalır. Aynı anahtarı iki kez yazarsan ilki geçerli olur, sonradan eklediğin satır sessizce yok sayılır.

Zorunlu satırlar ve açılış hataları

İletilerin bir kısmı ekrana, bir kısmı db klasöründeki syserr dosyasına yazılır; açılmayan db'de ikisine de bakmak gerekir. BIND_PORT başka bir program tarafından kullanılıyorsa db soketi açamaz ve "socket" ile başlayan bir hata verir.

SQL satırları nasıl yazılır?

Dört SQL satırı db'nin bağlanacağı dört veritabanını tanımlar: SQL_PLAYER player'ı, SQL_ACCOUNT account'u, SQL_COMMON common'ı, SQL_HOTBACKUP hotbackup'ı gösterir. Değer çift tırnak içinde beş parçadır:

SQL_PLAYER = "localhost player KULLANICI_ADI PAROLA_BURAYA 3306"

• Sıra sunucu, veritabanı adı, kullanıcı, parola, porttur. Oyun çekirdeğinin CONFIG'indeki PLAYER_SQL satırında veritabanı adı dördüncü sıradadır; iki dosya arasında satır kopyalanırken en sık yapılan hata budur.
• Port mutlaka yazılmalıdır. Port yazılmazsa kod o alanı doldurmaz ve bağlantı belirsiz bir port değeriyle denenir.
• Parolada boşluk ve çift tırnak bulunamaz; parçalar boşlukla ayrılır.
• SQL_HOTBACKUP kullanılmasa da zorunludur ve hotbackup veritabanının gerçekten var olması gerekir.

Bir bağlantı kurulamazsa db 5 saniye arayla 6 kez dener, yani yaklaşık 30 saniye bekler. Sonra ekrana yine de "Success PLAYER" gibi bir satır yazar ve devam eder; bu satır yanıltıcıdır. Kodda bağlantı hatası o ana kadar kurulmuş bütün MySQL bağlantılarını da siler, bu yüzden tek bir hatalı satır db'nin açılışın ilerleyen adımında çökmesine yol açar. Asıl ipucu syslog'daki "failed, retrying in 5 seconds" satırlarıdır.

BIND_PORT ve BIND_IP

BIND_PORT, db'nin auth ve oyun çekirdeklerini beklediği porttur. İncelenen kaynakta satır yoksa 30000 kullanılır. Bütün CONFIG'lerdeki DB_PORT bu değerle aynı olmalıdır.

BIND_IP, db portunun hangi adreste dinleneceğidir. Yazılmazsa db bütün ağ arayüzlerinde dinler. Bütün çekirdekler aynı makinedeyse BIND_IP = 127.0.0.1 yazmak db portunu dışarıdan tamamen erişilmez yapar; bu durumda CONFIG'lerdeki DB_ADDR de 127.0.0.1 olmalıdır.

İncelenen kaynakta ayrıca bir adres süzgeci var: db portu yalnız 127.0.0.1, 192.168.x ve 10.x adreslerinden gelen bağlantıyı kabul eder, ötekileri syslog'a "BLOCK CONNECTION FROM" yazıp reddeder. DB_ADDR'a makinenin genel IP'si yazılırsa bağlantı o adresten geleceği için reddedilir. Port planının tamamı kanal ve portlar yazısında.

ITEM_ID_RANGE ne işe yarar?

Her eşyanın veritabanında benzersiz bir kimliği vardır. ITEM_ID_RANGE, db çekirdeğinin kendi oluşturduğu eşyalara vereceği kimlik aralığının başlangıcı ve sonudur. İncelenen kaynakta db'nin kendisinin eşya ürettiği tek yer item_award tablosudur: web sitesinden ya da yönetim panelinden gönderilen ve oyuncu depoyu ya da Nesne Market deposunu açınca yerleşen eşyalar.

ITEM_ID_RANGE = 100000000 200000000

• Değer tırnaksız yazılır. Okuyucu bu satırı ötekilerden farklı olarak = işaretinden sonra satır sonuna kadar okur; satıra iki sayıdan başka bir şey ekleme.
• db açılırken aralıktaki en büyük kimliği bulur ve oradan devam eder. Aralığın sonuna 10.000'den az boş kimlik kaldıysa "Can not build ITEM_ID_RANGE" hatasıyla açılmaz. Bu durumda içinde hiç eşya bulunmayan yeni bir aralık yazılır.
• Oyun çekirdekleri bu aralığı kullanmaz. Her oyun çekirdeği açılışta db'den 10 milyonluk ayrı bir kimlik bloğu alır; bloklar 10.000.001'den başlayıp 4.280.000.000'e kadar dizilir ve tamamen db aralığının içine düşen bloklar dağıtılmaz. Bloklar tükenirse db'nin syserr'ine "NO MORE ITEM ID RANGE" düşer.

Önbellek ve kayıt süreleri

db, oyuncu ve eşya verisindeki değişiklikleri hemen değil, belirli aralıklarla MySQL'e yazar.

Üç süre de kodda en çok 1.800 saniyeyle sınırlıdır. Kısa süre MySQL'e daha sık yazar ama ani bir çökmede daha az veri kaybettirir; uzun süre yükü azaltır, kill -9 gibi düzensiz bir kapanışta kaybı büyütür. Oyuncu çıktıktan sonra verisinin önbellekte 10 dakika daha tutulması ise kodda sabittir, conf.txt'den değişmez. Sunucu açıkken tabloları elle düzenlemenin neden riskli olduğu veritabanları yazısında anlatılıyor.

CLIENT_HEART_FPS, db çekirdeğinin döngü hızıdır; örnek dosyada 25'tir. db'nin zamanlanmış işleri saniyeye göre hesaplandığı için bu değer kayıt aralıklarını değiştirmez.

PROTO_FROM_DB ve MIRROR2DB

Bu iki satır incelenen kaynağa eklenmiş bir özelliktir ve eşya ile canavar tablolarının nereden okunacağını belirler:

Örnek dosyada PROTO_FROM_DB = 0 ve MIRROR2DB = 1 yazılıdır; bu durumda MySQL'deki tablo yalnız bir yansıdır ve orada yapılan değişiklik bir sonraki açılışta ezilir. Proto dosyalarının sütunları item_proto yazısında, dönüştürme araçları proto araçları yazısında.

Karakter silme sınırları

PLAYER_DELETE_LEVEL_LIMIT, silinemeyecek en düşük seviyedir: örnek dosyadaki 70 değeriyle 70. seviye ve üstü karakterler silinemez, 69 ve altı silinebilir. Satır yoksa db syserr'e bir uyarı yazar ve sınırı 251'e çeker; incelenen kaynakta en yüksek seviye 250 olduğu için bu, her karakterin silinebilmesi demektir. PLAYER_DELETE_LEVEL_LIMIT_LOWER ise alt sınırdır: varsayılan 0, örneğin 15 yazılırsa 15. seviyenin altındaki karakterler silinemez.

Diğer satırlar

Eski rehberlerde görülen DB_SLEEP_MSEC ve HASH_PLAYER_LIFE_SEC satırlarını bu kaynak hiç okumaz; paketin kendi üretici betiğinde de yoruma alınmışlardır.

Örnek conf.txt

İncelenen paketteki dosyanın düzeni aşağıdadır. Bağlantı bilgileri yer tutucuyla değiştirildi; son satırdaki BIND_IP örnekte yoktur, bütün çekirdekler aynı makinedeyse eklenmesi önerilir.

SQL_ACCOUNT = "localhost account KULLANICI_ADI PAROLA_BURAYA 3306"
SQL_COMMON = "localhost common KULLANICI_ADI PAROLA_BURAYA 3306"
SQL_PLAYER = "localhost player KULLANICI_ADI PAROLA_BURAYA 3306"
SQL_HOTBACKUP = "localhost hotbackup KULLANICI_ADI PAROLA_BURAYA 3306"
TABLE_POSTFIX = ""
CLIENT_HEART_FPS = 25
PLAYER_ID_START = 100
PLAYER_DELETE_LEVEL_LIMIT = 70
ITEM_ID_RANGE = 100000000 200000000
DISABLE_HOTBACKUP = 1
LOCALE = latin1
PROTO_FROM_DB = 0
MIRROR2DB = 1
BIND_PORT = 30000
BIND_IP = 127.0.0.1

Paket bu dosyayı gen_settings.py'deki ayarlardan gen.py ile üretir; gen.py her çalıştığında conf.txt'yi baştan yazar ve elle yaptığın değişiklikler kaybolur. Kalıcı değişiklikleri gen_settings.py'ye de işle. Üretim adımları server kurulumu yazısında.

Güvenlik için yapılması gerekenler

• conf.txt MySQL parolalarını düz metin tutar. Dosyanın sahibi sunucuyu çalıştıran kullanıcı olmalı, başka kullanıcılar okuyamamalı (chmod 600 conf.txt).
• SQL satırlarındaki kullanıcı yalnız localhost'tan bağlanabilen ve yalnız gereken yetkilere sahip bir MySQL kullanıcısı olmalı; root kullanılmamalı.
• BIND_IP ile db portunu 127.0.0.1'e bağla, güvenlik duvarında da kapalı tut. Adres süzgeci parola denetimi değildir.
• Örnek paketlerle gelen varsayılan parolaları, sunucuyu ilk açmadan önce değiştir.