VC Bridge Connect kurulumu

Başlamadan önce: bu rehber kimin için?

Bu rehber, VC Bridge Connect modülünü satın alıp kendi WHMCS sitesine kuracak hosting işletmesi içindir. Buradaki “siz” modülün sahibisiniz; “müşteriniz” ise sizden VPS/VDS satın alan kişidir.

Kurulum sonunda müşteriniz sitenizden paket ve işletim sistemi seçer. Ödeme onaylanınca modül vCenter’da VM oluşturur, IP ve parolayı ayarlar. Müşteri hizmet sayfasından sunucusunu yönetir.

Modül, çalışan bir WHMCS ve kurulmuş vCenter gerektirir. WHMCS, vCenter veya ESXi’yi sıfırdan kuran bir yazılım değildir.

İki farklı “hosting paneli” vardır: WHMCS sitenizin barındığı cPanel/Plesk gibi panel, modül dosyalarını ve cron’u yönettiğiniz yerdir. HestiaCP/CloudPanel/aaPanel/CyberPanel seçeneği ise müşteriye açılan yeni sanal sunucunun içine kurulacak paneldir.

1. Hosting ve sürüm uygunluğunu kontrol edin

WHMCS hangi hosting panelinde bulunabilir?

Modül cPanel/Plesk API’sini kullanarak çalışmaz; WHMCS içinde çalışır. Bu yüzden panel adı tek başına yeterli değildir.

WHMCS ve VMware sürümleri

Hangi PHP sürümünü seçmeliyim?

PHP testinin geçmesi, aynı PHP ile WHMCS’in de desteklendiği anlamına gelmez. Sürüm seçimi için WHMCS 8.13 gereksinimlerini esas alın. Bu modül ayrıca ionCube Encoder veya özel bir PHP koruma eklentisi istemez; WHMCS’in kendi Loader gereksinimi devam eder.

Hosting hesabında bulunması gerekenler

• 64 bit PHP; curl, openssl, json, PDO, pdo_mysql. WHMCS’in diğer gerekli eklentileri de etkin olmalı.
• WHMCS ile uyumlu MySQL/MariaDB; modül tablolarında InnoDB ve kendi veritabanında tablo oluşturma/yazma yetkisi.
• PHP memory_limit için 256 MB veya üzeri başlangıç önerisi; toplam hosting kaynak ihtiyacı hizmet sayısıyla değişir.
• HTTPS çalışan WHMCS alan adı; PHP’nin güvenilir CA sertifika deposu ve yazılabilir geçici dizini.
• Dakikada bir PHP CLI görevi çalıştırabilme. Web PHP’si ve cron PHP’si aynı sürüm/eklentilerle çalışmalı.
• Hosting dosya yöneticisi veya SFTP/FTPS ile dosya yükleme hakkı. WHMCS kullanıcısı modül dosyalarını okuyabilmeli; dosya izinlerini 777 yapmayın.
• Sabit internet çıkış IP’si ve aşağıdaki ağ erişimi. WHMCS alan adının A kaydı ile sunucunun dışarı çıkış IP’si farklı olabilir.

2. Kurulum bilgilerini hazırlayın

Başlamadan önce aşağıdaki bilgileri not edin. Şifreleri herkese açık belgeye veya destek kaydına eklemeyin.

3. Dosyaları hosting hesabına yükleyin

Nerede: cPanel File Manager / Plesk Files / SFTP

1. Önce WHMCS dosya ve veritabanı yedeğinizi alın.
2. Müşteri hesabınızdan vcbridge-connect-1.0.23.zip dosyasını indirin ve bilgisayarınızda açın.
3. Hosting hesabınızda WHMCS’in kurulu olduğu klasörü açın. init.php’nin bulunduğu klasör doğru yerdir. WHMCS alt klasördeyse genel public_html yerine o klasörü kullanın.
4. ZIP içindeki modules ve includes klasörlerinin içeriğini aynı isimli WHMCS klasörleriyle birleştirin. Mevcut klasörleri silmeyin.
5. Aşağıdaki üç dosyanın doğru yerde olduğunu kontrol edin. ZIP’in dışına fazladan bir vcbridge-connect-1.0.23 klasörü koymayın.

WHMCS_KOKU/
├── init.php
├── includes/hooks/vcbridgeconnect.php
├── modules/addons/vcbridgeconnect/vcbridgeconnect.php
└── modules/servers/vcbridgeconnect/vcbridgeconnect.php

docs/kurulum.html bu kılavuzdur; bilgisayarınızda açabilirsiniz. manifest.json paket dosya özetlerini içerir. Kendi configuration.php dosyanızı değiştirmeyin.

Kontrol: WHMCS yönetim paneli normal açılmalı; bir sonraki adımda VC Bridge Connect eklenti listesinde görünmelidir.

4. Eklentiyi açın ve lisansı etkinleştirin

Nerede: WHMCS yönetimi → System Settings → Addon Modules

1. VC Bridge Connect → Activate seçin.
2. Configure / Access Control bölümünden modülü kullanacak yönetici rolünü işaretleyip kaydedin.
3. Üst menüden Addons → VC Bridge Connect → Lisans açın.
4. Lisans kodunuzu yapıştırın; Doğrula ve etkinleştir düğmesine basın.

Kontrol: “Lisans etkin” durumu görünmelidir. Lisans etkinleşmeden diğer kurulum işlemlerine devam etmeyin.

Lisans bir WHMCS kurulumuna bağlıdır. Seçtiğiniz vCenter adedi, aynı vCenter içindeki ESXi sayısını değil benzersiz vCenter sayısını ifade eder. Alan adı, dizin veya çıkış IP’si değişecekse lisans taşıma işlemi için destek alın.

Lisans etkinleştikten sonra kod alanı kapalı kalır. Kartta yenileme tarihi, kalan gün ve vCenter hakkı görünür. Kod değiştirmek için Lisans kodunu değiştir düğmesini açın. Yeni lisans doğrulanırsa bağlantı ve hizmet kayıtları korunur; geçersiz kod mevcut kaydı değiştirmez. Gün sayısı lisans hizmetinin yenileme tarihine ve faturalandırma sunucusunun saat dilimine göre hesaplanır.

İsteğe bağlı lisans özellikleri

