Skip to main content
CID222 Docs

İ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ımYanıt neyi değiştirirAynı şey sonradan nerede değiştirilir
Admin accountTek yerel superadmin hesabını oluşturur. Her zaman yereldir; bu nedenle erişilemeyen bir etki alanı denetleyicisi sizi dışarıda bırakamazBaşka hesaplar kullanıcılar sayfasından oluşturulur — ama bu ilk hesap bir kez ve yalnızca burada oluşturulur
LicenseGeç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 belirlerAyarlar → Lisans; değişen lisans Ayarlar → Sistem Güncellemeleri altında servis ekleme/kaldırma planı oluşturur
User identityHiçbir şey. Adım bilgilendiricidir ve hiçbir seçim kaydetmezSeçtiğiniz ilişkilendirme mekanizması, kendi sayfasından
Deployment modeFinish seçtiğinizde ana makinenin hangi servisleri başlatacağına karar verir: ağ geçidi, denetim dinleyicisi ya da her ikisiAynı ana makine uzlaştırmasını kuyruğa alan Ayarlar → Sistem Güncellemeleri
ConnectivityGiden 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 okunurAna makinedeki cihaz ortamı. 0.4'te bunun için bir Ayarlar sayfası yoktur
PackagesYalnı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ı kaydederYeni haklar ve bekleyen kurulumlar Ayarlar → Sistem Güncellemeleri altında incelenir
LLM providersVarsayılan kiracı grubuna bağlı bir sağlayıcı kimlik bilgisi oluşturur; böylece her kullanıcı onu devralırYeni 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 DirectoryDizin yapılandırmasını veritabanına yazar ve hemen uygular. Save configuration, bir test başarılı olana kadar devre dışı kalırAyarlar → Active Directory / LDAP
Connect Claude CodeBir Claude Code kiracı grubu oluşturur ve yönetilen ayarlar dosyasına gömülü, bir kez gösterilen kapsamlı bir anahtar düzenlerYeni bir anahtar düzenleyerek API Anahtarları. Burada gösterilen anahtar bir daha görüntülenemez
FinishKurulumu 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ı isterHiç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.

Welcome 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.

Denemeyi 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.

Kullanı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.

Dağı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.

Varsa 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.

Kurulacak 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.

Bir 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.

Active 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.

Claude 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.

Kurulumu 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.

Yanı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.

NeNeredeKim yazar
Adım sonuçları, tamamlanma, seçilen kip/var/lib/cid/setup/setup-state.jsonsihirbaz
Giden vekil ayarları/var/lib/cid/setup/proxy.envsihirbaz; Finish anında ana makine uygular
Ana makine uzlaştırıcısına yapılan istek/var/lib/cid/setup/apply-intent.jsonFinish anında sihirbaz
Kurulum kimliği/etc/cid/installation.jsonana 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.jsonilk açılış
Şimdi kurulmak üzere seçilen paketler/var/lib/cid/setup/packages.jsonsihirbaz; ana makine ajanı /etc/cid/profile.json içine birleştirir
Ertelenen paket kuyruğu/var/lib/cid/pending-install.jsonsihirbaz 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.

NeNeden tek yönlüBunun yerine ne yapmalı
Sihirbazın kendisiPOST /setup/complete cihazı yapılandırılmış olarak işaretler ve o andan sonra sihirbaz yolu ortadan kalkarHer yanıtı kendi Ayarlar sayfasından değiştirin
İlk yöneticiPOST /setup/admin, herhangi bir hesap var olduğu anda reddedilir — kurulum sırasında da sonrasında daBaşka hesapları kullanıcılar sayfasından oluşturun. Bunu acil durum hesabı olarak saklayın
Sihirbaz üzerinden sağlayıcı kimlik bilgisi oluşturmakKurulum tamamlandığında POST /setup/provider reddedilir; çünkü anahtarı kimsenin sahibi olmadığı bir gruba bağlarSağ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ç saklanmazAPI Anahtarları sayfasından yeni bir anahtar düzenleyin ve yönetilen ayarları yeniden dağıtın
Kurulum kimliğiLisans ona bağlıdır. Değiştirmek, düzenlenmiş bir lisansı geçersiz kılarHiç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:

  1. 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.
  2. 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.
  3. İ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). 423 kilidi 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

  1. Tarayıcı panele iner ve kenar çubuğu görüntülenir. Ürün sayfaları artık SETUP_REQUIRED yanıtı vermez.
  2. Oturumu kapatın ve oluşturduğunuz yöneticiyle yeniden açın. Oturum açma yerel hesaba karşı başarılı olur.
  3. 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.
  4. 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

Sonraki adımlar

Son güncelleme

Bu sayfada