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