DotNetNuke nasıl kurulur, sorunları nasıl giderilir? DotNetNuke, DotNetNuke kurulumu, DotNetNuke sorun giderme, DotNetNuke kurulumunda karşılaşılan sorunlar, DotNetNuke nedir? DotNetNuke nerede kullanılır ? DotNetNuke çözümleri, DotNetNuke nasıl kurulur, sorunları nasıl giderilir? DotNetNuke hakkında bilmek istedikleriniz.

     DotNetNuke, iyi bir portal muamma. Neden derseniz cevabım hazır, bu kadar karmaşık bir yapı Microsoft'a yakışır. Evet uzun zamandır ilgilendiğiniz hazır web site portallarından sıkıldınız ve ASP, ASP.NET ile yazılmış ücretsiz dağıtımı olan bir script portala terfi etmeyi düşünüyorsunuz, hayır böyle bir terfi yöntemi olmadığını size en başından söylemeliyim. Bu olsa olsa aşağı yönde (downgrade) bir terfi sayılabilir. Çünkü Microsoft bağımlısı sistemlerin en büyük zaafı olarak herhangi bir ayarlamanın değiştirilmesi veya bir başka ayarla ilişkilendirilmesi çok büyük uğraşlar gerektiriyor. Downgrade sözcüğü ile asıl kastedilenin bu olduğunu da belirtmek gereklidir. Çünkü DotNetNuke kategorisinde PHP ile hazırlanmış ve aynı biçimde topluluklar tarafından geliştirilmiş JOOMLA'ya sıkı bir rakip olmakla birlikte, ASP kullanılarak üstelik .NET mimarisi ve FrameWork desteği ile çalışan, en popüler içerik yönetim sistemidir (CMS Contenent Managment System).

DotNetNuke Kurulumu ve olası Kurulum sorunlarının giderilmesi. 

1 - DotNetNuke için tüm kurulum açıklamalarında hemen hemen aynı cümle ile başlanır, "Öncelikle http://www.dotnetnuke.com adresine gidip ücretsiz üyelik yapıp daha sonra sitenin download bölümünden DotNetNuke install veya DotNetNuke Starter versiyonlarından birini edinin. Starter mı yoksa Install mı diye sorduğunuzu duyar gibiyim, install olanı indirin aralarında son kullanıcı açısından çok az modül ve işletim farklılıkları var tabii ki biz en gelişmiş versiyon olmasını istediğimiz sitemiz için Install'u seçerek kuracağız.

2 - DotNetNuke sitesinden indirdiğiniz zipli paketi kendi bilgisayarında açıp veya sunucu tarafına gönderirken açmayı tercih ederek gönderiniz.

3 - Bu aşamada akıllara takılan soru şudur : DotNetNuke sitenizde bir alt klasörde mi bulunmalıdır yoksa root diye tabir edilin doğrudan yazılan web adresinizin hedef aldığı ana klasör de mi yer almalıdır.

     Cevap : DotNetNuke çalışmak için bir alt klasör gereksinimi duymaz ancak alt klasörde de çalışabilir. Örneğin dotnetnuke kurulumunu isterseniz benimsitem.com/ adresine doğrudan yapabileceğiniz gibi benimsitem.com/herhangibir klasörünede yapabilirsiniz. Peki hangisi daha avantajlı olur sorusunun basit cevabı ise benimsitem.com/ daha mantıklı ve kullanışlı olur diyebiliriz.

      Diğer dikkat edilmesi gereken husus ; DotNetNuke içerisindeki kurulum yönergesinde anlatılan sanal klasör, yani Virtual Directory'nin gerekip gerekmediğidir. Kurulum yönergesinde bahsedilen kurulum çeşidi kendi bilgisayarınızı web sunucu yaptığınızı varsaydığı için sunucu tarfına yapılan kurulumlarda Virtual Directory oluşturulması gerekmemektedir.

4 - benimsitem.com/herhangibir klasöre veya benimsitem.com/ anadizinine kurulum yapabilmeniz için yapmanız gereken sunucu ayarlamaları aynıdır. Eğer benimsitem.com dizinine kurulum yapacaksanız hosting firmanız ile görüşüp sunucunuzda yüklü olan windows'a benimsitem.com adresinize ftp ile bağlandığınızda gördüğünüz httpdocs klasörü için Network Services veya Windows 2000 sistemler için ASPNET Account kullanıcısının Read, Write, Change izinlerine sahip olmasını istediğinizi söylemeniz gerekmektedir. Aynı biçimde benimsitem.com/herhangibir klasörüne kurulum yapabilmeniz içinde bu izinler gerekmektedir. Bu izinlerin diğer bir anlamıda güvenlik açığı olarak tanımlanabilir hatta hosting firmanız sizi bu hususta uyarabilir ama gerekli olduğu için güvenlik konusunda ve izinler konusunda takdir size aittir.

