UIM Simulator kurulumu

• Çalışır durumda Docker Engine ve Docker Compose v2.20 veya üzeri.
• Docker’a erişebilen bir kullanıcı.
• En az 2 CPU çekirdeği, 4 GB kullanılabilir RAM ve 5 GB boş disk.
• Docker Hub’dan imaj indirebilmek için internet erişimi.
• Başka bir uygulamanın kullanmadığı TCP portu; varsayılan port 3035.

docker --version
docker compose version
docker info

Docker eksikse Linux dağıtımınıza uygun Docker Engine ve Compose eklentisini kurun. docker info hata veriyorsa Docker servisini ve kullanıcı erişim yetkisini düzeltmeden sonraki adıma geçmeyin.

SSH oturumunda aşağıdaki komutla arşivi kullanıcınızın ana dizinine indirin. İsterseniz aynı indirme bağlantısını kullanarak paketi bilgisayarınıza indirip SCP veya SFTP ile sunucuya aktarabilirsiniz.

cd ~
curl -fL --retry 3 -o uim-simulator-0.1.1-online.tar.gz \
  https://ocosify.com/donloads/uim-simulator-0.1.1-online.tar.gz

Paketle birlikte uim-simulator-0.1.1-online.tar.gz.sha256 dosyasını aldıysanız onu da aynı dizine aktarın ve aşağıdaki kontrolü çalıştırın. Sonuç OK olmalıdır. Kurulum ayrıca paketin iç dosyalarının checksum değerlerini otomatik doğrular.

cd ~
sha256sum -c uim-simulator-0.1.1-online.tar.gz.sha256

Yeni kurulum için boş bir klasör kullanın. Mevcut kurulumun üzerine arşivi açmayın. Aşağıdaki örnek, arşivin ana dizininizde olduğunu varsayar.

mkdir -p ~/uim-simulator
tar -xzf ~/uim-simulator-0.1.1-online.tar.gz -C ~/uim-simulator --strip-components=1
cd ~/uim-simulator
chmod +x uimctl

--strip-components=1, arşivdeki dış klasör seviyesini kaldırır. Böylece uimctl ve compose.yaml doğrudan ~/uim-simulator içinde olur. Bundan sonraki ./uimctl komutlarını bu klasörde çalıştırın.

./uimctl init

• .env.appliance dosyası oluşturulur.
• .uim-secrets/ altında veritabanı, oturum, admin ve viewer sırları üretilir.
• İlk admin kullanıcı adı ve parolası ekranda gösterilir.

nano .env.appliance

UIM_BIND_ADDRESS=127.0.0.1

Varsayılan değer. Yalnızca sunucunun kendisinden erişilebilir; aynı sunucudaki HTTPS reverse proxy için uygundur.

UIM_BIND_ADDRESS=0.0.0.0

Tüm IPv4 arayüzlerinden bağlantı kabul eder. Güvenilen ağdan doğrudan erişim için kullanın. Tarayıcıda 0.0.0.0 yerine gerçek SUNUCU_IP adresini yazın.

UIM_PORT=3035

Sunucuda yayınlanan HTTP portu. Doluysa örneğin 4035 yapabilirsiniz.

UIM_COOKIE_SECURE=false

Doğrudan HTTP erişiminde false bırakın. HTTPS reverse proxy arkasında true yapın. Bu ayar tek başına HTTPS veya sertifika kurmaz.

UIM_ADMIN_USER=admin

Yönetici kullanıcı adı.

UIM_VIEWER_USER=viewer

Salt okunur kullanıcı adı. Parolası .uim-secrets/viewer_password dosyasındadır.

Güvenilen ağdan sunucu IP’siyle doğrudan erişim için örnek ayarlar:

UIM_BIND_ADDRESS=0.0.0.0
UIM_PORT=3035
UIM_COOKIE_SECURE=false

UIM_SIMULATOR_IMAGE, UIM_MYSQL_IMAGE, UIM_BUILD_SHA ve sürüm değerlerini pakette geldiği gibi bırakın. Çevrimiçi paket uygulama imajını sabit digest ile seçer; bu sürümün veritabanı imajı mysql:8.4.6’dır.