vCenter kapasiteniz ile ek modül haklarınız farklıdır. Örneğin 3 vCenter lisansı almanız Nested veya Web Konsolu hakkını kendiliğinden vermez. Satın alınmış haklar Lisans → Ek modül hakları bölümünde görünür. Bir hakkın görünmesi, gerekli altyapının hazır olduğu anlamına gelmez.

Ek özellikler aynı ana lisansa bağlanan tek seferlik ürün eklentileridir; ana lisansın aylık/yıllık yenilemesinde yeniden ücret alınmaz. Ana lisansınızın geçerli kalması gerekir. Ödeme ve hak değişikliklerinin kontrol servisine yansıması en fazla yaklaşık 5 dakika sürebilir. Lisans kontrolü mevcut VM’leri kendiliğinden kapatmaz ve yedek silmez.

Nested özelliğini nasıl kullanırım?

1. Modül lisansınızda Nested hakkının etkin olduğunu doğrulayın.
2. WHMCS yönetiminde Sistem Ayarları → Ürünler/Hizmetler → ilgili ürün → Modül Ayarları bölümünü açın.
3. Nested sanallaştırma alanını Nested ürünlerinde Açık — Nested sunucu paketi, standart VPS/VDS ürünlerinde Kapalı — standart VPS / VDS olarak kaydedin.
4. Yeni hizmet oluşturulurken modül bu paket ayarını uygular. Şablonda açık olsa bile standart VPS/VDS kopyasında nested kapatılır. Ürün ayarını değiştirmek mevcut hizmetlerin VM ayarlarını veya kaydedilmiş kurulum profilini değiştirmez.
5. Müşteri panelinde nested ayar alanı yoktur; eski müşteri aç/kapat bağlantıları da reddedilir. Nested VM içerisindeki hypervisor ve alt VM ağları ayrıca hazırlanır.

Bu seçenek CPU’nun sanallaştırma yeteneklerini VM’ye açar. İçerideki Proxmox/ESXi/Hyper-V sunucusunu veya alt VM’leri WHMCS’ten yönetmez. Host BIOS’u, port group güvenlik ayarları veya ağ otomatik değiştirilmez. Her hypervisor/sürüm için çalışma garantisi verilmez.

Hazırlanmış Proxmox ve ESXi şablonlarından kurulum

Bu sürümde özel hazırlanmış Proxmox VE 9.2.2 ve ESXi 8.0 U3k (build 25595708) şablonları kullanılabilir. İmaj dosyaları müşteri modül ZIP’ine dahil değildir. Bir depodan indirilen normal OVA, bu özel hazırlığı kendiliğinden içermez. Şablonu kendi vCenter’ınıza aktarın; hazırlığının ve sürümünün uyumunu doğrulayın.

1. Proxmox için Diğer Linux — VC Bridge hazırlığı yapılmış; hazırlanmış ESXi için Nested ESXi 8 U3k — özel hazırlığı tamamlanmış yöntemini seçin.
2. ESXi ürününe en az 8 GiB RAM ve 240 GiB disk tanımlayın ve Açık — Nested sunucu paketi seçin. Lisansınızda Nested hakkı bulunmalıdır.
3. Kataloğa eklediğiniz işletim sistemi ID’sini yalnızca Nested ürünlerinin izin verilen işletim sistemlerine ekleyin. Hosting paneli seçeneğini bu hypervisor imajlarıyla kullanmayın.
4. Modül yeni bir sanal makine kopyası oluşturur. İlk açılışta o VM’ye özgü IP, root parolası, makine kimliği ve anahtarlar uygulanır. Hazırlanmış boş ESXi veri bölümü yalnızca ilk kurulumda yeni VMFS kimliğiyle oluşturulur; sonraki disk büyütmelerinde yeniden format atılmaz.
5. ESXi’de ilk IP yönetim adresidir. Ek IP’ler hizmete ayrılır; içerideki VM’lerin ağını müşteri ayrıca düzenler. Ek IP’ler yönetim arayüzüne eklenmez. Proxmox/ESXi içindeki alt VM’ler modül tarafından yönetilmez.

ESXi’nin işletim sistemi ve OSDATA bölümleri sanal diskin bir kısmını kullanır; örneğin 240 GiB sanal diskin tamamı iç VM depolamasına kalmaz. Bu hazırlık Secure Boot kapalı Nested VM içindir. Fiziksel hostun Secure Boot veya ağ güvenliği ayarlarını değiştirmeyin.

Broadcom’un nested hypervisor destek kapsamını ve kullanacağınız ESXi lisansını ayrıca kontrol edin. Modülün test edilmiş olması üretici desteği veya ESXi lisansı sağlamaz. Kendi altyapınızda ilk sipariş öncesi izole test yapın.

Nested’i paket özelliği yapma

Ürünü düzenleyin → Modül Ayarları → Nested sanallaştırma → Açık — Nested sunucu paketi seçin. Donanım desteği kurulumdan önce kontrol edilir. Bu seçim Proxmox veya ESXi’yi kurmaz; seçtiğiniz şablon işletim sistemini belirler. Alt VM’ler için NAT/bridge ve IP yönlendirmesi ayrı ağ tasarımıdır. Ana müşteri ağının güvenlik ayarları otomatik gevşetilmez.

5. vCenter’da müşteri alanını hazırlayın

Nerede: vSphere Client

1. vCenter için kalıcı FQDN, statik IP, doğru DNS ileri/ters kaydı ve senkron saat hazırlayın. ESXi’yi vCenter envanterine ekleyin; host Connected görünmeli.
2. VMs and Templates altında VCBridge-VMs müşteri klasörü ve VCBridge-Templates kaynak şablon klasörü oluşturun. Yönetim, vCenter, yedek ve diğer üretim VM’lerini buraya koymayın.
3. Bir kaynak havuzu, datastore ve müşteri port group’u seçin. Modül bunları dosya adından tahmin etmez; planınızda siz belirlersiniz.
4. Yönetim erişimini VPN veya izinli kaynaklarla sınırlayın. WHMCS’in vCenter’a ulaşabildiğini doğrulayın.

Kontrol: Müşteri VM klasörü, kaynak havuzu, datastore ve standart ağ hazır; ESXi “Connected” durumda olmalıdır.

6. Modül için ayrı vCenter kullanıcısı oluşturun

Nerede: vSphere Client → Administration

WHMCS’e kişisel yönetici hesabınızı yazmayın. Modül için vcbridge-service isimli kullanıcı oluşturun. Sonraki adımlarda bu kullanıcının giriş adını ve parolasını kullanacaksınız.

