Programlama Kılavuzu MS48IP IP Santrali
İçindekiler AMAÇ...3 KARELPORT CİHAZ KAYIT İŞLEMİ...3 1. Yeni Santral Ekleme... 3 2. Santral Bilgilerinin Girilmesi... 3 3. Lisans Anahtarlarının ve Karelport Profilinin Atanması... 4 MS48IP KNE AYARLARI...5 MS48IP SERİSİ IP SANTRALLERİNDE KARELPORT AYARLARI...6 4. Dış Hatların Servis Sağlayıcılara Atanması... 7 5. Karelport a Dış Hat Erişim Bilgilerinin Gönderilmesi... 9 KARELPORT ÜZERİNDE KAYIT İŞLEMİN TAMAMLANMASI...9 PROBLEM GİDERME... 10 2
Amaç Bu doküman MS48IP IP santralleri kullanıcılarını Karelport üzerinden lisans aktivasyonu ve Karelport a kayıt prosedürleri konusunda bilgilendirmek amacı ile hazırlanmıştır. Bu dokümanda yer alan talimatlar MS48IP model IP santralleri için geçerlidir. Karelport Cihaz Kayıt İşlemi 1. Yeni Santral Ekleme Karelport a kullanıcı girişi yapıldıktan sonra KAREL SYNC tıklanır. Açılan KAREL SYNC ekranından Yeni Cihaz Ekle seçeneği tıklanır. Şekil 1. 2. Santral Bilgilerinin Girilmesi Karşınıza gelen Yeni Cihaz Ekleme ekranında santral modeli olarak MS48IP seçilir, ve garanti belge numarası, ürün seri numarası, santrale verilecek isim ve santralin kurulu olduğu lokasyondaki telekom alankodu girilir. Uluslarası Ürün Lisans Sözleşmesi nin okunduğu ve kabul edildiğine dair onay verilerek Devam Et butonu tıklanır. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 3/17 3
Şekil 2. 3. Lisans Anahtarlarının ve Karelport Profilinin Atanması Karelport Karel lisans sunucusundan santraliniz için atanmış lisans anahtarlarını çeker ve santralin Karelport a bağlanması için gerekli SIP profili bilgileri ile birlikte aşağıdaki ekranda sunar. Şekil 3. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 4/17 4
Tamamla butonu tıklayarak işlemi sonlandırmadan, MS48IP Karel Ağ Bileşenleri (KNE) arayüzlerinden Karelport SIP profilinin santrale programlanması gereklidir. MS48IP KNE ayarları Santrale bağlandıktan sonra; Trunk'ın IP'si girilir. alt kısımda çıkan sekmelerden Bağlan tıklanır ve KNE ile santral arasındaki bağlantı kurulur. Şekil 4. Karşılaşılan ekranın herhangi bir bölümüne sağ tıklanır ve Kayıt ve Proxy seçilir. Şekil 5. Kayıt ve Proxy seçildikten sonra açılan ekrandaki sekmelerden Karel Port olanı seçilir. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 5/17 5
Şekil 6. Bu formda Kullanıcı Adı ve Şifre alanlarına Karelport tarafından atanan SIP profili parametreleri girili, ve alt kısımda önce Programla sonra da Register butonları tıklanır. MS48IP Serisi IP Santrallerinde Karelport Ayarları Yeni bir web tarayıcı sayfası açılır ve santralin IP adresi adres çubuğuna yazılır. Santralin programlama sayfalarına giriş arayüzü kullanıcı adı ve şifre yazılarak santralin web arayüzüne giriş yapılır. MS48IP Serisi VoIP48 için versiyon AAG ve MS için versiyon CCC daha sonraki sürümleri KarelPort uygulaması gerçekleştirilebildiği için versiyon kontrolü yapılır. Sistem Yöneticisi Programı eğer bilgisayarınızda yüklü değil ise ürünle birlikte gelen CD'den bilgisayarınıza kurulmalıdır. Sistem Yöneticisi Programı kurulduktan sonra programa şifre ile giriş yapılır. Sistem Yöneticisi Programı programından Sistem tıklanır. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 6/17 6
Şekil 7. Sistem Parametreleri üzerine çift tıklanınca açılan sayfada KAREL PORT Modu parametresi AÇIK olarak ayarlanır. Şekil 8. 4. Dış Hatların Servis Sağlayıcılara Atanması Sistem Yöneticisi ana menüsüne gelinir. Sol menüden Dış Hatlar alanına girilir. Bu alandan Servis Sağlayıcı seçilir. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 7/17 7
Şekil 9. Servis Sağlayıcı bölümünde sistemdeki mevcut dış hat sayısı kadar dış hattın listelendiği bir ekran ile karşılaşılacaktır. Bu ekranda her dış hat için o dış hatta hizmet alınacak servis sağlayıcısı/tipi seçilmelidir. Dış Hatlar menüsünde Servise Açma/Kapama üzerine çift tıklanır. Şekil 10. Açılan sayfada 13 numaralı dış hattın Servise Açık olarak ayarlı olmasına dikkat edilir. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 8/17 8
Şekil 11. 5. Karelport a Dış Hat Erişim Bilgilerinin Gönderilmesi MS48IP web arayüzünden Ayarlar: KarelPort bölümüne gelinir. Bu bölümde daha önceden kaydedilmiş dış hat numaralarının tanımlanması ve KarelPort'a kaydedilmesi hedeflenir. Kaydedilmek istenen numara için Ekle butonuna basılır ve açılan satırda istenilen bilgiler doldurulur. İşlem bütün tanımlı dış hatlar için tekrarlanır. Şekil 12. Karelport Üzerinde Kayıt İşlemin Tamamlanması MS48IP santrali üzerindeki işlemler başarı ile tamamlandıktan sonra, Karelport sayfasına dönerek Tamamla butonu tıklanır. Karel Elektronik San. Ve Tic. A.Ş. Sayfa 9/17 9
Şekil 13. Güncellenerek açılan Cihazlarım sayfasında yeni kaydedilen santral ile ilgili detay bilgileri görüntülenebilir, santral bilgileri sorgulanabilir ve yeni santral kayıt işlemi başlatılabilir. Şekil 14. Problem Giderme Problemin nerede olduğunu görebilmek için KNE'den trunk'a bağlanılır, ekranın herhangi bir yerinden sağ tıklanarak Durum ve Bilgilendirme seçilir. Durum ve Bilgilendirme ekranına gelindiğinde Shift+D'ye basılır. Aşağıdaki ekran ile karşılaşılır. Karel Elektronik San. Ve Tic. A.Ş. 1 Sayfa 10/17 0
Şekil 15. Sağ altta çıkan liste hatanın nerede olduğunu görmemizi sağlar. Listede geçen maddelerin karşısında hata var ise FAIL, başarılı ise OK yazar. Eğer FAIL olan satıra tıklanırsa sorunun çözümü için yapılacaklar kısa bir şekilde gözükecektir. Daha ayrıntılı çözüm için aşağıdaki açıklamalara bakınız. Hata kontrolü yapılacaksa başarısız olunan ilk satırdan başlanmalıdır. Çoğunlukla bir hata sonraki adımlarda oluşacak diğer hatalara yol açmaktadır. Karşılaşılabilecek Problemler ve Çözümleri 1. Trunk init işlemi: Trunk yazılımı başlangıçta konfigürasyon dosyalarını okur (Bu dosyalar Linux sisteminde /karel/home/conf altındadır) ve bazı yapılar için hafızdan alan ayırır. Bu işlemler sırasında hata görürse yazılım doğru başlamayacak demektir. Bu sorunun oluşması için pek çok neden olabilir. Eğer konfigürasyon dosyaları ile ilgili bir durum varsa bu dosyalar yok edilip yazılım tekrar başlatılabilir. Bu durumda yazılım başlangıç değerleriyle başlar. Hafıza ile ilgili bir sorun varsa sistem seviyesinde bir incelemeye ihtiyaç vardır. 2. Sistem DNS adresi: Sistem DNS adresinin doğru girilmesi gerekiyor çünkü Portal için yapılan HTTP kayıt işleminde bu adres kullanılıyor. Sorunun çözümü için web üzerinden sisteme bağlanıp DNS adresinin doğru girilmesi gerekiyor. (a) MS48IP için - Web ara yüzünden http://santral_ip_adresi:24001 ile bağlanın. Karel Elektronik San. Ve Tic. A.Ş. 1 Sayfa 11/17 1
- Solda bulunan Ayarlar altındaki Ağ Ayarları sayfasından DNS adresini doğru şekilde girin. (b) DS200 için - Web ara yüzünden http://santral_ip_adresi:3802 adresine bağlanın. - Sistem sayfasında DNS Devrede seçilecek ve DNS adresi doğru olarak girilecek. 3. Trunk DNS adresi: Trunk yazılımı sistemden bağımsız olarak ayrıca bir DNS adresi kullanır. Bu adresin doğru girilmemesi portal işlemlerinde soruna yol açar. Eğer adres doğru girilmemişse KNE ile Trunk yazılımına bağlanıp Ağ Ayarları sayfasından girilmelidir. İkinci DNS adresinin girilmesi zorunlu değildir. 4. Trunk DNS Bağlantısı: DNS adresinin doğru girilmesi bu adrese bağlantının her zaman sorunsuz sağlanacağı anlamına gelmez. Bu nedenle Trunk yazılımı çalışmaya başladıktan sonra DNS adresini kontrol eder ve eğer doğruysa bu adresle iletişime geçer. Eğer aradaki bağlantıda sorun varsa (Örneğin firewall gibi) DNS bilgileri alınamayacağı için DNS'e bağlı işlemlerde sorun yaşanır. Portal adresi DNS üzerinden alınamayacağı için de Portal'a kayıt işlemleri yapılamaz. Çözümü için sistem yöneticisiyle görüşüp DNS adres bilgisini almalısınız. Kısaca kullanıcı başka bir PC de ya da sistemde doğru çalıştığına emin olduğu bir DNS adresi edinmeye çalışmalıdır. 5. Master bağlantısı: Trunk yazılımı çalışmaya başladıktan sonra ilk işlemlerinden birisi Master ile TCP bağlantısını kurmak olacaktır. Bu bağlantı olmadan Master dan almak zorunda olduğu bilgileri alamaz. Öncelikle KNE aracılığıyla Ayarlar sayfasından Master adresini kontrol ediniz. Aynı sistemde hem Master hemde Trunk çalışıyorsa 127.0.0.1 girilmelidir. Master ve Trunk ın aynı sistemde çalıştığı kurulumlarda doğrudan bağlantı kurulduğu için firewall ayarları etkisizdir.. Ama bazı özel durumlarda bu iki yazılım ayrı sistemlerde çalışırlar ve firewall ayarlarının da buna göre düzenlenmesi gerekir. Bir diğer durumda birden fazla Trunk yazılımının aynı Master a bağlanmasıdır. Telnet ile bağlanarak sistem bilgilerinden bu durum gözlemlenebilir. Aşağıdaki adımlar uygulanmalıdır: - Telnet 192.168.174.190 komutu ile sisteme bağlanın. - Kullanıcı adı ve şifre girildikten sonra netstat tan komutunu girin. Bu sayede sistemdeki TCP bağlantıları görülecektir. - Trunk için TCP portu 12173 portudur. Bu port numarasının geçtiği satırı bulun. Bu satırdaki IP adresi Master a bağlantı kuran Trunk yazılımının adresini gösterir. Eğer bu adres 0.0.0.0 adresi ise o sırada bağlantı yok demektir. 6. Trunk yazılımı lisans bilgisini Master dan alır ve bu bilgiyi kullanarak çalışır. Eğer Master bağlantısı sağlanmışsa bu bilginin Master dan alınması beklenir. Alınan lisans bilgisinde kullanılabilecek en fazla kanal sayısı vardır. KNE ile Trunk yazılımına bağlanınca kullanıcı lisanslı kanal sayısını görebilir. KNE de ilk sayfada görülen Kanal Sayısı bilgisi lisans sayısını gösterir. Eğer bu sayı 0 dan farklı ise sistem doğru çalışır. Kanal sayısı 0 olması durumunda lisans işlemleri kontrol edilmelidir. IDEA ile bağlanarak Lisans Tablosu sayfası gözden geçirilebilir. 7. Trunk yazılımı Master bağlantısı kurduktan sonra Lisans bilgileri dışında PBX bilgilerini de almaktadır. PBX bilgileri Master tarafından hazırlanıp Trunk yazılımına gönderilir ve Trunk yazılımı tarafından Portal HTTP kayıt işleminde kullanılır. PBX bilgileri, Mac adresi, Master versiyon bilgisi, santral kapasitesi ve santral tipini içermektedir. Bu aşamada hata olması durumunda Trunk ve Master yazılımları arasında bağlantı sorunu var demektir. Eğer kullanıcı bağlantı Karel Elektronik San. Ve Tic. A.Ş. 1 Sayfa 12/17 2
kontrolünü yapmışsa ve bağlantı varsa, iki yazılım arasında versiyon uyumsuzluğu olduğu düşünülebilir. 8. Portal HTTP kayıt işleminde santrale ait Servis Sağlayıcılar Tablosu (UMTH Tablosu) Portal a aktarılır. Bu sayede Portal o santrale ait iletişim bilgilerini edinmiş olur. Trunk yazılımı HTTP kayıt işleminden önce bu tabloyu Master yazılımından almak zorundadır. Eğer tabloyu alamazsa ya da gelen tabloda format uyumsuzluğu varsa işlem başarılı olmaz. Hata durumunda şu kontroller yapılmalıdır. - Master bağlantısının sağlandığı görülmelidir. - DS200 için IDEA yazılımı ile MS48IP için http://santral_ip_adresi:24001 adresini kullanarak Web arayüzünden bağlantı sağlanır. - IDEA yazılımında KarelPort Servis Sağlayıcılar Tablosu, Web sayfasında da Ayarlar altında KarelPort sayfası seçilerek UMTH bilgileri kontrol edilir. - DS200 sistemlerde Erişim Kodu bilgisi özellikle kontrol edilmelidir. Bu kolona uygun port girilmez ise sistem yanlış çalışmaktadır. UMTH Tablosu boş ise bilgilerin alınması doğru olarak gözükür ama Portal a doğal olarak UMTH tablosu gönderilmez. Ayrıca kullanıcı IDEA ya da web üzerinden UMTH tablosunu değiştirirse durum anında Trunk yazılımına aktarılır ve Trunk yazılımı gereken değişiklikleri Portal ile iletişim kurarak otomatik olarak gerçekleştirir. 9. Portal SIP Kayıt İşlemi: Portal a HTTP kayıt işlemi yapılmadan önce SIP kayıt işlemi yapılır. SIP kayıt işlemi için gereken bilgiler (Kullanıcı adı ve şifre) Portal dan elde edilir. Portal ın ilgili sayfası açılarak bu bilgiler kopyala/yapıştır kullanılarak kolayca Trunk a aktarılır. SIP kayıt işleminde Portal a ait DNS adı otomatik olarak gelir kullanıcı bunu değiştiremez. Hata durumunda dikkat edilecek noktalar aşağıdadır: - DNS bağlantısının bu aşamadan önce mutlaka sağlanmış olması gerekir. - KNE ile Trunk yazılımına bağlanır ve SIP Sunucu Ayarları sayfasına gider. Bu sayfada mutlaka KarelPort sekmesi seçili olmalıdır. - Sinyalleşme yöntemi mutlaka UDP seçilmeli ve port olarak 5060 değeri girilmiş olmalıdır. - Kayıt Aktif seçeneği mutlaka seçili olmalıdır. - Karel Port sayfasındaki kullanıcı adı ve şifre ile KNE den girilen bilgiler karşılaştırılmalıdır. - Bazı uygulamalarda gerekli firewall/yönlendirme işlmeleri yapılmadığı için mesajlaşma sağlanamamaktadır. Wireshark açılarak bu durum görülebilir. Eğer böyle bir sorun varsa sistem yöneticisi ile bu durum aşılmalıdır. 10. PBX id bilgisinin alınması: SIP kayıt işlemi Portal a HTTP kayıt olma işlemini tetikler. Bu durumda Trunk yazılımı master dan aldığı PBX bilgilerini kullanarak Portal a PBX i kayıt eder. Bu işlemin başarılı olması durumunda kayıt edilen PBX için Portal dan bir id dönecektir. B değerin 0 dan farklı olması beklenir. Hata durumunda şu adımlar kontrol edilir. - Sistem DNS bilgilerinin doğru olması gereklidir. - PBX bilgilerinin Master dan doğru olarak alınmış olması gerekmektedir. - Trunk HTTP portunu kullanarak Portal a bilgi aktarabilir olması gerekir. Firewall kullanılarak ya da başka bir nedenle bağlantısının önlenmemiş olması zorunludur. Karel Elektronik San. Ve Tic. A.Ş. 1 Sayfa 13/17 3
11. Trunk yazılımı HTTP kayıt işlemi gerçekleşince (Bir önceki maddede söylenenler bu maddede de aynen geçerlidir) PBX id nin yanı sıra PBX in ait olduğu şirketin company id denilen bilgisini de gönderir. Bu değerin de 0 dan farklı geçerli bir değer olması beklenmektedir. 12. Portal da üzerinde çalıştığımız PBX e ait bağlantı bilgilerinin bulunması gerekmektedir. Bu amaçla son adım olarak bu bilgiler Trunk tarafından aktarılır. Birden fazla bağlantı bilgisi (UMTH bilgisi) olması durumunda her bir bilgi ayrı bir adım olarak aktarılır. Tablonun tamamının aktarılması sonrasında bu adım başarılı sayılır. Eğer hata varsa şu kontroller yapılmalıdır. - 10. maddede anlatılan kontroller yapılmalıdır. - UMTH bilgileri kullanıcı tarafından doğru girilmiş olmalıdır. Hata kontrolü yapılacaksa başarısız olunan ilk satırdan başlanmalıdır. Çoğunlukla bir hata sonraki adımlarda oluşacak diğer hatalara yol açmaktadır. Karel Elektronik San. Ve Tic. A.Ş. 1 Sayfa 14/17 4