İlk kurulumdan sonra COMPOSE_PROJECT_NAME, veritabanı adı/kullanıcısı ve secret dosyalarını gelişigüzel değiştirmeyin; bunlar mevcut veriye bağlıdır. Özelleştirmeleri .env.appliance içinde yapın. Checksum ile doğrulanan compose.yaml, uimctl ve paket şablonlarını düzenlemeyin.

./uimctl doctor
./uimctl install

1. Paket bütünlüğü ve Docker ayarları kontrol edilir.
2. Uygulama ve MySQL imajları indirilir.
3. Kalıcı MySQL volume’u oluşturulur ve veritabanı başlatılır.
4. Bekleyen SQL migration’ları uygulanır; boş katalog başlangıç verisiyle doldurulur.
5. Simülatör başlatılır ve hazır olması beklenir.

İlk kurulum, indirme hızına göre birkaç dakika sürebilir. Kaynak koddan derleme yapılmaz. Bu sürümde simülatör için lisans aktivasyonu veya lisans sunucusuna bağlantı gerekmez.

./uimctl status
curl -fsS http://127.0.0.1:3035/api/health/ready

Portu değiştirdiyseniz curl komutundaki portu da değiştirin. Uygulama ve MySQL healthy görünmeli; health yanıtında status: ready olmalıdır.

UIM_BIND_ADDRESS=0.0.0.0 ayarlandıysa ve ağ erişimi açıksa uzak bilgisayarınızdaki tarayıcıdan şu adrese gidin:

http://SUNUCU_IP:3035

Kullanıcı adı admin’dir; UIM_ADMIN_USER değerini değiştirdiyseniz yeni adı kullanın. Parola, init sırasında oluşturulan paroladır. Tekrar görmek için sunucuda çalıştırın:

cd ~/uim-simulator
cat .uim-secrets/admin_password

./uimctl status

Konteynerlerin durumunu gösterir.

./uimctl logs

Uygulama loglarını izler. Ctrl+C yalnızca log izlemeyi sonlandırır.

./uimctl stop

Konteynerleri durdurur/kaldırır; veritabanı volume’unu korur.

./uimctl start

Mevcut yerel imajlarla yeniden başlatır ve migration kontrolü yapar.

./uimctl restart

Uygulamayı migration kontrolüyle yeniden başlatır. .env.appliance erişim/port değişikliklerinden sonra kullanılabilir.

./uimctl backup

backups/ altında tarihli bir SQL yedeği oluşturur.

Yedekten geri yükleme mevcut veritabanının yerini alır. Komut, RESTORE yazarak onay ister; uygulamayı durdurur, mevcut verinin güvenlik yedeğini alır ve belirtilen yedeği yükler.

./uimctl restore /tam/yol/yedek.sql

Yeni sürüme geçiş için paket içindeki UPGRADING.md belgesini izleyin. ./uimctl upgrade mevcut ayarda seçilen imajı kullanır; kendi başına yeni sürüm seçmez. MySQL ana sürümünü yalnızca imaj etiketini değiştirerek yükseltmeyin.

Önce genel kontrolleri çalıştırın:

./uimctl doctor
./uimctl status
./uimctl logs

Veritabanı loglarını görmek için:

docker compose --env-file .env.appliance -f compose.yaml logs --tail=100 mysql

Migration geçici bir konteynerde çalışır. Migration hatası varsa kurulum komutunun terminal çıktısını inceleyin. Hatayı çözmeden uygulamayı elle başlatmayın.

Docker erişilemiyor

Docker servisini ve kullanıcı yetkilerini kontrol edin.

İmaj indirilemiyor

İnternet, DNS, proxy ve Docker Hub erişimini kontrol edin.

Port kullanımda

UIM_PORT değerini boş bir portla değiştirip tekrar başlatın.

Sunucuda açılıyor, uzaktan açılmıyor

Binding, sunucu IP’si, firewall ve varsa bulut güvenlik grubunu kontrol edin.

HTTP girişinde oturum korunmuyor

UIM_COOKIE_SECURE=false olduğundan emin olun. true değeri HTTPS erişimi içindir.

Ek bilgiler için paketteki INSTALL.md, UPGRADING.md, SECURITY.md ve CHANGELOG.md belgelerine bakın.