SİSTEMNET · YAZILIM GELİŞTİRME ÇÖZÜMLERİ

SN Serisi Santral Entegrasyonu
Kurulum Sunumu

Avaya · Cisco · Tegsoft · Alcatel-Lucent · Ericsson-LG · Nortel santralleri için saha kurulum rehberi — adım adım komutlar, kontrol listeleri ve kabul testleri.

SNS-KR-2026-001Sürüm 1.0Eylül 2026

Kurulum Sunumu

İçindekiler

Kurulum öncesi hazırlık (D-Day -1)
SN Collector kurulumu (sunucu tarafı)
Avaya CM entegrasyonu — 15 dk
Cisco CUCM entegrasyonu — 25 dk
Tegsoft entegrasyonu — 10 dk
Alcatel-Lucent OXE entegrasyonu — 20 dk
Ericsson-LG iPECS entegrasyonu — 10 dk
Nortel CS1000 entegrasyonu — 15 dk
SN uygulamalarını bağlama (API anahtarı)
Kabul testleri ve devir teslim
Sorun giderme tablosu
Devir teslim kontrol listesi

⏱️ Toplam süre hedefi: Tek santral için 60-90 dakika. Aynı lokasyonda ek santraller +20-30 dk/santral.

Bölüm 1

Kurulum Öncesi Hazırlık

Kuruluma çıkmadan önce (D-Day -1) kontrol listesi

Santral modeli + yazılım sürümü teyit edildi (ekran görüntüsü alındı)
PBX yönetici hesabı (SAT/web admin) geçici olarak tahsis edildi
SN Collector sunucusu hazır: Ubuntu 22.04+, 4 vCPU/8 GB/500 GB, statik IP
Collector IP'si PBX VLAN'ına ulaşıyor (ping + port testi yapıldı)
Firewall talepleri 48 saat önce açıldı (şartname Bölüm 6 tablosu)
Ajan listesi CSV alındı: ad,soyad,dahili,e-posta
Kayıt sunucusu bilgileri alındı (SNTRM dinleme özelliği için)
Kurulum formu çıktıları yazdırıldı (bu sunum + teknik şartname)

Port erişim testi (Collector sunucusundan)

# Santral yönüne erişim:
nc -zv <PBX-IP> 5051   # Avaya CDR
nc -zv <CUCM-IP> 22    # Cisco SFTP
nc -zv <Tegsoft-IP> 443  # Tegsoft API
nc -zv <OXE-IP> 2533   # Alcatel CSTA

# Santralden Collector yönüne (dinleme):
ss -tlnp | grep -E '9000|5005|2533'

⚠️ Port testleri kuruldan önce yapılmalı. Açılmayan portla sahaya çıkmayın — en sık gecikme sebebi budur.

Bölüm 2

SN Collector Kurulumu (Sunucu Tarafı)

SN Collector; tüm santral connector'larını çalıştıran tek Linux servisidir. Kurulum 10 dakikadır.

# 1) Sistemnet deposundan kurulum paketi:
wget https://cdn.sistemnet.com.tr/sn-collector/sn-collector-1.0.0.deb
sudo dpkg -i sn-collector-1.0.0.deb

# 2) Site kimliğini tanımla:
sudo nano /etc/sn-collector/config.yml
---
site_id: "musteri-adi-merkez"
token: "<lisans-anahtari>"       # Sistemnet'in verdiği lisans
forward_url: "https://apps.sistemnet.local/api/callev"

# 3) Servisi başlat ve otomatik açılışa al:
sudo systemctl enable --now sn-collector
sudo systemctl status sn-collector    # "active (running)" beklenir

# 4) Canlı log izleme (kurulum boyunca açık tutun):
journalctl -u sn-collector -f

✅ Başarı işareti: Log'da collector started · listening :9000/:5005 satırını görürsünüz.

Bölüm 3 · ~15 dakika

Avaya Communication Manager Entegrasyonu

1SAT'e bağlan

→

2CDR servisi tanımla

→

3Format ayarla

→

4Test çağrısı

→

5SNCDR doğrula

SAT komutları (sırayla)

change ip-services
  Service Type: CDR1    Server: cli    Port: 5051
  Local Node: procr     Reliable Session: y
  Peer Address: <Collector-IP>

change system-parameters cdr
  Primary CDR Output Format: unformatted
  Record Type 1: all-calls
  Digits to Cover for CDR: 15