1. Administration → Single Sign On → Users and Groups: vcbridge-service kullanıcısını ve güçlü benzersiz parolasını oluşturun.
2. Giriş örneği vcbridge-service@vsphere.local. Kendi SSO domain’inizi kullanın. Kullanıcıyı Administrators grubuna eklemeyin.
3. Administration → Access Control → Roles altında aşağıdaki rolleri oluşturun. Nesnenin Permissions → Add ekranında yalnızca ilgili kapsamda atayın.

Yetki hatasında her şeye Administrator vermek yerine hata veren nesneyi ve ayrıcalığı inceleyin. Bağlantı testinin geçmesi, bütün yazma yetkilerinin doğru olduğunu tek başına kanıtlamaz.

Kontrol: Hesap müşteri klasörü ve seçilen kaynaklara erişebilmeli; altyapı VM’lerine güç/silme yetkisi olmamalıdır.

7. İlk işletim sistemi şablonunu hazırlayın

Nerede: Addons → VC Bridge Connect → Şablon hazırla

Ön koşul: Bu ekranı kullanmadan önce 8. adımdan WHMCS vCenter bağlantısını ve 9. adımdan sertifika doğrulamasını tamamlayın; ardından bu hazırlık adımına dönün.

Amaç: İndirdiğiniz işletim sistemi OVA’sını, her yeni müşteriye farklı IP ve parola uygulayabilen ana kopyaya dönüştürmek. Bunu hosting yöneticisi her imaj için bir kez yapar. VPS satın alan müşteri yapmaz. OVA’yı indirme ve vCenter’a içe aktarma işlemleri vCenter’da yapılır.

A — OVA’yı içe aktarın

1. vCenter’da VCBridge-Preparation adlı bir VM klasörü oluşturun. Buraya yalnızca yeni hazırlık kaynaklarını koyun; mevcut müşteri veya yönetim sunucularını taşımayın.
2. Deploy OVF Template ile OVA’yı bu klasöre aktarın. İmajın ilk root / Administrator parolasını hazırlayın. Başlangıç yöntemi tek disk ve tek desteklenen ağ kartı ister; ham/paylaşılan disk ve PCI passthrough kabul edilmez.
3. İmajda Tools zaten varsa ve çalışıyorsa C adımına geçebilirsiniz. Yoksa VM’yi açıp B adımını kullanın.

B — VMware Tools yoksa modülden kurun

vCenter API’nin VM içinde komut çalıştırması VMware Tools gerektirir. Bu yüzden Tools’un ilk kurulumu için farklı bir başlangıç bağlantısı kullanılır.

1. Modülün Şablon hazırla sekmesinde vCenter’ı seçip Hazırlık kaynaklarını getir / yenile düğmesine basın.
2. 0. Tools ve hazırlık araçlarını kurun bölümünden açık hazırlık VM’sini seçin.
3. Linux / FreeBSD: VM’nin mevcut IPv4 adresini ve SSH portunu girin. SSH root girişi açık olmalı; WHMCS sunucusu bu porta erişebilmeli; hazırlık VM’si kendi işletim sistemi paket deposuna ulaşabilmelidir. Bu geçici hazırlık adresini başka müşteriye tahsis etmeyin.
4. SSH anahtarını oku düğmesine basın. Modül bu aşamada parola göndermez. Gösterilen SHA256 değerini VM konsolunda ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub -E sha256 ile karşılaştırın. SSH başka anahtar türü seçtiyse ilgili ssh_host_…_key.pub dosyasını kullanın.
5. Eşleşiyorsa onaylayıp geçici root parolasını yazın. Kimliği doğrula ve Tools kurulumunu başlat düğmesine basın. Modül UUID ve MAC eşleşmesini kontrol eder; ardından işletim sisteminin paket yöneticisiyle VMware Tools ve hazırlık araçlarını kurar. Ubuntu 22.04/24.04 için cloud-init, netplan, growpart ve LVM; diğer desteklenen Linux sistemlerinde Python 3, growpart ve LVM paketleri de tamamlanır. Ubuntu kaynağında cloud-init devre dışı tutulur; ağ ayarları yalnızca ayrı hazırlık kopyasında yapılan hazırlıktan sonra ilk müşteri açılışında uygulanır. Tools zaten kurulu olsa da eksik paketleri tamamlamak için bu adımı kullanabilirsiniz. Parola veritabanına kaydedilmez. Genel sistem güncellemesi veya depo değiştirme yapılmaz.
6. Windows: Windows bölümünden Tools ISO’sunu bağla düğmesine basın. vCenter konsolunda Windows CD sürücüsünü açıp setup64.exe dosyasını çalıştırın. İstenen yeniden başlatmayı yapın. ISO bağlamak kendi başına sessiz kurulum değildir. Bu sürüm WinRM üzerinden otomatik Windows kurulumu yapmaz. ESXi’de uyumlu Tools ISO’su yoksa uygun resmî yükleyiciyi temin edin.
7. Tools durumunu kontrol et düğmesiyle Tools’un çalıştığını ve konuk işlemlerine hazır olduğunu doğrulayın. Kurulumun başlatılmış olması tamamlandığı anlamına gelmez. Linux/FreeBSD hatasında son işlemde verilen /var/tmp/vcbridge-tools-…/result.log günlüğüne bakın. Başarısı belirsiz kurulum otomatik tekrarlanmaz.

SSH kütüphanesi ZIP’e dahildir ve WHMCS’in kendi kütüphanelerinden ayrı ad alanında yüklenir. Composer, OpenSSL komut satırı veya PHP ssh2 eklentisi kurmanız gerekmez. Hosting sağlayıcınız PHP socket bağlantılarına ve hedef SSH portuna çıkışa izin vermelidir. SSH erişiminiz yoksa ekrandaki elle kurulum komutlarını VM konsolunda kullanın. Eski/EOL imajlarda paket depoları kapalı olabilir; sihirbaz bunları güvenilmeyen depolarla değiştirmez.

C — Ağı kapalı kontrol kopyasında hazırlayın

