İlk açılış ve kurulum sihirbazı
On bir adımlı, lisans öncelikli sihirbazı yürütün, donanım ön kontrolünden servisleri seçin ve ürünün kilidini açın.
- Sürüm: 0.4
- Rol: admin_user
- Tür: görev
Yeni içe aktarılmış bir cihazın hiçbir hesabı yoktur ve hiçbir şey sunmaz: sihirbaz bitene kadar her
yol SETUP_REQUIRED ile 423 yanıtı verir. Tarayıcıda on bir adım yürür, yerel yöneticiyi
oluşturur, yerleşik denemeyi kabul eder veya lisans yüklersiniz; ardından bu makinenin hangi hak
kazanılmış servisleri kuracağını seçersiniz. Tamamlama ürünün kilidini açar ve sonraki değişiklikleri
olağan Ayarlar ve Sistem Güncellemeleri sayfalarına devreder.
Neye ihtiyacım var?
- Lisans
- Any
- Rol
admin_user
Ön koşullar
- Cihaz açık ve sanal makine konsolunda gösterilen IP adresini biliyorsunuz.
- Aynı ağdaki bir tarayıcı o adrese erişebiliyor.
- Cihazın üzerinde açıldığı ağ güvenilir ya da yalıtılmış — yöneticiyi oluşturan adım tasarım gereği kimlik doğrulamasızdır, yani sihirbaza ilk ulaşan kişi yönetici olur.
- Sanal makinede: sihirbaz görünür ve yanıtlanmamışken bir anlık görüntü alındı. Sihirbaz bir kez çalışır; yapılandırılmamış bir cihaza dönmenin tek yolu o anlık görüntüdür.
- Yerel yönetici için en az 8 karakterlik güçlü bir parola seçtiniz.
- İsteğe bağlı: bir giden vekil URL'si, bir LLM sağlayıcı API anahtarı, dizin bağlanma bilgileri ve ücretli lisans dosyası. .lic dosyası olmadan yerleşik denemeyle devam etmeyi açıkça seçmeniz gerekir.
Arka uç tamamlamadan önce hem Admin account (yönetici hesabı) hem de License (lisans) kararı ister. Lisans kararı yerleşik deneme olabilir, ancak adım atlanamaz. Tarayıcıda Deployment mode (dağıtım kipi) de zorunludur. optional (isteğe bağlı) işaretli adımlarda Skip (atla) düğmesi vardır; Packages (paketler) isteğe bağlıdır çünkü bütün hak kazanılmış eklentileri daha sonra kurmak geçerli bir seçimdir.
Warning
Sihirbazı tek bir tarayıcı oturumunda tamamlayın. Sayfayı yeniden yüklemek veya tarayıcıyı kapatmak sizi bıraktığınız adıma döndürmez, sihirbazı Welcome adımından yeniden başlatır; Admin account adımı da bir hesap zaten var olduğu için yeniden çalışmayı reddeder ve sihirbazın tarayıcıdan ilerleyecek bir yolu kalmaz. Bundan kurtulmanın yolu, aşağıdaki "Yarım kalmış bir sihirbazı kurtarma" bölümündedir.
Her yanıt neyi değiştirir
Sihirbaz ticari hakkı, makinenin uygunluğunu ve operatör seçimini birbirinden ayırır. Bunlar farklı kararlardır: lisans bir servise hak verebilir, donanım ön kontrolü onu bu makine için uygunsuz bulabilir ve operatör yine de başka bir makine için erteleyebilir.
| Adım | Yanıt neyi değiştirir | Aynı şey sonradan nerede değiştirilir |
|---|---|---|
| Admin account | Tek yerel superadmin hesabını oluşturur. Her zaman yereldir; bu nedenle erişilemeyen bir etki alanı denetleyicisi sizi dışarıda bırakamaz | Başka hesaplar kullanıcılar sayfasından oluşturulur — ama bu ilk hesap bir kez ve yalnızca burada oluşturulur |
| License | Geçerli denemeyi kabul eder veya imzalı .lic dosyasını kurar; hakları Packages adımının hangi isteğe bağlı servisleri göstereceğini belirler | Ayarlar → Lisans; değişen lisans Ayarlar → Sistem Güncellemeleri altında servis ekleme/kaldırma planı oluşturur |
| User identity | Hiçbir şey. Adım bilgilendiricidir ve hiçbir seçim kaydetmez | Seçtiğiniz ilişkilendirme mekanizması, kendi sayfasından |
| Deployment mode | Finish seçtiğinizde ana makinenin hangi servisleri başlatacağına karar verir: ağ geçidi, denetim dinleyicisi ya da her ikisi | Aynı ana makine uzlaştırmasını kuyruğa alan Ayarlar → Sistem Güncellemeleri |
| Connectivity | Giden vekili soğuk yapılandırma olarak hazırlar. Hemen değil Finish anında uygulanır ve sonrasında sağlayıcı istemcileri ile güncelleyici tarafından okunur | Ana makinedeki cihaz ortamı. 0.4'te bunun için bir Ayarlar sayfası yoktur |
| Packages | Yalnızca canlı lisansın hak verdiği isteğe bağlı servisleri gösterir, her birini /etc/cid/hardware.json ile rozetler ve Install now, Later ya da Skip kararını kaydeder | Yeni haklar ve bekleyen kurulumlar Ayarlar → Sistem Güncellemeleri altında incelenir |
| LLM providers | Varsayılan kiracı grubuna bağlı bir sağlayıcı kimlik bilgisi oluşturur; böylece her kullanıcı onu devralır | Yeni bir kimlik bilgisinin onu oluşturana ait olduğu Kimlik Bilgileri sayfası. Sihirbazın kendi sağlayıcı yolu Finish anında kapanır |
| Active Directory | Dizin yapılandırmasını veritabanına yazar ve hemen uygular. Save configuration, bir test başarılı olana kadar devre dışı kalır | Ayarlar → Active Directory / LDAP |
| Connect Claude Code | Bir Claude Code kiracı grubu oluşturur ve yönetilen ayarlar dosyasına gömülü, bir kez gösterilen kapsamlı bir anahtar düzenler | Yeni bir anahtar düzenleyerek API Anahtarları. Burada gösterilen anahtar bir daha görüntülenemez |
| Finish | Kurulumu tamamlanmış olarak işaretler, 423 kilidini kaldırır ve ana makineden hazırlanan yapılandırmayı uygulamasını ve kipin gerektirdiği servisleri başlatmasını ister | Hiçbir şey. Bu adım bir kez gerçekleşir |
Bu yanıtlardan ikisini tarayıcıyı açmadan önce çözmekte yarar var. Deployment mode hangi kapsayıcıların başlayacağına karar verir; bu nedenle tek bir şekil için boyutlandırılmış bir makinede Both seçmek, cihazın belleğinin ilk kez tükenme biçimidir. Ve burada eklenen bir sağlayıcı kimlik bilgisi kurum genelidir — her kullanıcı onu devralır — oysa sonradan Kimlik Bilgileri sayfasından eklenen bir kimlik bilgisi, onu oluşturana aittir.
Sihirbazı yürütün
Cihazı tarayıcıda açın
Cihazın adresine gidin. Bir OVA http://<appliance-ip>/ üzerinden yanıt verir; ISO'dan kurulmuş
bir cihaz yalnızca HTTPS sunar, bu yüzden https://<appliance-ip>/ adresini kullanın ve bir
kerelik sertifika uyarısını kabul edin.
Cihaz sizi kurulum sayfasına yönlendirir ve solda on adım listelenmiş hâlde Welcome to CID222 — first-boot setup (CID222'ye hoş geldiniz — ilk açılış kurulumu) başlığını gösterir. Servisler başlarken ilk açılış birkaç dakika sürebilir; bu süre içinde kısa süreli bir 502 normaldir.
/assets/screenshots/setup-wizard-welcome@0.4.pngWelcome adımını okuyun ve devam edin
Next (ileri) seçin.
Sihirbaz Admin account adımına geçer. Henüz hiçbir şey yazılmaz.
Yerel acil durum yöneticisini oluşturun
Admin username (yönetici kullanıcı adı), Admin password (min 8 chars) (yönetici parolası, en az 8 karakter) ve isterseniz Contact email (optional) (iletişim e-postası) alanlarını doldurun, ardından Create admin & continue (yöneticiyi oluştur ve devam et) seçin.
Hesap superadmin olarak oluşturulur, sihirbaz tarayıcıyı o hesapla oturum açtırır ve Admin created — continue (yönetici oluşturuldu — devam) gösterir. Bu yönetici her zaman yereldir; böylece erişilemeyen bir etki alanı denetleyicisi sizi cihazdan hiçbir zaman dışarıda bırakamaz. Adım yinelenemez: bir hesap var olduktan sonra yönetici oluşturma isteği reddedilir.
/assets/screenshots/setup-wizard-admin@0.4.pngDenemeyi kabul edin ya da lisansı etkinleştirin
Sihirbaz yöneticiden hemen sonra License adımını açar. Yerleşik denemeyi kullanmak için bitiş
tarihini gözden geçirip Next seçin. Ücretli paketi etkinleştirmek için Export activation
request seçin, dosyayı CID222 muhatabınıza gönderin ve gelen .lic dosyasını Upload a
license file (.lic) alanından yükledikten sonra devam edin.
Haklar sonraki paket listesini belirlediği için bu adım zorunludur ve Skip düğmesi yoktur. Bağlı ve hava boşluklu alışverişin tamamı Lisanslama ve etkinleştirme sayfasındadır.
/assets/screenshots/setup-wizard-license@0.4.pngKullanıcı kimliği zincirini okuyun
User identity (kullanıcı kimliği) altında listelenen beş ilişkilendirme mekanizmasını gözden geçirin, ardından Next ya da Skip seçin.
Adım bilgilendirmedir ve hiçbir seçim kaydetmez: cihazın yapay zekâ trafiğine hangi sırayla ad verdiğini açıklar — eklenti oturumu, bir web ağ geçidinin verdiği kullanıcı adı, Active Directory kullanıcı kimliği ajanı, elle yapılan IP veya CIDR eşlemesi ve kayıtlı cihaz köprüsü. Her biri kurulumdan sonra kendi sayfasında yapılandırılır.
/assets/screenshots/setup-wizard-identity@0.4.pngDağıtım kipini seçin
AI Gateway, Inline inspection (SWG/ICAP) (satır içi denetim) ya da Both (her ikisi) seçeneğini seçin, ardından Next seçin.
Seçim kaydedilir ve bitirdiğinizde ana makinenin hangi servisleri başlatacağına karar verir. Adımda Skip düğmesi yoktur ve seçimi sonradan Ayarlar → Sistem Güncellemeleri altından değiştirebilirsiniz.
/assets/screenshots/setup-wizard-mode@0.4.pngVarsa giden vekil sunucuyu bildirin
Cihaz internete doğrudan erişiyorsa ya da hiç erişmiyorsa Behind a corporate proxy? (kurumsal vekil arkasında mı?) seçeneğini kapalı bırakın ve Skip seçin. Aksi hâlde açın, HTTPS proxy alanına vekil URL'sini ve No-proxy (comma-separated, optional) (vekile uğramayacaklar) alanına onu atlaması gereken sunucuları yazın, ardından Next seçin.
Değerler cihazda soğuk yapılandırma olarak hazır bekletilir ve hemen değil, Finish anında etkinleşir. Bunları dışarıya bağlantı kuran bileşenler okur — LLM sağlayıcı istemcileri ve güncelleyici.
/assets/screenshots/setup-wizard-connectivity@0.4.pngKurulacak hak kazanılmış servisleri seçin
Packages adımı, etkin deneme ya da lisansın açtığı isteğe bağlı compose servislerini listeler. Her satır donanım envanterinden Suitable, Degraded, Unsuitable ya da Unknown durumunu ve imzalı servis kataloğundaki gereksinim notunu gösterir.
Servisi ana makine uzlaştırmasında eklemek için Install now, bekleyen kurulum kuyruğuna almak için Later, seçmemek için Skip belirleyin. Zorunlu çekirdek ve koruma servisleri operatör seçimi olmadığından listelenmez. Boş liste, bu paketin yalnızca her zaman açık çekirdeğe hak verdiğini gösterir. Unknown uygun anlamına gelmez; ilk açılışın okunabilir bir donanım raporu üretmediğini gösterir.
/assets/screenshots/setup-wizard-packages@0.4.pngBir LLM sağlayıcı ekleyin
Connected (cloud) (bağlı — bulut) ya da Air-gapped (local) (hava boşluklu — yerel) seçeneğini seçin ve bir Provider (sağlayıcı) belirleyin. Bulut sağlayıcı kendi API key alanını ister; yerel bir sağlayıcı Model endpoint (LAN URL) (model uç noktası) ister ve anahtar alanı API key (optional) olarak görünür. Test connection (bağlantıyı test et) seçin, ardından Next seçin. Sağlayıcıyı sonra Kimlik Bilgileri altından eklemek için Skip seçin.
Başarılı bir test, ölçülen gecikmeyle birlikte Reachable (erişilebilir) bildirir; başarısız bir test sağlayıcının kendi hatasını bildirir. Kaydedildiğinde kimlik bilgisi varsayılan kiracı grubuna bağlanır, böylece her kullanıcı onu devralır. Air-gapped (local) seçmek, sağlayıcı listesini yerel ağ uç noktası kabul edenlerle sınırlar.
/assets/screenshots/setup-wizard-providers@0.4.pngActive Directory'yi bağlayın
Yerel hesaplarda kalmak için Use Active Directory / LDAP (Active Directory / LDAP kullan) seçeneğini kapalı bırakın ve Skip seçin. Aksi hâlde açın; Directory type (dizin türü), Group membership mode (grup üyeliği kipi), Server URL (sunucu URL'si), Bind DN (service account) (bağlanma DN'i — servis hesabı), Bind password (bağlanma parolası), Base DN (taban DN), User filter (kullanıcı filtresi) ve Admin group DN (optional) (yönetici grubu DN'i) alanlarını doldurun, Test connection seçin, sonra Save configuration (yapılandırmayı kaydet) seçin.
Save configuration, bir test başarılı olana kadar devre dışı kalır; böylece bağlanamayan bir dizinle kurulumu bitiremezsiniz. Kaydettikten sonra isteğe bağlı bir panel, bir AD group (AD grubu) girdisini bir Role (rol) ve bir CID group (CID grubu) ile eşlemenizi ve Add mapping & import now (eşlemeyi ekle ve şimdi içe aktar) seçmenizi sağlar; bu, kaç kullanıcı içe aktardığını bildirir. Dizin ayarları veritabanı durumudur ve hemen uygulanır.
/assets/screenshots/setup-wizard-directory@0.4.pngClaude Code yönetilen ayarlarını üretin
Proxy hostname (base URL) (vekil sunucu adı) ve API hostname (gateway) (API sunucu adı) alanlarını doldurun, Generate managed settings (yönetilen ayarları üret) seçin, sonra Copy (kopyala) seçin. Claude Code'u henüz bu cihaz üzerinden yönlendirmiyorsanız Skip seçin.
Cihaz bir Claude Code kiracı grubu oluşturur, kapsamı sınırlı bir anahtar düzenler ve yönetilen ayarların JSON'unu üretir. Anahtar bir kez gösterilir ve o JSON'un içine gömülüdür. Sunucu adı alanlarını yalnızca cihaz kendi adlarını zaten biliyorsa boş bırakın; aksi hâlde dosya yer tutucularla üretilir ve yapıştırmadan önce sizi uyarır.
/assets/screenshots/setup-wizard-claude-code@0.4.pngKurulumu bitirin
Finish setup (kurulumu bitir) seçin.
Cihaz kurulumu tamamlanmış olarak işaretler, 423 kilidi kalkar ve tarayıcı panele iner. Cihaz
ayrıca ana makineden hazır bekleyenleri uygulamasını ister: ana makine uzlaştırıcısı kurulum
kimliğini oluşturur, Install now paket seçimlerini etkin profile birleştirir, Later
seçimlerini bekleyen kuyrukta tutar, yığını giden vekil ayarları ve hak kazanılmış servislerle
yeniden kurar ve sonucu sağlık denetiminden geçirir. Yığın yeniden kurulurken kısa bir kesinti bekleyin.
/assets/screenshots/setup-wizard-finish@0.4.pngYanıtların saklandığı yer
Kurulum yalnızca cihazın kalıcı ağaçlarına yazar; böylece bir güncelleme onu hiçbir zaman atmaz.
| Ne | Nerede | Kim yazar |
|---|---|---|
| Adım sonuçları, tamamlanma, seçilen kip | /var/lib/cid/setup/setup-state.json | sihirbaz |
| Giden vekil ayarları | /var/lib/cid/setup/proxy.env | sihirbaz; Finish anında ana makine uygular |
| Ana makine uzlaştırıcısına yapılan istek | /var/lib/cid/setup/apply-intent.json | Finish anında sihirbaz |
| Kurulum kimliği | /etc/cid/installation.json | ana makine uzlaştırıcısı |
| Yüklenen lisans | /var/lib/cid/license/ | lisans yükleme |
| Uygunluk rozetlerinde kullanılan donanım envanteri | /etc/cid/hardware.json | ilk açılış |
| Şimdi kurulmak üzere seçilen paketler | /var/lib/cid/setup/packages.json | sihirbaz; ana makine ajanı /etc/cid/profile.json içine birleştirir |
| Ertelenen paket kuyruğu | /var/lib/cid/pending-install.json | sihirbaz ve ana makine ajanı |
| Yönetici, sağlayıcı kimlik bilgisi, dizin yapılandırması | veritabanı | sihirbaz |
Geri alınamayanlar
Warning
Sihirbazı yeniden çalıştırmanın desteklenen bir yolu yoktur. Kurulum tamamlandıktan sonra önyükleme yolları başka çağrıları reddeder ve sihirbazın topladığı her ayar bunun yerine kendi Ayarlar sayfasından değiştirilir — dağıtım kipi de dâhil, Ayarlar → Sistem Güncellemeleri altından.
| Ne | Neden tek yönlü | Bunun yerine ne yapmalı |
|---|---|---|
| Sihirbazın kendisi | POST /setup/complete cihazı yapılandırılmış olarak işaretler ve o andan sonra sihirbaz yolu ortadan kalkar | Her yanıtı kendi Ayarlar sayfasından değiştirin |
| İlk yönetici | POST /setup/admin, herhangi bir hesap var olduğu anda reddedilir — kurulum sırasında da sonrasında da | Başka hesapları kullanıcılar sayfasından oluşturun. Bunu acil durum hesabı olarak saklayın |
| Sihirbaz üzerinden sağlayıcı kimlik bilgisi oluşturmak | Kurulum tamamlandığında POST /setup/provider reddedilir; çünkü anahtarı kimsenin sahibi olmadığı bir gruba bağlar | Sağlayıcı kimlik bilgilerini Kimlik Bilgileri sayfasından ekleyin |
| Claude Code anahtarı | Bir kez döndürülür ve yeniden görüntülenebilecek bir biçimde hiç saklanmaz | API Anahtarları sayfasından yeni bir anahtar düzenleyin ve yönetilen ayarları yeniden dağıtın |
| Kurulum kimliği | Lisans ona bağlıdır. Değiştirmek, düzenlenmiş bir lisansı geçersiz kılar | Hiçbir şey. Ona dokunmayın ve yeniden kurulumun onu koruması için /etc/cid dizinini yedekleyin |
Yarım kalmış bir sihirbazı kurtarma
Sihirbaz hiçbir tarayıcı oturumu tutmaz: sayfayı yeniden yüklemek, sekmeyi kapatmak ya da ağı kaybetmek onu Welcome adımından yeniden başlatır ve Admin account adımı da az önce oluşturduğunuz hesap zaten var olduğu için reddeder. Hiçbir şey bozulmaz — cihaz hâlâ kilitlidir, durum dosyası hangi adımların tamamlandığını hâlâ kaydeder — ama tarayıcının ilerleyecek bir yolu kalmaz.
Size uyanların ilkini yapın:
- Sihirbazı açmadan önce cihazın anlık görüntüsünü aldınız. Anlık görüntüyü geri yükleyin ve sihirbazı yeniden yürütün. O anlık görüntüyü almanın nedeni budur ve tek temiz yol budur.
- Almadınız ve cihaz zaten yepyeni. Yeniden kurun. Bir içe aktarma ya da bir ISO koşusu alternatifinden ucuzdur ve sihirbaza dönmenin tek yoludur.
- İkisi de kabul edilebilir değil — cihaz kaybedemeyeceğiniz bir yapılandırmayı zaten tutuyor.
Kurulum tarayıcının dışında tamamlanabilir: oluşturduğunuz yöneticiyle oturum açın — cihaz
kilitliyken de oturum açma yolu erişilebilir kalır — ve kurulumu API üzerinden tamamlayın
(
POST /setup/complete).423kilidi kalkar ve ulaşamadığınız her adım sonrasında kendi Ayarlar sayfasından yapılandırılır. Bunu sizinle birlikte çalıştırması için CID222 muhatabınızdan yardım isteyin; bu bir kurtarma yordamıdır, desteklenen bir kurulum yolu değil.
Warning
Kurulumu bu şekilde tamamlamak, Finish düğmesinin yaptığı ana makine uzlaştırmasını aynı biçimde kuyruğa alır; ancak hiç göndermediğiniz bir adım hiç kaydedilmemiştir — bu nedenle bu yolla tamamlanan bir cihaz, seçilmiş bir dağıtım kipi olmadan açılır. Sonrasında kipi Ayarlar → Sistem Güncellemeleri altından ayarlayın; bu da uzlaştırmayı yeniden kuyruğa alır.
Doğrulama
- Tarayıcı panele iner ve kenar çubuğu görüntülenir. Ürün sayfaları artık
SETUP_REQUIREDyanıtı vermez. - Oturumu kapatın ve oluşturduğunuz yöneticiyle yeniden açın. Oturum açma yerel hesaba karşı başarılı olur.
- Ayarlar → Sistem Güncellemeleri sayfasını açın. Deployment mode (dağıtım kipi) kartı seçtiğiniz kipi gösterir ve uzlaştırma bittiğinde etiketi applying on the host (ana makinede uygulanıyor) yerine o kipi yazar.
- Ayarlar → Lisans sayfasını açın. Sayfa ya kalan günleriyle denemeyi ya da yüklediğiniz lisansı bildirir ve boş olmayan bir kurulum kimliği gösterir.
Başarısız olursa
- Connectivity adımı hiçbir alan doldurulmamışken bile
500döndürüyor → Kurulum bağlantı adımı 500 döndürüyor - LLM providers adımı hiç sağlayıcı listelemiyor → Sağlayıcı adımı boş
- Bir adım, form hatası yerine bir mesajla doğrudan reddediliyor → Bir ilk açılış sihirbazı adımı reddediliyor
- Sihirbaz tamamlandıktan sonra her istek
402döndürüyor → Kurulumdan sonra 402 - Sihirbaz bitiyor ve cihaz yeniden kurulum istiyor → Kurulum sihirbazı bitiyor ve cihaz yeniden kurulum istiyor
- Yanıtlar yeniden başlatmadan sağ çıkmıyor → Cihazın kaydettiği ayarlar yeniden başlatmadan sağ çıkmıyor
- Uzlaştırmadan sonra panele HTTPS üzerinden erişilemiyor → Sertifika süresi doldu veya 443'te hiçbir şey sunulmuyor
Sonraki adımlar
- Lisanslama ve etkinleştirme — 30 günlük denemeyi çevrimiçi ya da hava boşluğu üzerinden satın aldığınız pakete dönüştürün.
- Adlandırma, DNS ve TLS — cihaza, istemcilerinizin güvenilir HTTPS üzerinden erişebileceği adlar verin; eklenti ve Claude Code bunu zorunlu kılar.
- Sıkılaştırma denetim listesi — imajın değil, operatörün işi olan ayarlar.
Son güncelleme