# Bir test dahilisi için CDR açık mı kontrol:
display station <dahili>   →  "Corridor / CDR" alanları

Doğrulama

SAT'ten status cdr-link → established olmalı
Collector log: [avaya-cdr] connected from <CM-IP>
Test çağrısı yap → SNCDR'da 5 sn içinde görünmeli

⚠️ CM 8.0+ sürümlerde TLS zorunlu: change ip-interface üzerinden sertifika yükleyin veya geçici olarak Secure: n bırakıp müşteri güvenlik onayı alın.

Bölüm 4 · ~25 dakika

Cisco CUCM Entegrasyonu

1SFTP hesabı aç

→

2CDR Management ekle

→

3Enterprise Param.

→

4AXL kullanıcısı

→

5Poller testi

Adım adım

SFTP hazırla (Collector'da):

sudo useradd -m -s /bin/bash sncdr
sudo mkdir -p /home/sncdr/cdr && sudo chown sncdr:sncdr /home/sncdr/cdr
sudo passwd sncdr   # güçlü parola — Cisco tarafına girilecek

CUCM → Cisco Unified Serviceability → Tools → CDR Management → Add New: Host <Collector-IP>, User sncdr, Path /cdr, Protocol SFTP. "Add Success" mesajını görün.
Enterprise Parameters: CDR Enabled = True, CDR Log Calls with Zero Duration = True, Call Diagnostics = True.
AXL kullanıcısı: User Management → Application User snaxl → Role: Standard AXL API Access. Parolayı Collector config'e yazın.

Poller testi: bir test çağrısı sonrası dosya düşüşünü izleyin:

watch -n5 'ls -lt /home/sncdr/cdr | head -3'
# 15 dk içinde CDR_YYYYMMDD.* dosyaları düşer (Cisco push 5-15 dk gecikmeli)
sudo systemctl restart sn-collector   # poller derhal çeksin

ℹ️ Cisco toplu (batch) teslim eder: gerçek zamanlı ihtiyaç varsa CCT/AXL kanalı da açılır (Sistemnet saha ekibi yapar). SNCDR'da çağrılar en geç 15 dk içinde listeye düşer.

Bölüm 5 · ~10 dakika

Tegsoft Entegrasyonu

En hızlı entegrasyon — Tegsoft REST API + AMQP sunar, PBX komutu gerekmez.

Tegsoft Admin → Kullanıcılar: snsvc adında API kullanıcısı açın, rol: Rapor (salt-okunur).

Collector config:

sudo nano /etc/sn-collector/connectors/tegsoft.yml
---
connector: tegsoft
base_url: "https://<tegsoft-sunucu>/api/v1"
user: snsvc
pass: "<parola>"
amqp:
  host: "<tegsoft-sunucu>"
  port: 5671          # TLS
  vhost: tegsoft
  queue: sn.events
  routing: "call.*.agent.*"

Test:

sudo systemctl restart sn-collector
journalctl -u sn-collector -f | grep tegsoft
# "amqp subscribed · queue=sn.events" beklenir
# Tegsoft'ta test çağrısı → 2-3 sn içinde event düşer

✅ Tegsoft entegrasyonu canlı akış sağlar: çağrı bitimi → SNCDR'da görünme < 5 sn.

Bölüm 6 · ~20 dakika

Alcatel-Lucent OmniPCX Enterprise (OXE) Entegrasyonu

1MAM'a bağlan

→

2CSTA link aç

→

3CDR tanımla

→

4Extension listesi

→

5Test çağrısı

4635/4760 konsol veya MAM (Web admin) üzerinden

# 1) CSTA link (canlı çağrı kontrolü):
install → create csta_link
  Name: SNCOL      IP: <Collector-IP>    Port: 2533
  Protocol: cstaa (CSTA Phase 3)

# 2) CDR çıktısı:
cdractions → create cdr_output
  Format: extended      Destination: <Collector-IP> : 9000

# 3) Dahili listesi export (ajan eşlemesi için):
create pbx_extension_list → export
  Yöntem: FTP   Host: <Collector-IP>   Path: /import/oxe-ext.csv

Doğrulama

Collector log: [alcatel-csta] link established + [alcatel-cdr] listening :9000
Dahili-dahili test çağrısı → SNCDR 5 sn içinde
OXE tarafında csta status → link active

⚠️ OXE'de CDR "extended" format seçilmelidir; "standard" seçilirse ajan eşlemesi eksik kalır.

Bölüm 7 · ~10 dakika

Ericsson-LG iPECS Entegrasyonu

iPECS Web Admin'e girin (http://<pbx-ip>, admin hesabı).
System → SMDR:

Parametre Değer

SMDR Output Enable

Protocol TCP/IP

SMDR TCP Port 5005

SMDR Format Standard

Include Internal Calls Yes
System → IP Settings → SMDR Destination: IP <Collector-IP>, Port 9000.
Kaydet & reboot etki alanı — iPECS SMDR değişikliği anında etkindir, santral reset gerekmez.
Test: dahili-dahili çağrı → Collector log: [ipeccs-smdr] line received 59 bytes → SNCDR'da kayıt.

Parametre	Değer
SMDR Output	Enable
Protocol	TCP/IP
SMDR TCP Port	5005
SMDR Format	Standard
Include Internal Calls	Yes

✅ iPECS'in SMDR'si sabit 59 byte'lık ASCII satırlardır; Collector otomatik parse eder — ek ayar gerekmez.

Bölüm 8 · ~15 dakika

Nortel CS1000 Entegrasyonu

⚠️ Önce tercih sırası: ① Avaya Aura'a migrate edildiyse Bölüm 3'ü uygulayın. ② PostGres/Oracle RDB varsa RDB polling kullanın. ③ Yalnızca klasik CS1000 kalmışsa aşağıdaki LD 117 yöntemi uygulanır.

LD 117 — CDR tanımı (MAT/CLI üzerinden)

LD 117
  REQ: new
  CDR: yes
  FCD: 1          # Format 1 (CSV benzeri)
  PORT: <Collector-IP> 5005
  TRC: 30         # Kayıt tutma/trace süresi

# Kontrol:
LD 117 → REQ: prt   # tanımları listele

RDB polling alternatifi

# /etc/sn-collector/connectors/nortel.yml
---
connector: nortel-rdb
db: postgres
host: <cs1000-rdb-ip>   port: 5432
db_name: nortel         user: readonly
poll_sec: 300           # 5 dk'da bir incremental
query: "SELECT * FROM call_detail WHERE id > :last_id"

ℹ️ CS1000 telnet CDR'ı 2017+ sürümlerde deprecated — müşteriye RDB veya migration önerin; sunumda bu notu paylaşın.

Bölüm 9

SN Uygulamalarını Collector'a Bağlama

Her SN uygulaması kendi ayarlar ekranından Collector API'sine bağlanır. Demo anahtarı üretim anahtarıyla değiştirilir.

Uygulama	Ayar Konumu	Girilecekler
SNCDR	Sağ üst ⚙ Veri Kaynağı	API URL: `https://<collector>:9443`, Token, Site ID
SNTRM	Ayarlar → Entegrasyon	Aynı + Recording Base URL (kayıt sunucusu)
SNSR	Ayarlar → Yakalama	Ajan oturum kaynağı: Collector WS
SNPMS	Ayarlar → Oda Eşleme	Dahili ↔ oda CSV yüklenir
SNMASKE	Ayarlar → Kural Motoru	Collector URL (popup maskeleme için)

Bağlantı testi

# Collector'dan uygulamaya test olayı gönder:
snctl send-test-event --type inbound --ext 2001
# SNCDR'da "TEST" etiketli kayıt görünmeli

Bölüm 10

Kabul Testleri ve Devir Teslim

Uygulanacak test seti (şartname Bölüm 9 ile birebir)

Test 1: Dahili-dahili çağrı <5 sn'de SNCDR'da
Test 2: Dış arama trunk/numara doğru
Test 3: Cevapsız çağrı "Kaçtı" rozetiyle
Test 4: Extension → ajan adı eşlemesi
Test 5: SNTRM "Dinle" oynatıcı çalışıyor
Test 6: Popup numarayı maskeli gösteriyor (SNMASKE)
Test 7: Collector restart → olay kaybı yok (spool)
Test 8: 50 eşzamanlı çağrı yük testi

Devir teslim paketi

İmzalı Kabul Tutanağı (SAT sonuç tablosuyla)
Uygulanan PBX komutlarının ekran görüntüleri / yedek config
Collector config yedeği: tar czf sn-collector-yedek.tar.gz /etc/sn-collector
Kullanıcı hesapları + şifre zarfı (müşteri kasasına)
Bakım sözleşmesi + SLA kartı (7/24 hat, erişim süreleri)

✅ Kabul: 8/8 test geç → tutanak imzala. Eksik test → 5 iş günü içinde düzeltme taahhüdü.

Bölüm 11

Sorun Giderme Hızlı Tablosu

Belirti	Olası Neden	Çözüm
SNCDR'da hiç kayıt düşmüyor	Port kapalı / yanlış IP	`nc -zv` ile test; PBX'te hedef IP'yi doğrula
Avaya: cdr-link established ama kayıt yok	Format yanlış (unformatted seçilmedi)	`change system-parameters cdr` → Format: unformatted
Cisco: dosyalar düşmüyor	SFTP parolası/klasör yetkisi	CDR Management → Test Connection; `/cdr` sahipliği
Tegsoft: AMQP bağlanmıyor	5671 değil 5672 açık / vhost yanlış	Port ve vhost'u admin'den teyit et; TLS sertifikası
Alcatel: CSTA link inaktif	Protocol cstaa seçilmedi	Link'i sil-yeniden oluştur; OXE tarafında restart
iPECS: satırlar bozuk	Format "Detailed" seçilmiş	Format: Standard yap (59 byte)
Ajan adları boş	Extension eşleme dosyası yüklenmedi	CSV'yi SNCDR ⚙ → Ajan Eşleştirme'den yükle
Zamanlar 3 saat kayık	PBX saat dilimi UTC	PBX NTP/tz ayarla veya Collector'da `tz_offset`
Restart sonrası kayıp	Spool kapalı	`config.yml → spool: enabled` + disk alanı kontrol

Destek

7/24 Sistemnet Destek: +90 212 677 88 88 · destek@sistemnet.com.tr — Kurulum ID'sini (site_id) hazır bulundurun.

Bölüm 12

Devir Teslim Kontrol Listesi

SN Collector kurulu, otomatik açılışta, lisans aktif
Santral connector'ı(ları) "connected" durumda (journalctl doğrulandı)
SNCDR canlı veri görüyor; SNTRM kayıt dinleyebiliyor
Ajan eşlemesi yüklü; SNPMS oda eşlemesi girildi (otel ise)
SNMASKE kuralları müşteriyle birlikte revize edildi
Kabul testleri 8/8 → tutanak imzalı
Yedek arşivi (config + PBX ekran görüntüleri) teslim edildi
Müşteri ekibine 60 dk temel eğitim yapıldı (SNCDR filtreleri, SNTRM değerlendirme)
Bakım/SLA kartı teslim edildi; acil durum numarası test edildi
Google Drive proje klasörüne tüm dokümanlar yüklendi

Sistemnet Bilgi ve İletişim Sistemleri A.Ş. · Oruçreis Mah. Vadi Cad. Giyimkent Sitesi No:170/436 Esenler/İstanbul · +90 212 677 88 88 · sistemnet@sistemnet.com.tr

SN Serisi Santral EntegrasyonuKurulum Sunumu

İçindekiler

Kurulum Öncesi Hazırlık

Kuruluma çıkmadan önce (D-Day -1) kontrol listesi

Port erişim testi (Collector sunucusundan)

SN Collector Kurulumu (Sunucu Tarafı)

Avaya Communication Manager Entegrasyonu

SAT komutları (sırayla)

Doğrulama

Cisco CUCM Entegrasyonu

Adım adım

Tegsoft Entegrasyonu

Alcatel-Lucent OmniPCX Enterprise (OXE) Entegrasyonu

4635/4760 konsol veya MAM (Web admin) üzerinden

Doğrulama

Ericsson-LG iPECS Entegrasyonu

Nortel CS1000 Entegrasyonu

LD 117 — CDR tanımı (MAT/CLI üzerinden)

RDB polling alternatifi

SN Uygulamalarını Collector'a Bağlama

Bağlantı testi

Kabul Testleri ve Devir Teslim

Uygulanacak test seti (şartname Bölüm 9 ile birebir)

Devir teslim paketi

Sorun Giderme Hızlı Tablosu

Destek

Devir Teslim Kontrol Listesi

SN Serisi Santral Entegrasyonu
Kurulum Sunumu