1. Tools doğrulanınca kaynak VM’yi işletim sisteminden kapatın. Modülde kaynakları yenileyin.
2. 1. Kontrol kopyası oluştur bölümünde kapalı kaynağı ve işletim sistemi yöntemini seçin; geçici root / Administrator parolasını girin.
3. Onaylayınca modül VCB-Prepare-… adlı ayrı bir tam kopya oluşturur. Bu kopyanın ağ kartı kapalıdır. Kaynak VM’nin diski, parolası ve ağ ayarları değiştirilmez. Disk kadar ek alan gerekebilir.
4. Cron uyumluluk denetimini ilerletir. Hazırlamaya uygun olduğunda Hazırla ve dosyaları doğrula düğmesine basın.
5. Kontrol kopyasına IP/parola uygulama hazırlığı yüklenir. Eksik Python, cloud-init, disk/ağ araçları veya desteklenmeyen disk düzeninde işlem gerekçeyle durur. Ağı kapalı bu kopya internetten paket indirmez; eksik aracın adı ekranda gösterilir. Kontrol kopyasını iptal edin, kaynak VM’yi açıp 0. adımdan paketleri tamamlayın; kaynağı kapatıp yeniden kontrol kopyası oluşturun. Eski dağıtımların kapanmış depoları otomatik olarak başka bir depoyla değiştirilmez.
6. Dosyalar doğrulandı olduğunda Temizle, kapat ve şablona dönüştür düğmesine basın. Ortak erişim bilgileri temizlenir, kopya kapanır ve şablon olur. Windows’un Sysprep özelleştirmesi sonraki müşteri kopyası kurulurken uygulanır.
7. Hazır sistemler sekmesinde seçenekleri yenileyip yeni VCB-Prepare-… şablonunu seçin; hedef host, datastore, ağ ve IP grubunu eşleştirin. İşletim sistemleri sekmesinde müşteriye gösterilecek adını ekleyin.
8. Bir test hizmetinde yeni IP, benzersiz parola, disk büyümesi ve erişimi doğrulayın. Sihirbazın dosya kontrolü gerçek ilk kurulum testinin veya imaj güvenlik taramasının yerine geçmez. Kaynak ve iptal edilen kontrol kopyaları otomatik silinmez.

Hazırlama yönteminin sınırları

• Ubuntu: 22.04 / 24.04, cloud-init + OVF, netplan ve growpart hazır olmalı. Otomatik kök disk büyütme tek sda diskinde ext4/xfs kök bölümünü veya tek PV / tek LV içeren LVM kökünü destekler; farklı düzen hazırlıkta reddedilir. LVM genişletmesi başarısız olursa kurulum tamamlandı bildirimi verilmez.
• Diğer Linux: systemd, Python 3.6+, VMware RPC aracı, growpart, LVM araçları, NetworkManager veya netplan; tek /dev/sdaN LVM PV ve mapper kök dosya sistemi. Her Linux/disk düzeni otomatik desteklenmez.
• FreeBSD: vmx0 ağ kartı, da0 üzerinde boot/swap/ZFS bölümleri ve zroot/ROOT/default. Farklı disk düzeni için özel hazırlık gerekir.
• Windows: VMware Tools, PowerShell 4+ ve VMware’in desteklediği Sysprep özelleştirmesi; etki alanına bağlı olmayan temiz imaj. Bu sihirbaz Windows 7 hazırlamaz.

vCenter yetkileri

Modül servis kullanıcısına yalnızca hazırlık klasöründeki kaynak ve kopyalar için gereken yetkileri verin: VM Clone, Create from existing, gerekli VM configuration/device/advanced ayarları, Power on/off, Guest Operations query/execute ve Mark as template. Hedef datastore için Allocate space, kaynak havuzu için Assign VM to resource pool ve ağ için Assign network gerekebilir. Windows ISO bağlama için VirtualMachine.Interact.ToolsInstall gerekir. Bu yetkileri tüm vCenter’a veya altyapı VM’lerine yaymayın. Yetki eksikse modül root hesabına geçmez.

Hazırlık parolası, şablon akışında WHMCS anahtarıyla şifreli saklanır; tamamlanma, iptal veya inceleme gerektiren hatada silinir. Hazırlık oturumu en fazla 24 saattir. Kaynak klasörünü boş ve yalnızca hazırlığa ayrılmış tutmak yöneticinin sorumluluğudur.

Kontrol: vCenter’da yeni bir kapalı şablon vardır; modülde kaydı “Şablon oluşturuldu” görünür. Satışa açmadan önce test hizmeti doğrulanmış olmalıdır. 1.0.23 sürümünde Ubuntu 24.04 OVA’sı ile gerçek WHMCS/vCenter kabul testi yapıldı: eksik cloud-init paketinin SSH üzerinden kurulması, ayrı kopyanın hazırlanıp şablona dönüşmesi, yeni kopyada IP ve benzersiz root parolası, kaynak parolanın reddi ve LVM kök diskin 20 GiB’dan 40 GiB’a büyümesi doğrulandı. Bu sonuç bütün OVA’ların veya diğer işletim sistemi yöntemlerinin aynı testten geçtiği anlamına gelmez. Kendi imajınızın ilk test kurulumunu tamamlayın.

8. WHMCS’e vCenter sunucusunu ekleyin

Nerede: WHMCS → System Settings → Servers → Add New Server

1. Bilgileri girip kaydedin.
2. Sunucuyu yeniden düzenleyin. Adres çubuğundaki id= değerini not edin. Bu WHMCS sunucu ID’sidir.
3. Servers sayfasında Create New Group ile VMware VPS adlı grup oluşturun; bu sunucuyu gruba ekleyip kaydedin.

Kontrol: Sunucu ve grubu listede görünür. Bağlantı testini, bir sonraki adımda TLS güven kaydını ekledikten sonra yapın.

9. vCenter sertifikasını doğrulayın

Nerede: Addons → VC Bridge Connect → vCenter bağlantıları

Bilgisayarınıza OpenSSL kurmanız veya vCenter’dan ZIP indirmeniz gerekmez. Bu bağlantıyı sizin tarayıcınız değil, WHMCS sunucunuz yapar. vCenter güvenlik duvarında WHMCS sunucunuzun çıkış IP’sine TCP 443 izni verin. Müşterilerinizin vCenter yönetim adresine erişmesi gerekmez.