5 - Bir sonraki aşamada yapmanız gereken bir MSSQL veritabanı ve veritabanı kullanıcısı oluşturmaktır. Veritabanı ve kullanıcısını en başta oluşturmanız herhangi bir sorun teşkil etmez ancak oluşturulan veritabanı ve veritabanına ait kullanıcı ve kullanıcı şifresinin eksiksiz ve doğru hatırlanması önemlidir, bu sebeple tam ihtiyaç ortaya çıktığında bu işlemi gerçekleştirmeniz sizin için daha olumlu sonuçlar verecektir.

6 - Oluşturduğunuz veri tabanın yine hosting firmanızdaki sistem yöneticileri tarafından edit edilerek SQL'in bir parçası olan ve verilerle sorgu cümlelerinde kullanılan "A......Z", "a.....z", "0123456789" gibi karakterlerin farklı dillerdeki sembollerini alakadar eden Collation ayarlarının yapılması gerekmektedir. Türkiye'deki birçok hosting firması MS SQL kurulumlarında Collation varsayılan değerini Turkish olarak ayarlamakta ve bu durum dotnetnuke kurulumu esnasında son aşama olan portal oluşturulmasını engelleyerek aşağıdaki hata mesajına sebep olmaktadır.

00:01:05.609 - Executing Additional Scripts:
00:01:05.625 -   Creating Portal: My Website
00:01:06.328 -   Error: Object reference not set to an instance of an object.
00:01:06.328 -   Portal failed to install:
00:01:06.328 - Installing Optional Resources:

     Bu sorununda çözümü için Genel Latin karakter sombol ayarının yapılması gerekmektedir. Doğru kurulum için MS SQL veritabanınızı oluşturduğunuzda acilen hosting firmanıza veritabanınıza ait Collation ayarının Latin1_Gerenal_CI_AI olarak değiştirtilmesini istediğinizi bildirmeniz gerekmektedir. Bu değişiklik yapılmadan kesinlikle bu yazıdaki sonraki aşamalara veya kendi belirlediğiniz diğer kurulum aşamalarına devam etmeyiniz. Collation ayarı yapılmadan önce başlatılan kurulumlar çoğunlukla kurulumun son aşamasında yukarıdaki hata mesajı ile tamamlanamaktadır ve sonradan collation değiştirilse dahi mevcut veritabanı üzerinde tablolar olduğundan dotnetnuke bir sonraki kurulum isteğinizi tabloları boşaltıncaya kadar karşılamayacaktır. Bunun anlamı yeni bir veritabanı oluşturmanız yada mevcut veritabanında işlem görmüş tüm tablo ve prosedürleri boşaltmanız veya DotNetNuke için kurduğunuz sürümle aynı sürüm için bile olsa upgrade kurulumu yapmanız gerekmektedir ve upgrade işlemleri şuana kadar bahsedilen işlemler kadar zor ve uğraştırıcıdır.

7 - Eğer gerekli olan windows izin sorununu ve MS SQL Collation sorununu hallettiyseniz, ikinci aşama olarak yapmanız gereken, web.config üzerinde gerekli ayarlamayı yapmaktır. İşte tam da bu noktada gerekli olan aşağıdaki açıklamalardır.

     Web.config dosyasındaki yapılması gereken optimizasyon ile ilgili sorunlar..

