Wiki

Sorun giderme

Sunucu tarafında ve kullanıcı tarafında yaygın sorunların çözümleri: takılan hizmet, reddedilen etkinleştirme kodu, PostgreSQL, TLS, istemci ve Unreal editöründen gelen mesajlar.

Hizmet başlamıyor

Linux: systemctl start başarısız oluyor

sudo journalctl -u uversion-server -n 100 --no-pager

Sık karşılaşılan nedenler:

PostgreSQL çalışmıyor: sudo systemctl status postgresql
Veritabanı parolası kayboldu: postinst, yapılandırmayı --reconfigure ile yeniden oluşturur (sudo dpkg-reconfigure uversion-server)
8443 bağlantı noktası kullanımda: aşağıdaki ilgili bölüme bakın

Windows: hata 1053 veya 1067

Hizmet başlıyor ve ardından duruyor. Olay Görüntüleyici'yi kontrol edin:

Get-EventLog -LogName Application -Source uVersionServer -Newest 50

Sık karşılaşılan nedenler:

CONFIG_PATH ortam değişkeni eksik: normalde yükleyici tarafından HKLM\SYSTEM\CurrentControlSet\Services\uVersionServer\Environment içinde ayarlanır
PostgreSQL çalışmıyor: Get-Service postgresql*

Etkinleştirme kodu reddediliyor