1. Listeden WHMCS’te eklediğiniz vCenter sunucusunu adıyla seçin.
2. Sertifikayı sunucudan oku düğmesine basın.
3. vCenter adresi, sertifika adı, veren kuruluş, son geçerlilik tarihi ve SHA-256 parmak izi gösterilir. Bu aşamada vCenter kullanıcı adı/parolası gönderilmez.
4. Gösterilen adresi ve parmak izini kendi vCenter yönetiminizde doğrulayın; tarayıcının sertifika ayrıntılarındaki SHA-256 parmak iziyle karşılaştırabilirsiniz. İlk bağlantıdaki bir saldırganın sertifikasını yanlışlıkla kabul etmemek için bu kontrol gerekir.
5. Onay kutusunu işaretleyip Onayla ve bağlantıyı doğrula düğmesine basın.
6. WHMCS sunucu kaydındaki Test Connection düğmesini çalıştırın.

Kontrol: Sertifika ve vCenter kimliği doğrulanır. Modül PEM zincirini ve sha256// anahtar özetini kendisi hazırlar; sonraki bağlantılarda sertifika, hostname ve anahtar kontrol edilir.

“443 portuna erişilemiyor” hatası alırsanız hosting sağlayıcınızdan WHMCS çıkış IP’sini öğrenin; vCenter tarafındaki izinleri kontrol edin. Sertifika süresi dolmuşsa önce vCenter sertifikasını yenileyin. Sertifika anahtarı yenilenirse aynı okuma/onay adımlarını tekrar uygulayın. Gelişmiş PEM/özet girişi yalnızca mevcut sertifika kayıtlarını elle taşımak içindir.

Eski bir bağlantıyı kaldırma

1. vCenter bağlantıları → Kayıtlı bağlantılar bölümünde doğru sunucuyu bulun.
2. Bağlantıyı kaldır alanını açın, onay kutusunu işaretleyip Bağlantı kaydını kaldır düğmesine basın.
3. Hazır sistem/işletim sistemi, ürün sunucu grubu, WHMCS hizmeti veya devam eden şablon hazırlığı bu bağlantıyı kullanıyorsa işlem engellenir. Ekrandaki bağımlılığı inceleyin.

Yalnızca yerel bağlantı/sertifika kaydı ve envanter önbelleği kaldırılır. WHMCS’in Sunucular sayfasındaki kayıt, VM’ler, IP’ler ve lisans kapasite kayıtları değişmez. İptal edilmiş hizmet kaydı da hâlâ VM’ye bağlı olabileceğinden tek başına silme izni sayılmaz. İşlem vCenter’a bağlanmaz; eski sunucu kapalı olsa da kullanılmayan kayıt kaldırılabilir.

10. Hazır işletim sistemini ve kurulacağı yeri seçin

Nerede: Addons → VC Bridge Connect → Hazır sistemler

Bu ekranın amacı: “Ubuntu isteyen müşteriye hangi hazır işletim sistemini kopyalayalım, hangi fiziksel sunucuya kuralım, hangi ağdan IP verelim?” sorularını bir kez yanıtlamaktır. Paket fiyatını ve CPU/RAM/disk miktarını burada belirlemezsiniz.

1 — Sunucunuzdaki seçenekleri getirin

1. vCenter sunucunuzu adıyla seçin.
2. Sunucudaki seçenekleri getir / yenile düğmesine basın. Modül, hesabınızın görebildiği hazır şablonları, fiziksel sunucuları, klasörleri, disk alanlarını ve ağları okur.
3. Bir liste boşsa vCenter’da ilgili kaydın hazır olduğundan ve modül kullanıcısının onu görebildiğinden emin olun. Şablon listesinde yalnızca vCenter’da şablona dönüştürülmüş sistemler bulunur.

2 — Ne kurulacağını ve nereye kurulacağını seçin

Teknik vm-…, host-…, datastore-… gibi kimlikleri bulup yazmazsınız. Modül, isimle seçtiğiniz kayıtların kimliklerini arka planda kullanır. Seçilen fiziksel sunucuya bağlı olmayan depolama, ağ ve kaynak grubu kabul edilmez.

“Bu şablon nasıl hazırlanmış?” ne demek?

Yeni sunucu açıldığında IP ve parolanın işletim sistemine nasıl uygulanacağını seçersiniz. Sistem, şablonun işletim sistemi bilgisine göre öneri yapar; bu öneri şablonun gerçekten hazır olduğunun kanıtı değildir.

• Ubuntu — ilk açılışta otomatik yapılandırma: Şablonda cloud-init denen ilk açılış aracı kurulu ve uygun ayarlanmış olmalıdır.
• Diğer Linux veya FreeBSD — VC Bridge hazırlığı yapılmış: VMware Tools ve modülün IP/parola ayarlarını uygulayan konuk hazırlığı bulunmalıdır.
• Windows — ilk açılış hazırlığı yapılmış: VMware Tools ve Sysprep hazırlığı gerekir. Windows 7 için ayrıca Windows sürümü alanından Windows 7 seçilir.

Bu seçimi yapmak eksik araçları imajın içine kurmaz. Hazırlığı bilmiyorsanız şablonu hazırlayan kişiye doğrulatın. Ardından hazırlık onay kutusunu işaretleyin.

3 — IP adres grubunu seçin veya oluşturun

IP adres grubu, aynı ağdaki satılabilir adreslerin toplandığı listedir. İlk seferde Yeni IP adres grubu oluştur seçip Türkiye IPv4 gibi bir isim verin. Sağlayıcınızın verdiği ağ adresi, ağ maskesi, gateway ve DNS bilgilerini yazın. Başka bir işletim sistemi de aynı ağı kullanacaksa mevcut grubu seçin; ağ bilgileri otomatik dolar. Grup numarası otomatik oluşturulur. Satacağınız IP’leri 12. adımda eklersiniz.

4 — Kullanımdaki sunucuları ve IP’leri koruyun

Mevcut sunucularımı ve kullanılan IP’leri koru bölümünü açın. cPanel, Plesk veya yedekleme sunucuları görünüyorsa isimlerinden seçin. Modül onların teknik UUID kimliğini kendisi kaydeder. Hesabın görme yetkisi olmayan VM’ler listelenmez; modül bu yetkileri genişletmez.

Müşterilere kesinlikle verilmeyecek IP adresleri kutusuna kullanımdaki altyapı IP’lerini yazın; her satıra bir IP olabilir. vCenter IP’si, seçilen hostun görülebilen yönetim IP’leri ve gateway otomatik korunur. Önceden kaydedilmiş korumalar saklanır. Bu liste modülün işlem ve tahsis korumasıdır; ağ güvenlik duvarı veya IP sahteciliği engellemesi değildir.