Error Installing DotNetNuke
Current Assembly Version: 04.03.04
ERROR: Could not connect to database specified in connectionString for SqlDataProvider

     Eğer web sitenizin aderesini browser'ınıza yazıp, sayfanızı istediğinizde yukarıdaki hata mesajını alıyorsanız, Connection String denilien Ms Sql veritabanınızla Web sitenizin sayfaları arasındaki bağlantıyı sağlayan ayar cümleciğinizde hata vardır ve tabiki de biz henüz bu bağlantı cümlesini düzenlemedik.

     Orjinal web.config dosyasında Connection String aşağıdaki gibidir.

  </configSections>
  <connectionStrings>
    <!-- Connection String for SQL Server 2005 Express -->
    <add
      name="SiteSqlServer"
      connectionString="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"
      providerName="System.Data.SqlClient" />
    <!-- Connection String for SQL Server 2000/2005
    <add
      name="SiteSqlServer"
      connectionString="Server=(local);Database=DotNetNuke;uid=;pwd=;"
      providerName="System.Data.SqlClient" />
   -->
  </connectionStrings>
  <appSettings>
    <!-- Connection String for SQL Server 2005 Express - kept for backwards compatability - legacy modules   -->
    <add key="SiteSqlServer" value="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"/>
    <!-- Connection String for SQL Server 2000/2005 - kept for backwards compatability - legacy modules
    <add key="SiteSqlServer" value="Server=(local);Database=DotNetNuke;uid=;pwd=;"/>
    -->

     Web.config içerisinde yapılması gereken değişiklik hiçbir kurulum anlatımında açıkça belirtilmemiştir.

     Yukarıdaki string için öncelikli açıklama şudur :  <!--    --> arasında yer alan tüm kodlar bu işaretler arasından çıkartılıncaya kadar geçersizdir.

     MS SQL 2005 için Connection String üzerinde ;

  </configSections>
  <connectionStrings>

    <!-- Connection String for SQL Server 2005 Express -->
    <add
      name="SiteSqlServer"
      connectionString="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"
      providerName="System.Data.SqlClient" />

    <!-- Connection String for SQL Server 2000/2005
    <add
      name="SiteSqlServer"
      connectionString="Server=(local);Database=DotNetNuke;uid=;pwd=;"
      providerName="System.Data.SqlClient" />
   -->
  </connectionStrings>
  <appSettings>

    <!-- Connection String for SQL Server 2005 Express - kept for backwards compatability - legacy modules   -->
    <add key="SiteSqlServer" value="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"/>

    <!-- Connection String for SQL Server 2000/2005 - kept for backwards compatability - legacy modules
    <add key="SiteSqlServer" value="Server=(local);Database=DotNetNuke;uid=;pwd=;"/>
    -->

     Renkli bölümler olarak gösterilen cümlelerde data source olarak sunucunuzun ip adresi ve portu veya sunucunuzun host adresi ve portu yazılmalıdır ayrıca mavi yazı ile belirtilen bölümde aşağıda anlatılan ayarlar 2005 sunucu içinde uygulanmalıdır, diğer alanlardaki sadece MS SQL 2000 ile alakalı cümlecikler zaten devre dışı olduğundan bu bölümlerde değişiklik gerekmemektedir.

     Eğer MS SQL 2000 kullanılıyorsa ;

     Yukarıdaki renkli alanlar ve MS SQL 2000 ile alakalı String'i devredışı bırakan koyu renkle aşağıda gösterilen alanlar silinmeli,

  </configSections>
  <connectionStrings>

    <!-- Connection String for SQL Server 2000/2005
    <add
      name="SiteSqlServer"
      connectionString="Server=(local);Database=DotNetNuke;uid=;pwd=;"
      providerName="System.Data.SqlClient" />
   -->
  </connectionStrings>
  <appSettings>

    <!-- Connection String for SQL Server 2000/2005 - kept for backwards compatability - legacy modules
    <add key="SiteSqlServer" value="Server=(local);Database=DotNetNuke;uid=;pwd=;"/>
    -->

ve daha sonra aşağıdaki String in bu bölümü aşağıdaki gibi görünmelidir.

  </configSections>
  <connectionStrings>
    <add
      name="SiteSqlServer"
      connectionString="Server=(local);Database=veritabaniadi;uid=veritabanikullaniciadi;pwd=veritabanikullanicisifresi;"
      providerName="System.Data.SqlClient" />
  </connectionStrings>
  <appSettings>
    <add key="SiteSqlServer" value="Server=(local);Database=veritabaniadi;uid=veritabanikullaniciadi;pwd=veritabanikullanicisifresi;"/>

     Bu bölümde iki koyu renkli satır üzerinde değişiklik gerekmektedir, bunlar Server=(local); eğer web sunucunuz ile SQL sunucunuz aynı bilgisayar üzerinde kurulu ise olduğu gibi bırakılacak,

Database=; bölümünde orjinalde DotNetNuke yazmaktadır, bu veritabanınızın adı ile değiştirilmelidir, örneğin yukarıdaki yönergeleri izlerken oluşturduğunuz veritabanının ismi "site_veri" ise Database=site_veri; olarak değişecektir,