Kodun başka bir makinede kullanılmadığından emin olun (her kod, ilk kurulumun server-ID'sine bağlıdır). Hesap alanınızdan yeni bir kod isteyin.
licence.uversion.io adresine bağlantıyı kontrol edin: curl -I https://licence.uversion.io/api/v1/health
Kaldırdıktan sonra bir kodu yeni bir makinede yeniden kullanmak istiyorsanız, önceki server-ID'yi serbest bırakmak için destek ekibiyle iletişime geçin.

PostgreSQL erişilemiyor

uVersion hizmeti veritabanına bağlanamıyor. Önce uVersion'dan bağımsız olarak veritabanının kendisini test edin.

Linux'ta:

sudo -u postgres psql -c "SELECT 1;"

Windows'ta:

& "C:\Program Files\PostgreSQL\16\bin\psql.exe" -U postgres -h 127.0.0.1 -c "SELECT 1;"

PostgreSQL yanıt veriyor ancak süper kullanıcı parolası kaybolduysa, uVersion yükleyici (Linux'ta postinst ile Windows'ta install.ps1) PostgreSQL'i otomatik olarak trust moduna geri alabilir, parolayı sıfırlayabilir ve ardından özgün yapılandırmayı geri yükleyebilir. Yeniden çalıştırın.

Linux'ta:

sudo dpkg-reconfigure uversion-server

Windows'ta: normal kurulum komutu yeterlidir, kaydedilen parola eksik veya reddedilir edilmez sıfırlama kendiliğinden tetiklenir.

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

-Reconfigure parametresi yalnızca zaten var olan bir config.toml dosyasını ek olarak yeniden yazmaya yarar ve komutun uzun biçimini gerektirir: yukarıdaki kısa biçim betiğe hiçbir parametre geçirmez. Windows'a kurma bölümüne bakın.

8443 bağlantı noktası zaten kullanımda

uVersion, varsayılan olarak 8443 üzerinde HTTPS dinler.

8080'e HTTP geri dönüşü yoktur: iki mod birbirini dışlar Sunucu ya tls.https_port (varsayılan 8443) üzerinde HTTPS, ya da server.port üzerinde düz HTTP dinler, asla ikisini birden değil. Düz HTTP yalnızca TLS açıkça devre dışı bırakıldıysa ([tls] disabled = true) vardır ve bu durumda 8443 artık hiç dinlemez. Sonuç olarak: «8443'te hiçbir şey dinlemiyor» ifadesi «8080'e geri döndü» anlamına gelmez, «TLS devre dışı» veya «sunucu başlamadı» anlamına gelir. Ve normal bir kurulumda 8080'in kullanımda olması uVersion ile ilgisizdir.

Bağlantı noktasını hangi işlemin işgal ettiğini öğrenmek için, Linux'ta:

sudo ss -tlnp | grep 8443

Windows'ta, iki adımda: sahip işlem, ardından adı.

Get-NetTCPConnection -LocalPort 8443 | Select-Object OwningProcess, State
Get-Process -Id <PID>

TLS bağlantı noktasını değiştirmek için config.toml dosyasını düzenleyin:

[tls]
https_port = 9443

Ardından hizmeti yeniden başlatın.

İstemci TLS bağlantısını reddediyor

uVersion, istemci tarafında TOFU ile kilitlenmiş, kendinden imzalı bir sertifika kullanır (bkz. TLS parmak izi). En sık karşılaşılan nedenler:

İlk bağlantı onaylanmadı: masaüstü istemcisi, SHA-256 parmak izini içeren Verify server identity penceresini gösterir. Bunu yöneticinin size bildirdiği değerle karşılaştırın, ardından Trust this server öğesine tıklayın. CLI'de eşdeğer komut uversion trust <url> şeklindedir: bu etkileşimlidir, sunucunun duyurduğu parmak izini gösterir ve klavyeden onayınızı bekler. Örneğin bir betikte bu onayı atlamak için --yes ekleyin.
Parmak izi değişti (kırmızı uyarı): sunucu yeniden kuruldu ve sertifikasını yeniden oluşturdu. Yöneticiyle başka bir kanaldan onaylayın, ardından:
- Masaüstü: kırmızı iletişim kutusunda Trust new fingerprint öğesine tıklayın
- CLI: uversion mistrust <url> ardından uversion login <url>
Sunucu HTTPS sunmuyor: gerçekten 8443'te dinlediğini kontrol edin. Linux'ta:
```
ss -tlnp | grep 8443
```
Windows'ta:
```
Get-NetTCPConnection -LocalPort 8443 -State Listen
```
Hiçbir şey dinlemiyorsa, config.toml içinde [tls] disabled = false olduğunu kontrol edin (varsayılan budur). Hatırlatma: TLS devre dışı bırakıldığında, sunucu düz HTTP'ye geçer ve 8443 artık hiç dinlemez, çift dinleme yoktur.

Parmak izini sunucu tarafında yeniden görüntüleme, Linux'ta:

sudo cat /var/lib/uversion/data/tls/fingerprint

Windows'ta:

Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Kullanıcı tarafı: istemci ve editör mesajları

Yukarıdaki bölümler sunucuyla ilgilidir. İşte kullanıcıların karşılaştığı engeller, göründüğü haliyle tam mesaj ve ne yapılması gerektiğiyle birlikte.

Depo oluşturamıyorum

Admin role required

Depo oluşturma, sunucunun süper yöneticisine ayrılmıştır. project_admin rolü yeterli değildir: kendisine emanet edilen projeleri yönetir, onları oluşturmaz. Süper yöneticinizden depoyu oluşturmasını ve ardından sizi onun yöneticisi olarak atamasını isteyin.

Yerel bir klasörü açmak başarısız oluyor

Not a uVersion repository

Seçilen klasör bir .uversion/config.toml içermiyor. Muhtemelen üst klasörü veya bir alt klasörü belirttiniz. .uversion/ klasörünü içeren workspace kökünü hedefleyin.

Mevcut bir klasörden depo oluşturmak başarısız oluyor

This folder is already a uVersion repository - use "Open Local Repository" instead.

Klasör zaten bir workspace. Yeni bir tane oluşturmaya değil, onu yeniden açmaya çalışıyorsunuz: Open Local Repository kullanın.

İstemci bir workspace açmayı reddediyor

This workspace belongs to '<owner>'. Clone your own copy instead.

Bu klasör, adı .uversion/config.toml içinde kayıtlı olan başka bir hesap tarafından klonlandı. Bu, bir workspace'i bir makineden diğerine kopyaladığınızda veya istemcide hesap değiştirdiğinizde olur. Ret kasıtlıdır: başka bir kimlik altında çalışmak, yanlış kişiye atfedilen kilitler ve commit'ler üretir. Kendi kopyanızı klonlayın. Gerçekten sizin klasörünüzse ancak diğer hesap da sizinse, hesap seçicide ona geçin.

Unreal Engine yolu reddediliyor

Invalid Unreal Engine path: '...' is not a recognizable engine install

İstemci, hem Engine/Build/BatchFiles hem de Engine/Binaries içeren bir Unreal kurulumunun kökünü bekler. Örneğin C:\Program Files\Epic Games\UE_5.6, Engine alt klasörü değil, proje klasörünüz değil, bir kısayol da değil.

Bir Unreal eylemi başlamayı reddediyor

Unreal Engine path not configured. Please set it first.

Otomatik algılama hiçbir şey bulamadı. Yolu, Unreal çubuğundaki " … " menüsünden, Set Engine Path... girdisinden ayarlayın. Başka bir giriş noktası yoktur: çubuğun kendisinde ne giriş alanı ne de Browse düğmesi vardır.

Unreal çubuğu tamamen yoksa, bu motor yolu değildir: istemci .uproject dosyasını bulamadı. Onu yalnızca workspace kökünün altında üç seviye derinliğe kadar arar, ötesinde mesaj vermeden kaybolur. Projeyi köke daha yakın taşıyın.

Unreal kod gönderimimi reddediyor

Code files must be submitted from the uVersion desktop client

Eklenti .cpp, .h, .hpp, .c ve .cs dosyalarının checkin'ini reddeder: masaüstü istemci göndermeden önce derler ve editör ikili dosyalarını yayımlar. Kodunuzu istemciden gönderin.

You have code files checked out (...): submit your code from the uVersion desktop client first

Kod yazmayan kişileri bile etkileyen çok daha kafa karıştırıcı bir çeşidi: sizin tarafınızdan kilitlenmiş tek bir kod dosyası bile içerik gönderimlerinizi de engeller, o dosya gönderime dahil olmasa bile. Masaüstü istemcinin Pending sekmesini, Your locks bölümünü açın ve orada kalan kod dosyaları için bir Checkin veya Revert yapın. Unreal Engine eklentisi bölümüne bakın.

Unreal sunucuyu görmüyor

Editör, masaüstü istemcisini başlatmayı isteyen bir bildirim gösterir. Bu beklenendir: bir uVersion sunucusu varsayılan olarak kendinden imzalıdır ve Unreal, kendinden imzalı bir sertifikayı doğrulayamaz. Revision Control Login penceresinin oturum açma formu bu engeli aşamaz, doldurmak işe yaramaz. Masaüstü istemcisini başlatın, workspace'in sahibi olan hesapla oturum açın; eklenti onun üzerinden geçecektir.

Dosya kilitleme başarısız oluyor

Failed to acquire locks for {n} file(s). Another user may have them checked out.

Başka biri bu kilitleri elinde tutuyor. Pending sekmesi, Other Users' Locks bölümü, kimin tuttuğunu söyler ve her satır için bir Request Release düğmesi sunar. Yararlı hatırlatma: bir kilit asla süresi dolmaz, kimse yalnızca zamanın geçmesiyle onu serbest bırakmaz. Bir yönetici kilit açmayı zorlayabilir ve bu işlem denetim kaydına işlenir.

Komut satırı klonu klasörü reddediyor

Directory '...' already exists and is not empty

uversion clone, boş veya var olmayan bir hedef klasör gerektirir. Onu boşaltın, silin veya başka bir yol hedefleyin. Seçtiğiniz klasörün üst klasör olduğu masaüstü istemciyle karıştırmayın: içinde workspace adında bir alt klasör oluşturur.

Oturum süresi doldu

İstemci önce belirteci sessizce yenilemeye çalışır. Başaramazsa, bir afişle oturum açma sayfasına döner. Yalnızca parolanızı yeniden girin. Bu sürekli tekrarlanıyorsa, genellikle hesabın sunucu tarafında devre dışı bırakıldığı, ya da açık bir çıkışın tüm istemcilerinizin belirteçlerini iptal ettiği anlamına gelir.

Tam sıfırlama

Temiz bir kurulumla yeniden başlamak için Ubuntu/Debian kaldırma veya Windows kaldırma sayfalarına bakın.