Seçimleri kontrol et ve kaydet düğmesine basın. Her farklı hazırlanmış işletim sistemi şablonu için bu adımı tekrarlayın.

Kontrol: Hazır sistemler listesinde verdiğiniz isim görünür. Mevcut çalışan VM’ler bu kayıt işlemiyle taşınmaz veya yeniden kurulmaz. Aynı hazır sistemi farklı CPU/RAM miktarına sahip ürünlerde kullanabilirsiniz.

11. Müşterinin seçeceği işletim sistemini ekleyin

Nerede: Addons → VC Bridge Connect → İşletim sistemleri

Burada müşterinin sipariş verirken göreceği işletim sistemi adlarını hazırlarsınız. “Kaynak profil”, “ana plan” veya elle üretilmiş işletim sistemi numarası girmeniz gerekmez.

1. Listeden 10. adımda kaydettiğiniz hazır sistemi adıyla seçin.
2. Müşterinin göreceği adı yazın: örneğin Ubuntu 24.04 LTS.
3. Uyumlu Ubuntu hazırlığınız varsa isteğe bağlı hosting panellerini seçin. Ayrıntılar 15. adımda.
4. Kaydedin. Katalog numarası otomatik verilir ve aynı vCenter, fiziksel sunucu, klasör, disk alanı, ağ ve kaynak grubundaki uyumlu hazır sistemlere bağlanır.
5. Windows, Debian ve diğer hazır sistemler için tekrarlayın.

İşletim sistemi numarası nedir? Müşterinin seçtiği adın hangi şablona karşılık geldiğini belirleyen iç kayıt numarasıdır. Müşteri adı görür; modül numarayı kullanır. Örnek ürün oluşturucu seçenekleri kendisi hazırlar. WHMCS Configurable Options alanını elle düzenleyecekseniz tabloda verilen hazır seçenek değerini kopyalayın; rastgele numara yazmayın.

Kontrol: Eklediğiniz işletim sistemleri isimleriyle listelenir. Farklı sunucu veya ağdaki şablonlar yanlışlıkla aynı kurulum seçeneğine bağlanmaz.

12. Satılabilir IP adreslerini ekleyin

Nerede: Addons → VC Bridge Connect → IP adresleri

1. IP adres grubu listesinden 10. adımda isim verdiğiniz grubu seçin. Örneğin Türkiye IPv4. Plan kimliği yazmayın.
2. Sağlayıcınızın size tahsis ettiği tek IP’yi veya başlangıç ve bitiş adreslerini girin. Size ait olmayan adresleri eklemeyin.
3. Eklenen adresler önce dağıtıma kapalıdır. Kullanımda olanları kapalı bırakın.
4. Gerçekten boş adresleri seçip Müşteriye verilebilir yap işlemini uygulayın. Gerekirse toplu seçim kullanın.

Kullanımdaki cPanel/Plesk/vCenter ve diğer altyapı adreslerini satışa açmayın. Korunan adresler tahsise açılmaz. Hizmete bağlı adresler, VM silme işlemi doğrulanmadan serbest bırakılmaz.

Kontrol: İlk test siparişiniz için en az bir uygun ve müşteriye verilebilir IP görünmelidir.

Yanlış eklenen adresi tamamen silme

Kullanılmayan IP’leri işaretleyin; Kalıcı sil — havuzdan tamamen kaldır seçin, kalıcı silme kutusunu onaylayıp uygulayın. Boş, dağıtıma kapalı ve kullanım dışı adresler fiziksel olarak havuz tablosundan silinir. Hizmete bağlı, rezerve veya aktif tahsisteki adresler silinemez; bir satır uygun değilse toplu işlemin tamamı geri alınır. İşlem geçmişi ve geçmiş hizmet tahsisleri korunur. Sildiğiniz IP gerekirse yeniden, başlangıçta dağıtıma kapalı olarak eklenebilir. Bu işlev aynı sürümdeki merkezî kontrol servisi güncellemesini de gerektirir.

13. Eski ürün ekranından paketinizi oluşturun

WHMCS → System Settings → Products/Services → ürün → Module Settings

İsterseniz önce eklentinin Örnek ürünler → VPS + VDS örneklerini oluştur düğmesiyle iki gizli taslak ve ek seçeneklerini hazırlayın. İsterseniz WHMCS’te kendiniz ürün oluşturun.

1. Modül Adı: VC Bridge Connect seçin.
2. Kendi vCenter sunucunuzu içeren Sunucu Grubu seçin.
3. IP adres grubu ve Kurulacak hazır sistem listelerinden 10. adımda kaydettiğiniz isimleri seçin.
4. Temel CPU, RAM, disk, IPv4 ve trafik değerlerini aynı ekranda belirleyin. Trafik 0 ise limitsizdir. Disk, şablonun sanal diskinden küçük olamaz.
5. Ek kaynak satacaksanız teknik seçenek adlarını aşağıdaki örneğe göre yazın. Ürüne bağlamadığınız ek seçeneğin eşleştirme alanını boş bırakın.
6. İzin verilen işletim sistemi ID’lerini 11. adımda oluşturduğunuz katalogdan yazın; varsayılan ID bu liste içinde olmalı.
7. Kaynak politikası vps veya vds olsun. VDS’de vCPU başına MHz rezervasyonu host kapasitesine uygun olmalı.
8. Kaydedin. Kontrol servisi planı ve yerel profil arka planda eşleştirilir; bunları elle girmezsiniz.

Bu temel değerler pakete dahildir. Configurable Options miktarları bunların üzerine eklenir. Örneğin 2 temel CPU + 1 ek CPU = 3 vCPU. Fiyatlar Pricing ve Configurable Options bölümlerinde ayarlanır.

Taslaklar gizli, stok 0 ve otomatik kurulum kapalı oluşturulur. Ürün kaynaklarını değiştirmek çalışan VM’leri kendiliğinden değiştirmez. Bir hizmette ek kaynak satın alma işlemi Change Package akışından uygulanır. Satışa açmadan önce gizli test hizmetinde eşleştirmeyi doğrulayın.

14. Ek CPU, RAM, disk, IP ve diğer seçenekleri ayarlayın

Nerede: WHMCS → System Settings → Configurable Options