uid= ve pwd= tanımlamaları da oluşturduğunuz veritabanı için yine veritabanı oluşturmanızdan hemen sonra belirlediğiniz veritabanı kullanıcısı ve şifresidir.

     Doğru string'i yazdıysanız internet sayfalarını gezmek için kullandığınız Internet Explorer veya Firefox gibi bir programı kullanarak web sitenizin adresini yazın, bu aşamada eğer altklasör kullandıysanız alt klasör isminide yazmanız gerektiğini unutmayın, yani benimsitem.com/ veya benimsitem.com/oluşturduğunuz klasör şeklinde web sitenizi açın ve dotnetnuke otomatik kurulum scripti çalışmaya başlayacak ve site için gerekli kurulum yönergelerini uygulayıp kullanım için hazır hale getirecektir.

     Eğer kurulum bittikten sonra site adresinizi yeniden çağırdığınızda veya kurulum penceresinin en alt bölümünde şimdi sayfamı göster linkini tıkladığınızda DotNetNuke'ün My Website isimli sayfası tüm içeriği ile görüntülendiyse işin %90'ı tamamlanmış siteniz başarılı bir biçimde kurulmuştur. Hemen yapmanız gereken sitenizin sağ üst bölümünde Login ile linklenmiş giriş bağlantısına tıkalyıp gelen kullanıcı adı ve şifre sayfasında user : admin, pass : dnnadmin varsayılan kullanıcı adı ve şifresini girdikten sonra yönetim panelini açabiliyorsanız, sonrasında da çıkış yapıp yine login sayfasında user : host, pass : dnnhost olarak giriş yapabiliyorsanız, siteniz tam ve tamamen yönetilebilir biçimde %100 olarak kurulmuş demektir. Bundan sonrası sizin ne yapmak istediğinize göre DotNetNuke bileşenlerini kullanıp değiştirmenize kalmaktadır.

DotNetNuke kurulumundan sonra ortaya çıkabilecek olası sorunlar :

1 - Login linkine tıkladığınızda orta bölümde aşağıdaki hata mesajını alıyorsanız ;

login : A critical error has occurred.
The stored procedure 'dbo.GetModuleSetting' doesn't exist.

     Bunun sebebi Ms SQL serverınızın hosting firması tarafından yapılan kurulum ayarlarında Veritabanlarını Case Sensitive özelliği aktif olarak kurulmuştur ve bu nedenle DotNetNuke'ün veritabanınıza eklemek istediği birkaç dizi eklenememiş veya kabaca küçük harf büyük harf duyarlılığı anlamına gelen case sensitivity nedeni ile eşleşme sonucu alınamıyor olmasıdır. Bu sorunun hosting firmasına aktarılması ve gerekli düzenlemeler yapıldıktan sonra mevcut veritabanı dosyasıda silinip yenisi oluşturularak, dotnetnuke kurulumunun bu tarifteki kurulum maddelerine göre yeniden yapılması gerekmektedir. Bu sorunla parelel olarak kullanıcı girişi (Login) sayfasında ki sorunla aynı sebeplerden Register sayfasında da aşağıdaki hata mesajı alınmaktadır, bu hata mesajı içinde çözüm Login sayfasının çözümü ile aynı olduğundan hosting firmanız gerekli düzenlemeyi yaptığında her iki sorunda çözülecek demektir.

register :  An error has occurred.
Error: Register is currently unavailable.

2 - Eğer site kurulumunuz tamamladıktan sonra login sayfanızı görüntüleyebildiyseniz ve kullanıcı adı, şifre giriş ekranına, varsayılan kullanıcı adını (admin) ve varsayılan kullanıcı şifresini (dnnadmin) yazarak giriş butonuna tıkladığınızda aşağıdaki hata mesajını alıyorsanız ;

Login Failed, remember that Passwords are case sensitive

     Bu sorunun nedeni öncelikle küçük büyük harf duyarlılığına dikkat etmediğinizden veya şifre ve parolayı doğru yazmadığınızdan kaynaklanıyor olabilir, eğer doğru yazdığınıza emin olduğunuz halde aynı hata mesajını almaya devam ediyorsanız, sorun yine kurulumun Sql sorgularının sunucunuza Case Sensitivity nedeni ile eksiksiz yüklenmemiş olmasındandır bu durumda 1. (birinci) kurulum sonrası sorunlar yönergesinde ki adımlara göre yeni bir kurulum için hazırlık yapmaya başlamalısınız.

     Eğer eksik SQL yüklemesi nedeni ile sorun yaşadığınızı düşünüyorsanız ;

