NetCRM Kurulum Dokümanı v1.3.1
Transkript
NetCRM Kurulum Dokümanı v1.3.1
Kurulum Dökümanı Sürüm : 1.3 Güncelleme Tarihi: 08.03.2013 Hazırlayan: Canan ADAMOĞLU, Proje Uzmanı, CRM Çözümleri İçindekiler 1 Versiyon Bilgisi................................................................................................................................. 2 2 Ön Bilgi ............................................................................................................................................ 3 3 NetCRM Kurulum ve Güncelleme İşlemleri ..................................................................................... 4 4 Karşılaşılabilecek Hatalar ve Çözümleri ......................................................................................... 14 4.1 Hata 1: ................................................................................................................................... 14 4.2 Hata 2: ................................................................................................................................... 15 4.3 Hata 3: ................................................................................................................................... 15 4.4 Hata 4: ................................................................................................................................... 16 4.5 Hata 5: ................................................................................................................................... 16 4.6 Hata 6: ................................................................................................................................... 17 5 NetCRM’e Giriş .............................................................................................................................. 18 6 NConnector Kurulum ve Güncelleme İşlemleri ............................................................................. 19 1 1 Versiyon Bilgisi Versiyon Tarih Değişiklik Özeti Değişikliği Yapan v1 25/07/2012 İlk yazım Canan Adamoğlu v2 06/11/2012 v2.1 26/12/2012 v3 04/03/2013 Kurulum için eklenen .exe dosyalarına istinaden revize edildi. Genel düzenleme yapıldı. SSO ile birlikte gelen yeni setup dosyası için revize edildi. 2 Canan Adamoğlu Canan Adamoğlu Canan Adamoğlu 2 Ön Bilgi NetCRM kurulumu yapılmadan önce SSO kurulumu yapılmış olmalıdır. SSO sunucusu, NetCRM veri tabanı sunucusu, NetCRM uygulama sunucusu ve eğer kullanılıyorsa Netsis Temelset uygulama ve veri tabanı sunucuları farklı konumlarda bulunabilir. Bu makinaların ağ üzerinde birbirleri ile iletişim sağlayabilmeleri yeterlidir. v1.3 sürümümüz için olan gereksinimler aşağıdaki gibidir, ileri sürümlerimizde, gelişen teknoloji ile beraber bu beklenen özellikler de değişiklik gösterebilir. o Kurulum yapılacak sunucular en az “ Windows Server 2003” olmalıdır. o NetCRM kurulumu yapılan sunucularda aynı zamanda “MS Exchange Server” kurulu olması uygulamanın bazı özelliklerinde beklenmeyen sorunlar yaratabildiğinden dolayı kurulumun farklı bir sunucuya yapılması tavsiye edilmektedir. o NetCRM in kurulacağı veri tabanı sunucusunda aşağıdaki programlar yüklenmiş olmalıdır: o “Domain Controller” olan sunuculara kurulum yapılamamaktadır. MSSQL 2005 veya üst sürümler (SQL Express desteklenmemektedir.) NetCRM in kurulacağı uygulama sunucusunda ise aşağıdaki programlar yüklenmiş olmalıdır. Zaten NetCRMSetup.exe dosyası çalıştırıldığında, ilgili programların yüklü olup olmadığı kontrol edilecek, eğer yüklü değilse yüklenmesi için gerekli linke yönlendirilecektir. o IIS6 veya üst sürümler (IIS Express desteklenmemektedir.) o ASP.NET MVC 3.0 o .NET Framework 4.0 (MVC 3.0 kurunca otomatik kuruluyor.) o Microsoft Report Viewer 9.0.0.0 (Bazı durumlarda raporlar için gerekebiliyor. Aşağıdaki adresten indirilebilir.) (http://www.microsoft.com/download/en/details.aspx?id=577) NetCRM bünyesinde, Netsis Temelset ile cari, stok, teklif ve sipariş entegrasyonu isteniyorsa, NConnector uygulamasının kurulumu yapılmalıdır. o o NConnector kurulacak uygulama sunucusunda bulunması gerekenler aşağıdaki gibidir: Netsis Temelset NetOpenX 5.0 IIS 6 veya üst sürümler (IIS Express desteklenmemektedir.) NConnector kurulacak veri tabanı sunucusunda bulunması gerekenler aşağıdaki gibidir: MSSQL 2005 veya üst sürümler (SQL Express desteklenmemektedir.) (Netsis Temelset veri tabanı kullanılacaktır.) 3 3 NetCRM Kurulum ve Güncelleme İşlemleri NetCRM kurulum, güncelleme ve kaldırma işlemleri için NetCRMSetup.exe dosyası kullanılacaktır. Bu dosya, NetCRM veri tabanı ve uygulama sunucuları ayrı ise, önce veri tabanı sunucusunda olmak üzere her iki sunucuda da çalıştırılmalıdır. Mevcut veri tabanlarının yedekleri, yapılan güncelleme işlemlerinde CRM_OLD.bak ismiyle, kaldırma işlemlerinde ise CRM.bak ismiyle, C:\Program Files (x86)\Netsis\CRM\Db\DbBackup_1.3.0.0 klasörüne kaydedilecektir. Dosya çalıştırıldığında öncelikle karşımıza dil seçimi ekranı gelecektir. Dil seçilip ‘Tamam’ denir. ‘İleri’ butonuna tıklanır. 4 Burada kurulumu yapılacak olan bileşenler seçilecektir. Örneğin veri tabanı sunucusu ayrı ise, uygulama sunucusuna kurulum yaparken “NetCRM Veri Tabanı” seçeneğinin yanından ‘Kaldır’ seçilmelidir. Veri tabanı sunucusuna kurulum yaparken ise sadece bu seçenek kalmalı, diğer seçenekler için ‘Kaldır’ seçilmelidir. ‘Kaldır’ seçeneği, var olan bir kurulum varsa kaldırılacağı, yoksa da yeni bir kurulum yapılmayacağı anlamına gelmektedir. Örneğin sadece veri tabanı kurulumu yapılacaksa aşağıdaki gibi seçilmelidir. 5 Sadece uygulama kurulumu yapılacaksa da tam tersi şekilde seçilmelidir. Seçimler yapıldıktan sonra ‘İleri’ butonuna tıklanır. 6 Bu ekranda ise uygulama kurulumu için gerekli programların kurulu olup olmadığı kontrol edilecektir. Bu ekran, uygulama kurulumu yapılmıyor, sadece veri tabanı kurulumu yapılıyor ise karşımıza gelmeyecektir. Ön koşullar yerine getirildiğinde ‘İleri’ butonuna tıklanır. 7 Bu ekranda veri tabanı bilgileri girilecektir. (...) butonuna tıklanmalıdır. 8 NetCRM veri tabanının bulunacağı sunucuda olmamız gerekmektedir. Bu sunucunun ismi seçilir, gerekli kullanıcı adı ve şifre yazılır. Yazılan bilgiler ile bağlantı sağlanılıp sağlanamadığı ‘Test Connection’ butonu ile kontrol edilebilir. Eğer yeni kurulum yapılıyorsa bu aşamada veri tabanına bağlanmak için ‘master’ veri tabanı seçilmelidir. Yapılan işlem güncelleme ise mevcut NetCRM veri tabanı seçilmelidir. Bilgiler tamamlandıktan sonra ‘OK’ butonuna tıklanır. Bir önceki ekran, yazdığımız veri tabanı bilgileri ile dolmuş olacaktır. 9 Eğer yeni kurulum yapılıyorsa NetCRM veri tabanına verilecek isim buradaki ‘Veritabanı Adı’ alanına mutlaka yazılmalıdır. Yapılan işlem güncelleme ise mevcut NetCRM veri tabanının ismi yazılan bilgilerden otomatik olarak ‘Veritabanı Adı’ alanına gelecektir. İstenilen bilgiler tamamlandıktan sonra ‘İleri’ butonuna tıklanır. 10 Bu ekran, uygulama kurulumu yapılmıyor, sadece veri tabanı kurulumu yapılıyor ise karşımıza gelmeyecektir. ‘AJM Servis Port’, sabit 2023 bırakılmalı, değiştirilmemelidir. Burada aynı sunucuda SSO Servisi varsa, adresi otomatik olarak gelecektir. SSO kurulumu başka bir sunucuda ise ilgili adresleri bulmak için ‘Servis Ara’ butonuna tıklanmalı ve servis seçilmelidir. Ardından ‘Doğrula’ butonu ile de bağlantı sağlanılıp sağlanamadığı kontrol edilmeli ve gereken diğer adreslerin otomatik dolması sağlanmalıdır. ‘Dış Erişim Adresi’ olarak NetCRM’e dışarıdan ulaşılacak adresin yazılması gerekmektedir. Burada http://IZMNB172/ yazılması, programa http://IZMNB172/NetCRM yazılarak ulaşılabileceği anlamına gelecektir. ‘SSO STS URL’ olarak da ‘Merkezi Kimlik Yönetimi’ giriş ekranına ulaşılacak adres yazılmalıdır. Örneğin; SSO ile NetCRM kurulumu aynı makinede ise http://DışErişimAdresi/NetsisSts yazılmalıdır, eğer SSO farklı bir sunucuda ise http://SSO’nunDışErişimAdresi/NetsisSts yazılmalıdır. ‘NTF Comet URL’ bölümünde de yine SSO’nun kurulu olduğu sunucuya dışarıdan ulaşılacak adres olmalıdır. http://SSO’nunDışErişimAdresi/NetsisComet yazılmalıdır. SSO kurulumu ile beraber kurulan NTF (Bildirim) Servisi’ni kullanmak için ise ‘Bildirim Servisini Yapılandır’ seçeneği işaretli olmalı ve ilgili adresler dolu olmalıdır. 11 Bu ekranda girilecek adreslerin sonunda / olup olmamasına örnek ekran görüntüsündeki gibi olacak şekilde dikkat edilmelidir. NetCRM içerisine eklenen belgelerin nereye kaydedileceği de buradaki ‘Dosya Yükleme Konumu’ndan ayarlanabilir. Uygulama ve veri tabanı kurulumu aynı sunucuya yapılıyorsa, bu ekranda tekrar veri tabanı bilgilerini değiştirmemek gerekmektedir. Ama eğer veri tabanı kurulumu yapılmıyorsa, bir önceki ekran gelmeden doğrudan bu ekran gelecektir. Bu durumda uygulamanın bağlanacağı veri tabanı bu ekranda (...) butonu aracılığıyla seçilmelidir. Gerekli bilgiler yazıldıktan sonra ‘İleri’ butonuna tıklanır. Kurulum işlemi tamamlandığında ise aşağıdaki ekranda ‘Son’ butonuna tıklanır. 12 13 4 Karşılaşılabilecek Hatalar ve Çözümleri 4.1 Hata 1: Kurulumlarda ASP.NET MVC3 yüklediğiniz halde aşağıdaki hatayla karşılaşıyorsanız: .NET Framework 4.0 IIS’e register olmamış demektir. Aşağıdaki komutu çalıştırınız. 64-bit bilgisayarlar için: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir 32-bit bilgisayarlar için: %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -ir 14 4.2 Hata 2: “%windir%\system32\inetsrv\config\applicationHost.config” dosyasındaki ‘Deny’ değerleri ‘Allow’ yapılarak düzeltilir. 4.3 Hata 3: NetCRM’de resimler görüntülenemiyor. Yazılan adres ile resimlere ulaşılamıyor demektir. NetCRM’de kullanılan resim ve script dosyaları, kurulum yapılan makine üzerinde tutulmaktadır, herhangi bir dış (external) adres üzerinden yüklenmemektedir. Programın kurulum yapılan makine üzerinden kullanılabilmesi için, hem bu makinenin bulunduğu ağ üzerinden hem de (dışarıdan da kullanılacaksa) Internet üzerinden erişilebilen bir adresin belirli olması gerekir. Ağ içindeki makinelerden dış adrese ulaşılamıyorsa aşağıdaki yöntemlerden biri uygulanmalıdır. i. Domain söz konusu ise DNS üzerinde ilgili FQDN’in iç IP’ye yönlendirmesi yapılmalıdır veya dış adrese ulaşacak her makinenin hosts dosyasına gerekli tanımlama yapılmalıdır. ii. Domain yoksa NAT tablosunda dış adresin iç adrese çevrilmesi işlemi yapılmalıdır. Aşağıdaki web sayfalarını da inceleyebilirsiniz: http://www.tomshardware.co.uk/forum/12532-17-iptables-access-local-server-external http://stackoverflow.com/questions/5858757/redirect-requests-for-external-ips-to-a-local-ip 15 4.4 Hata 4: Programa girişte aşağıdaki hatayı alıyorum. Hata Oluştu: No row with the given identifier exists[Netsis.CRM.Entity.CustomerSimpleEntity#1] CUSTOMER tablosunun içeriği silinmiştir. Bu tabloda STATUSID kolonunda 0 olan satır silinmemelidir. Yeniden eklemek için; SET IDENTITY_INSERT ON CUSTOMER INSERT INTO CUSTOMER (CUSTOMERID, CUSTOMERNAME, CUSTOMERTYPEID,STATUSID,ACCOUNTID) VALUES(1,'',2,0,0) SET IDENTITY_INSERT CUSTOMER OFF 4.5 Hata 5: Güncelleme sonrası programa girişte aşağıdaki hatayı alıyorum. (Benzer SQL hataları için de geçerlidir.) 16 Güncelleme işleminde bir sebepten dolayı DBUpdate çalışmamıştır. Mevcut CRM veri tabanındaki CRMVERSION tablosundaki maksimum versiyona göre DBUpdate dosyası çalıştırılmalıdır. İlgili DBUpdate dosyası CRM Ekibi’nden temin edilebilir. Not: ‘Login failed user’ hatası için, yazılan SQL bilgileri (kullanıcı adı ve şifresi gibi) kontrol edilmeli, doğruları yeniden yazılarak program güncellenmelidir. 4.6 Hata 6: Kurulum/Güncelleme sonrası programa girişte aşağıdaki hatayı alıyorum. (Ambiguous Match Exception (Belirsiz Eşleştirme Hatası) ) '/NetCRM' Uygulamasında Sunucu Hatası. Belirsiz eşleştirme bulundu. Açıklama: Geçerli web isteği yürütülürken işlenmemiş özel durum oluştu. Lütfen hata ve kod içinde kaynaklandığı yer hakkında daha fazla bilgi almak için yığın izlemesini gözden geçirin. Özel Durum Ayrıntıları: System.Reflection.AmbiguousMatchException: Belirsiz eşleştirme bulundu. Bu hatanın çözümü için gerekli dll dosyası Yazılım Destek Merkezi’nden ya da CRM Ekibi’nden temin edilebilir. 4.7 Hata 7: Programa girişte aşağıdaki hatayı alıyorum. 17 5 NetCRM’e Giriş 1. Programa giriş yapabilmek için SSO üzerinden lisans tanımlamaları ve NetCRM veri tabanı bağlantı bilgileri kaydedilmelidir. Gerekli bilgiler SSO yardım dökümanında mevcuttur. 2. NetCRM güncellemelerinde, SSO yardım dökümanında anlatılan NetInfo.NSS dönüşümü yapılmayacaktır. Güncelleme işlemlerinde de aynı yeni kurulum gibi yeni lisanslama yapılması gerekmektedir. Her iki durumda da lisanslama için satış birimlerinden destek alınabilir. 3. Yeni NetCRM kurulumunda şifresi net1 olan NETSIS kullanıcısı yaratılır. Kurulum ve güncelleme işlemlerinde lisans tanımlamaları ve veri tabanı bağlantı bilgilerinin kaydedilmesinin ardından, mevcut NetCRM kullanıcılarının SSO kullanıcıları ile eşleştirilmeleri gerekmektedir. Eğer SSO kullanıcısı yoksa yeni SSO kullanıcısı yaratılmalıdır. Bu işlem “SSO Admin Console” ya da “NetCRM –Ayarlar/Kullanıcı İşlemleri” üzerinden yapılabilir. Nasıl yapılacağı SSO ve NetCRM’in yardım dökümanlarında anlatılmaktadır. SSO’da yer almayan kullanıcılar ile NetCRM’e giriş yapılamayacaktır. 4. Programa ulaşılacak adres; 1.1.1.1 sunucunun dışa açık adresi olmak üzere, http://1.1.1.1/NetCRM dir. 5. Program bütün tarayıcı türlerinde çalışmaktadır, ancak tarayıcının güncel versiyon olması gerekmektedir. Önerilen tarayıcı versiyonları; Internet Explorer 9, Google Chrome 16, Mozilla Firefox 9 , Safari 5.1 ve üst versiyonlarıdır. 6. Programın yardım dokümanına programın içerisinden (sol üstteki butonu aracılığıyla) ulaşılabilecektir. 7. NetCRM'in mobil uygulaması, "Apple App Store" ve " Google Play" üzerinden "Netsis CRM" adıyla indirilebilmektedir. Uygulama 'Android (2.2 ve üzeri)' ya da 'iOS (4.0 ve üzeri)' işletim sistemi kullanan akıllı telefonlarda ve tabletlerde desteklenmektedir. Mobil uygulama ile programa erişmek için, NetCRMSetup.exe dosyası ile ‘NetCRM Mobil Adaptörü’ de kurulmuş olmalıdır. Bu kurulum ile IIS’te Default Web Site’ın altında MobileCRM için application oluşturulmuştur. 1.1.1.1 dışa açık adresiniz olmak üzere, http://1.1.1.1/MobileCRM/CrmMobileService.svc?wsdl adresine dışarıdan ulaşılması gerekmektedir. Dışarıya açık bu adres Netsis CRM Ekibi’ne bildirilmelidir. Uygulamaya mobil üzerinden girmek için, normal kullanıcı adınızın başına size verilecek ön eki, örneğin xxxx/ yazmanız gerekmektedir. Örneğin kullanıcı adınız netsıs ve şifreniz net1, verilen ön ek xxxx ise, aşağıdaki bilgiler ile mobil uygulamaya giriş yapabilirsiniz. Kullanıcı: xxxx/netsıs Şifre: net1 18 6 NConnector Kurulum ve Güncelleme İşlemleri NConnector kurulum, güncelleme ve kaldırma işlemleri için NConnectorSetup.exe dosyası kullanılacaktır. Bu dosya, Netsis veri tabanı ve uygulama sunucuları ayrı ise, önce veri tabanı sunucusunda olmak üzere her iki sunucuda da çalıştırılmalıdır. Dosya çalıştırıldığında öncelikle karşımıza dil seçimi ekranı gelecektir. Dil seçilip ‘Tamam’ denir. ‘İleri’ butonuna tıklanır. 19 Burada kurulumu yapılacak olan bileşenler seçilecektir. Örneğin veri tabanı sunucusu ayrı ise, uygulama sunucusuna kurulum yaparken ‘Veritabanı’ seçeneğinin yanından ‘Kaldır’ seçilmelidir. Veri tabanı sunucusuna kurulum yaparken ise sadece bu seçenek kalmalı, ‘NConnector’ seçeneği için ‘Kaldır’ seçilmelidir. ‘Kaldır’ seçeneği, var olan bir kurulum varsa kaldırılacağı, yoksa da yeni bir kurulum yapılmayacağı anlamına gelmektedir. Örneğin sadece veri tabanı kurulumu yapılacaksa aşağıdaki gibi seçilmelidir. 20 Sadece uygulama kurulumu yapılacaksa da tam tersi şekilde seçilmelidir. Seçimler yapıldıktan sonra ‘İleri’ butonuna tıklanır. 21 Bu ekranda Temelset şirketi için veri tabanı bilgileri girilecektir. (...) butonuna tıklanılmalıdır. 22 Netsis Temelset veri tabanının bulunacağı sunucuda olmamız gerekmektedir. Bu sunucunun ismi seçilir, gerekli kullanıcı ve şifre yazılır. Yazılan bilgiler ile bağlantı sağlanılıp sağlanamadığı ‘Test Connection’ butonu ile kontrol edilebilir. Bu aşamada veri tabanı olarak Netsis Temelset veri tabanı seçilmelidir. Bilgiler tamamlandıktan sonra ‘OK’ butonuna tıklanır. Bir önceki ekran, yazdığımız veri tabanı bilgileri ile dolmuş olacaktır. 23 Uygulama bölümünde; Netsis Temelset’e giriş yaparken kullanılan kullanıcı adı ve şifre yazılmalıdır. NetCRM’den açılan kayıtların Netsis Temelset’te hangi şubeye aktarılacağı şube koduna yazılmalıdır. NetCRM’den açılan teklif ve siparişlerde yazılacak depo kodu yazılmalıdır. Temelset tarafında lokal depo uygulaması kullanılmıyorsa ‘0’ yazılmalıdır. Sunucu adı ekran görüntüsünde görüldüğü şekilde sonunda / ve başında http:// ile yazılmalıdır. İstenilen bilgiler tamamlandıktan sonra ‘İleri’ butonuna tıklanır. 24 Kurulum işlemi tamamlandığında ise aşağıdaki ekran açılacaktır. Burada yazan NConnector adresi, NetCRM içerisinde, “Ayarlar-Hesap Ayarları” bölümündeki “Connector Adresi” sahasına yazılmalıdır. Adres alındıktan sonra ‘Son’ butonuna tıklanır. 25
Benzer belgeler
konu başlığı
yapabilmesi için SSO yönetim konsolundan eşleştirilmiş olması gerekmektedir. Eşleştirme işlemini SSO – Merkezi Kimlik Yönetimi dokümanında bulabilirsiniz.
Detaylı