Demo ürün yolunu kullandıysanız seçenekler zaten oluşturulmuştur; aynı grubu tekrar açmayın. Mevcut grupta fiyatları ve miktar sınırlarını düzenleyin.

1. Elle oluşturuyorsanız Create a New Group seçin; grup adı yazın ve Assigned Products bölümünden ürününüzü seçip kaydedin.
2. Add New Configurable Option ile aşağıdaki teknik adı aynen yazın. | işaretinden önceki kısmı değiştirmeyin.
3. Option Type, alt seçenek, min/max ve fiyatları tabloya göre doldurup kaydedin.

Disk örneği

Temel disk 40 GiB, ek disk miktarı 2 ise toplam 40 + (2 × 5) = 50 GiB olur. GiB başına 10 TL istiyorsanız seçenek birim fiyatını 50 TL yazarsınız; miktar 2 için 100 TL eklenir. Bu fiyat yalnızca örnektir; kendi fiyatınızı belirleyin.

Diğer kurallar

• Temel kaynaklar pakete dahil miktardır. Ek seçenekler bunların üzerine eklenir. Min 0, müşterinin ek kaynak almadan sipariş verebilmesini sağlar.
• Her para birimi ve satışa açacağınız ödeme dönemi için fiyat girin. Teknik destek ücretini WHMCS alır; desteği siz sağlarsınız.
• 3/5/8 format değeri dönemlik toplam haktır; mevcut hakkın üzerine eklenmez. İlk kurulum ücretsizdir; yalnızca başarılı format hak tüketir.
• Sonradan kaynak satışı için ürünün Upgrades sekmesinde Configurable Options yükseltmesini açın. Ödeme sonrası kaynak artışı uygulanır; CPU/RAM için kısa yeniden başlatma gerekebilir.
• Disk küçültme veya farklı ana ürüne/hosta otomatik taşıma bu akışın parçası değildir.

Kontrol: Ürünün sipariş sayfasında OS ve panel seçimi, miktarlı kaynak alanları ve doğru fiyat görünmeli. Özel temanız standart configoption[…] alanlarını korumalıdır.

15. İsteğe bağlı hosting paneli kurulumunu açın

Paneli modül, yeni müşterinin VM’sine kurar. WHMCS hosting hesabınıza panel kurmaz. Örnek: müşteri Ubuntu 24.04 + HestiaCP seçer → Ubuntu klonlanır → IP/parola hazırlanır → HestiaCP kurulur → hazır olunca panel giriş bilgisi gösterilir.

1. 11. adımdaki Ubuntu katalog kaydında panel uyumluluğu açık olsun.
2. Paket en az 2 GiB RAM ve 30 GiB disk sağlamalı; şablon diski daha büyükse onu esas alın.
3. 14. adımdaki hosting_panel seçeneğini ürüne bağlayın. İlk/default seçenek none|Panel istemiyorum olsun.
4. Yeni VM’nin DNS ve paket depolarına erişimini sağlayın. Seçilen panelin yönetim portuna müşteri erişimi için uygun ağ kuralını açın.

Windows veya panelle eşleşmeyen OS seçildiğinde panel seçilmemelidir; sepette “Panel istemiyorum”a döner ve sunucu tarafında da kontrol edilir. Desteklenen şablon ve panel kaynakları ayrıca doğrulanır; panel üreticisinin her OS desteği modülde otomatik destek anlamına gelmez.

Modül izin verilen resmî kaynaklardan kurulum betiğini indirip SHA-256 kontrolü yapar. Sizin ayrıca panel kurulum deposu kurmanız gerekmez. Hash değişmişse kurulum durur; destek üzerinden kaynak güncellemesi gerekir.

Kontrol: Hizmet hazır olunca müşteri Ürün/Hizmet → Yönetim Paneli → Hosting paneli giriş bilgileri bölümünden adres, kullanıcı ve parolayı görür. Yönetim portu, web/e-posta/DNS servislerinin tüm gerekli portlarının yerine geçmez.

16. İki cron görevini kurun

İki farklı görev gerekir. WHMCS’in kendi cron’u fatura/ödeme/askı/sonlandırma takvimini yönetir. VC Bridge worker’ı başlamış VM işlerini takip eder ve ölçüm toplar. Biri diğerinin yerine geçmez.

WHMCS cron’u zaten kuruluysa ikinci kopyasını eklemeyin. WHMCS → Utilities → Automation Status ekranından durumunu; System Settings → Automation Settings üzerinden gösterilen komut/yol ve otomasyon ayarlarını kontrol edin. WHMCS sistem cron belgesi.

A. Önce gerçek dosya ve PHP yollarını öğrenin

Örnekler aşağıdaki varsayımlarla yazılmıştır. hesap, example.com ve whmcs kısımlarını kendi kurulumunuza göre değiştirin. Cron klasörünü taşıdıysanız WHMCS’in gösterdiği güncel yolu kullanın.

Bu PHP yolları örnektir; dosyanın varlığını ve sürümünü doğrulayın. Terminal varsa PHP_YOLU -v ile kontrol edin. check.php adımı da aynı PHP ile çalıştırılmalıdır.

B. cPanel’de ekleme

cPanel → Advanced → Cron Jobs

1. WHMCS görevi yoksa yeni görevde Minute */5, Hour/Day/Month/Weekday * seçin.
2. Command alanına sadece şu komutu, yolları düzelterek yazın:

/opt/cpanel/ea-php83/root/usr/bin/php -q /home/hesap/public_html/whmcs/crons/cron.php

3. VC Bridge için ikinci görev açın. Minute/Hour/Day/Month/Weekday alanlarının hepsine * yazın.
4. Command alanına sadece şu komutu yazın:

/opt/cpanel/ea-php83/root/usr/bin/php -q /home/hesap/public_html/whmcs/modules/addons/vcbridgeconnect/worker.php

cPanel’in Command alanına * * * * * yazmayın. Zamanı ayrı kutularda seçtiniz. Başlangıçta hata çıktısını gizlemeyin; görev hatası varsa hosting hesabınızın cron çıktısından inceleyin. cPanel cron belgesi.

C. Plesk’te ekleme

Websites & Domains → Scheduled Tasks → Add Task