create procedure {databaseOwner}{objectQualifier}GetModuleSetting

@ModuleId      int,
@SettingName   nvarchar(50)

as

select SettingValue
from   {objectQualifier}ModuleSettings
where  ModuleId = @ModuleId
and    SettingName = @SettingName

GO

     Prosedürünün veritabınızda kayıt edilmiş olup olmadığını kontrol ederek fikir sahibi olabilirsiniz. Bunu kontrol edebilmeniz için bir çok hosting firmasının sunucularında kontrol panel olarak kullandığı plesk yeterli olmayacağından hatta Plesk 7.4, 7.5, 7.6 sürümlerinin MS SQL ile geçinemeyip Plesk kullanılarak oluşturulmuş veritabanlarını bile sonradan görüntüleyemediğinden, SQL Manager programlarından birini (örneğin : Aqua Data Studio) kendi bilgisayarınıza yükleyip gerekli ayarları yaptıktan sonra web sitenizi host eden firmanın SQL sunucusuna bağlanmanız ve veritabanınızı yukarıdaki prosedür için kontrol etmeniz ve düzenlemeniz gerekebilir.

3  - Kurulum işlemini tamamladıktan sonra web sayfalarınızı istediğinizde aşağıdaki hata mesajı görüntüleniyorsa ;

Server Error in '/demo' Application.
--------------------------------------------------------------------------------

Runtime Error
Description: An application error occurred on the server. The current custom error settings for this application prevent the details of the application error from being viewed remotely (for security reasons). It could, however, be viewed by browsers running on the local server machine.

Details: To enable the details of this specific error message to be viewable on remote machines, please create a <customErrors> tag within a "web.config" configuration file located in the root directory of the current web application. This <customErrors> tag should then have its "mode" attribute set to "Off".

<!-- Web.Config Configuration File -->

<configuration>
    <system.web>
        <customErrors mode="Off"/>
    </system.web>
</configuration>
 

Notes: The current error page you are seeing can be replaced by a custom error page by modifying the "defaultRedirect" attribute of the application's <customErrors> configuration tag to point to a custom error page URL.

<!-- Web.Config Configuration File -->

<configuration>
    <system.web>
        <customErrors mode="RemoteOnly" defaultRedirect="mycustompage.htm"/>
    </system.web>
</configuration>

     Bunun anlamı kurulum doğru biçimde tamamlanamadığından sistem anasayfanıza ulaşamıyor demektir, anasayfaya ulaşamadığı için de sizden web.config dosyasına yukarıdaki kodları ekleyerek hata durumunda yönlendirilecek bir sayfa belirlemenizi istemektedir ki bu zaten istenmeyen bir durumdur. Yani daha açık bir anlatımla web.config dosyasında yapılması istenen ayarlama sizin sitenizdeki sorunu çözebilmeniz için değil siteniz bu gibi sorunlu durumlarda bir hata sayfasına yönelendirilebilmesi için istenmektedir, amaç örneğin : sitemiz geçici olarak bakımdadır gibi bir sayfa görüntüleyebilmektir.

     Eğer buraya kadar anlatılan yönergeleri izleyerek bir kurulum gerçekleştirdiniz ve ilk kurulumda veya bahsedilen sorun giderme yönergelerinden sonra ikinci yada üçüncü kurulumda sorunsuz çalışan bir dotnetnuke elde ettiyseniz tüm anlatılanlar ve tabi ki siz ve siteniz amacına ulaşmış demektir. Eğer yine de sorunu çözemediniz ve DotNetNuke'ü sağlıklı çalıştıramadınızsa ve artık uğraşmaktan bıktıysanız alternatif ASP veya ASP.NET içerik yönetim sistemleri ile ilgili biraz araştırma yaparak kendiniz için uygun script'i seçebilir ve kullanabilirsiniz.

     Hala umudunuzu yitirmediyseniz ve uğraşmaya devam etmek istiyorsanız support.dotnetnuke.us adresinde sizin sorunlarınızı da içermesi muhtemel binlerce sorun bildirimi ve çözümü (issue) arasından size gerekli olanı tarayıp bularak sorunununuzu gidermenizi dilerim. Başarılar