1. Görev türünü Run a PHP script seçin, PHP sürümünü web sitenizle aynı yapın.
2. WHMCS görevi yoksa Script path alanında httpdocs/whmcs/crons/cron.php dosyasını seçin; çalışma aralığı 5 dakika, cron biçimi sunuluyorsa */5 * * * *.
3. İkinci görevi httpdocs/whmcs/modules/addons/vcbridgeconnect/worker.php için ekleyin; her dakika, cron biçimi * * * * *.
4. Run Now ile kontrol edip kaydedin. Script path alanına dosya yolu yazılır; PHP çalıştırıcısı veya zaman ifadesi eklenmez.

Dosya seçici yolunu esas alın. “Run a command” kullanırsanız Plesk’in chroot sınırı mutlak yolu engelleyebilir; hosting sağlayıcınızdan uygun CLI ortamını isteyin. URL çağırma görevini kullanmayın; worker yalnızca PHP CLI kabul eder. Plesk zamanlanmış görev belgesi.

D. Panelsiz Linux / crontab örneği

WHMCS dosyalarının sahibi kullanıcıyla crontab -e açın. Aşağıdaki örneklerde hem PHP hem dosya yollarını düzeltin:

*/5 * * * * /usr/bin/php -q /var/www/whmcs/crons/cron.php
* * * * * /usr/bin/php -q /var/www/whmcs/modules/addons/vcbridgeconnect/worker.php

Burada zaman alanları satırın içindedir. Webde farklı PHP, cron’da farklı PHP kullanmayın. Gerekirse çıktıyı web kökü dışındaki, kullanıcının yazabildiği log dosyasına yönlendirin ve log rotasyonu ayarlayın.

E. Cron’un çalıştığını doğrulayın

1. Aynı PHP ile ortam kontrolünü çalıştırın:

PHP_YOLU -q WHMCS_KOKU/modules/addons/vcbridgeconnect/check.php

PHP_YOLU ve WHMCS_KOKU yazılarını gerçek yollarla değiştirin; bunlar hazır komut değildir. Çıktıda ortam kontrolleri PASS olmalı; lisans/bağlantı PENDING ise önce ilgili kaydı düzeltin. Bu dosya VM oluşturmaz.

2. WHMCS Automation Status’ta sistem cron’unun güncel çalıştığını görün.
3. Worker’ın boşken sessiz bitmesi normaldir; tek başına hata yokluğu kurulumun tamamlandığını kanıtlamaz.
4. 17. adımdaki test hizmetinde kurulum aşamasının ilerlediğini ve hazır duruma geldiğini doğrulayın. Ölçümler ancak yönetilen VM ve kullanılabilir sayaç olduğunda görünür.

Kontrol: İki görev de hosting hesabında kayıtlı; WHMCS otomasyon zamanı güncel; test VM işi worker ile ilerliyor.

17. Bir test hizmetiyle kurulumu doğrulayın

1. Gizli ürün, düşük kaynak ve boşluğu doğrulanmış tek IP seçin. Kaynak şablon diskinden daha küçük disk vermeyin.
2. Bir test hizmeti oluşturun; Create çalıştırın. İşlem sürüyor mesajında yeniden bir hizmet açmayın; cron’un mevcut işi takip etmesini bekleyin.
3. Müşteri sayfasında doğru OS/IP/kaynak, root veya Administrator parolası ve varsa hosting paneli girişini doğrulayın.
4. Başlat/durdur/yeniden başlat ve parola değiştir işlevlerini deneyin. Başka müşterinin hizmet ID’sine giderek işlem yapılamadığını kontrol edin.
5. Aynı hizmette küçük bir kaynak artışı ve bir format uygulayın. IP’nin değişmediğini ve yalnızca başarılı formatın hakkı azalttığını kontrol edin.
6. Modül komutuyla sonlandırın. vCenter’daki VM silinmeli, IP havuza dönmeli; müşteri sayfası iptal mesajı göstermeli.
7. Fiyatları, stok/kapasiteyi, otomasyon ve yükseltme ayarlarını düzenleyin; ancak sonra ürünü görünür/satılabilir yapın.

Trafik ve güç takibi: yönetici eklentisinde fiziksel host ve yalnızca bu modülün müşteri VM’leri görünür. Müşteri kaynak tüketimi halkaları ve ölçüm tablosunu görür. Ağ toplamı alınabilen iki yönlü örneklerden hesaplanır; takvim ayına aittir. Cron kesintisindeki kayıp aralıklar tahmin edilmez. Trafik kotası otomatik ağ kesme/hız sınırlama uygulamaz. VM Watt değeri VMware’in sunduğu atıf/tahmin olabilir; faturalanabilir priz ölçümü olarak kabul etmeyin.

18. Ürünü müşterilere açın

Nerede: WHMCS → Products/Services → ürün düzenleme

1. Pricing altında ana paket ve Configurable Options altında tüm ek seçenek fiyatlarını kontrol edin.
2. Ürünün stok sınırını gerçek kapasitenize göre ayarlayın; demo stok 0 bırakılırsa sipariş alınmaz.
3. Module Settings otomatik kurulum seçeneğini ilk ödeme alındığında otomatik kur olarak belirleyin.
4. Automation Settings altında gecikmede askıya alma ve gerekiyorsa sonlandırma günlerini belirleyin.
5. Gizli ürün işaretini kaldırın; sipariş sayfasını müşteri gibi açıp OS/panel, ek kaynaklar ve toplam fiyatı kontrol edin.

Kontrol: Sipariş ve ödeme sonrasında kurulum başlar; müşteri hizmet sayfasında ilerlemeyi ve hazır olunca IP/parolayı görür.

Sorun giderme ve güncelleme

Güncelleme

1. WHMCS dosyaları, veritabanı ve şifreleme anahtarını içeren configuration.php yedeğini alın.
2. Modül worker’ını geçici durdurun; yeni modül dosyalarını aynı dizinlere yükleyin.
3. Ortam/bağlantı kontrolünü yapıp worker’ı tekrar açın. İşlem/sahiplik tablolarını silmeyin.

Önceki dosyaya dönüşte protokol uyumunu sağlayıcıyla doğrulayın. Eski DB yedeğine bağımsız dönüş mevcut VM/IP sahipliğiyle çakışabilir.

Destek kaydına ne yazmalısınız?

WHMCS/PHP/vCenter/ESXi sürümü, hata metni, hizmet ID, görev ID, hata zamanı ve hangi adımda kaldığınız. Parola, lisans gizli anahtarı veya configuration.php içeriğini göndermeyin.