Mehmet AYDIN

Önceki yazımda, Biztalk Server 2010 için gerekli olan ön kurulumları yapmıştık. Her şey hazır olduğuna göre artık Biztalk Server’ın setupını çalıştırabiliriz.
Herşeyin düzgün gitmesi için bir iki dua okumakta fayda var bu sırada Zira herhangi bir yerde, saçma bir sorunla karşılaşabilirsiniz.

Kurulum;

1. Kurulum için, Microsoft’un sitesinden rahatlıkla indirebileceğimiz, setupı çalıştırıyoruz. Karşımıza gelen ekranda, fikir vermesi açısından installation guide’ı okumanızda fayda var. Vaktim değerli derseniz; Install Microsoft BizTalk Server 2010‘ a tıklayın .



2. User Name ve Organization bilgilerinizi doldurun. Çok detaya girmenize gerek yok. Product Key otomatik olarak gelecektir. Next butonu ile işleme devam edin.



3. Lisans sözleşmesini okuyun . Tamam tamam okumayın. Okuyan birini bulursanız selamlarımı iletirsiniz. Accept edip, Next butonu ile devam edin.



4. Zorunlu, Customer Experience Improvement Program‘ ına  dahil olduğunuzu gösteren yazıyı okuyun. Next butonu ile devam edin.



5. Yüklemek istediğini komponentleri seçin. Ben şahsen hepsini denemek istediğim için ne var ne yok seçtim. Zaten fazla yer kaplama gibi bir derdi de yok. Sonuçta birkaç dll hepsi.



6. Biztalk 2009 kurulumunda redistributable components‘ i sen mi indircen, indirilmiş var mı, yoksa ben download edeyim mi diye sorardı. Her kurulumda tekrar tekrar o çok MB lik dosyayı indirmekle uğraşmazdık. Bunda ise otomatik olarak componentleri download etmeye başlıyor. İnşallah beta bir kurulum olduğunda dolayıdır diyorum ve yüklemenin tamamlanmasını bekliyorum.



7. Aşağıdaki ekranla kurulumu tamamlıyoruz. Launch BizTalk Server Configuration tick ini, konfigürasyonu sonra yapacaksak kaldırıyoruz.

• İşletim sistemi Windows Server 2008 R2 olan bir server hazırlanır,
• Server üzerinde tüm windows updateler yapılır,
• IIS Kurulumu yapılır
  • Role’lerden Web Server (IIS) seçilir. Feature olarak da aşağıdakiler Role eklenir
    • Application Development
    • Security altından, Basic Authentication ve Windows Authentication
    • Management Tools altında IIS 6 Management Compatibility
  • İşlem sonunda aşağıdaki kurulumların yapılmış olması gerekir,

  

• Business Activity Monitoring (BAM) Kullanılacaksa Office Excel 2007 ya da Office Excel 2010 kurulumu,
• Visual Studio 2010 yüklenir (Kurulumdaki SQL Server Express kurulmamalıdır.
  
• SQL Server 2008 R2/SP1 Kurulumu aşağıdaki gibi gerçekleştirilir,
  • Feature Selection ekranından, aşağıdaki resimde seçilen feature lar seçilir,sql11.jpg">sql1" src="http://www.mehmetaydin.com/wp-content/uploads/2010/07/sql11.jpg" alt="" width="825" height="622" />
    
  • Aşağıdaki gibi Instance ayarı yapılır,
    
    
    
  • Server Configuration ekranında, servislerin hangi user ile çalışacağını belirleyin veya Use the same account for all SQL Server services butonu ile hepsine aynı userı atayın. Collation tabından, Collation’ı, Latin1_General olarak seçmeyi unutmayın.
    
  • Database Engine Configuration ekranında Add Current User butonu ile kurulum yapılan userı SQL Administrators olarak belirliyoruz.
  • Analysis Services‘ da yetkili olacak userları seçiyoruz

    

  • Reporting Services Kurulumu

    

  • SQL Kurulumun bitmesi beklenir.

    

• Windows SharePoint Services 3.0 with SP2 kurulumu yapılır ve konfigüre edilir. Link : http://www.microsoft.com/downloads/en/confirmation.aspx?familyId=ef93e453-75f1-45df-8c6f-4565e8549c2a&displayLang=en
• SQL Serverın Shared Protokolü Disable edilir.
  

Bununla birlikte Biztalk Server 2010 kurulumuı için tüm ön gereksinimleri tamamlanmış bulunuyorsunuz. Bir sonraki yazıda Biztalk Server 2010 – Beta’nın nasıl kurulduğunu görebilirsiniz.

Biztalk Server schemaları root node name + namespace mantığıyla ayırt eder. Eğer İlk node un ismi ve namespace in birleşimi aynı olan birden fazla şemanız mevcutsa bu hatayı alırsınız. Yani Biztalk bu yapıya sahip bir mesaj aldığında hangi şemayı kullanacağını bilemez/karar veremez.

üç tane çözümü mevcuttur (benim bildiğim )

1. Aynı yapıya sahip iki şema zaten olmamalıysa, yani yanlışlıkla olmuşsa, gereksiz şemayı silip yeniden deploy edersiniz.
2. Yanlışlık yoksa ve şemanın ikisini de kullanmanız gerekli ise;
   1. Source mesajın şemasını değiştirebiliyorsanız, yani xml dosyasını üreten programda değişiklik yapabilirseniz, programdan xmlns yi veya root node un ismini değiştirmeniz yeterli olacaktır.c# ile XMLDocument içindeki namespace i (xmlns) aşağıdaki gibi değiştirebilirsiniz;
      

      XmlDocument xmlDocument = new XmlDocument();
      xmlDocument.Load(“dosyaadi veya var olan XmlDocument kullanılabilir”);
      XmlAttribute attributeNode = xmlDocument.CreateAttribute(“xmlns”, ”", “http://blablabla”);
      xmlDocument.DocumentElement.SetAttributeNode(attri buteNode);

   2. Yukarıdaki çözüm işinize yaramazsa ki kaynak üreten program elinizde değil ise yaramaz. O zaman Biztalk tarafında aşağıdaki özelliklere sahip bir Pipeline üretiyoruz. Daha sonra Receive Location’ınımız pipelinını, yeni yaptığımız pipeline ile değiştiriyoruz. Böylece Biztalk Server, yaratılan pipeline sayesinde hangi schemanın kullanılacağına karar verebilir.Yeni yaptığımız pipeline a bir adet XML Disassembler eklenir.XML Disassembler ın Allow unrecognized messages özelliği true yapılır. Document schemas dan kullanılmak istenilen schema seçilir.

      

   Daha sonra proje deploy edilir ve kullanılacak olan receive locationdan Receive Pipeline olarak yeni yarattığımız pipeline seçilir.

   

   Test ettiğinizde problemin çözülmüş olduğunu görürsünüz.

Arkadaşlar,
aşağıdaki linkten public olarak yayınlanan Biztalk Server 2010 Beta yı indirip test edebilirsiniz :

link : http://www.microsoft.com/downloads/details.aspx?FamilyID=0F852E77-F792-4784-B2D4-95113D40DB64&displaylang=en#filelist

Microsofttan duyurulan Sistem gereksinimlerini aşağıda bulabilirsiniz;

System Requirements
Supported Operating Systems: Windows 7; Windows Server 2008; Windows Server 2008 R2; Windows Vista
The software is for evaluation and deployment planning purposes only. If you plan to install the software on your primary computer, we recommend that you back up your existing data prior to installation.
To run BizTalk Server 2010 Beta you need:

1. 32-bit (x86) platforms: Computer with an Intel Pentium-compatible CPU that is 1 GHz or faster for single processors; 900 MHz or faster for double processors; or 700 MHz or faster for quad processors
2. 64-bit (x64) platforms: Computer with a CPU that is compatible with the AMD64 and Extended Memory 64-bit Technology (EMT64T), 1.7 GHz or faster processor recommended for BizTalk Server 2010
3. 2 GB of RAM minimum (more recommended)
4. 10 GB of available hard-disk space
5. VGA monitor (1024 x 768) or higher-resolution monitor
6. Microsoft Mouse or compatible pointing device

To use BizTalk Server 2010 Beta you need the following software:

1. Microsoft Windows: Can be Windows 7, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Vista® with Service Pack 2 (SP2)
2. SQL Server 2008 R2 or SQL 2008 SP1
3. Microsoft .NET Framework 4 and .NET Framework 3.5 with Service Pack 1 (SP1)
4. Microsoft Visual Studio 2010 [Required for selected features only]
5. Microsoft Office Excel 2010 or 2007 [Required for selected features only]
6. SQL Server 2005 Notification Service [Required for selected features only]
7. SQLXML 4.0 with Service Pack 1[Required for selected features only]
8. Internet Information Services (IIS) Version 7.5 and 7.0 [Required for selected features only]

Biztalk Administration Console olmadan, DB ye bakmak suretiyle Biztalk dan gelip geçen mesajları görmeniz pek mümkün olmamaktadır.
DB’yi ne kadar kurcalarsanız kurcalayın, Table lardaki bilgilerin (TrackingDB deki) anlamsız (okunamaz) durumda olduğunu göreceksiniz.

Peki Örneğin Bir Web Service veya Bir Web Sayfasında, Biztalk Server üzerinden gelip geçen mesajları ve mesajların içeriklerini nasıl gösterebiliriz?

Kullanabileceğiniz Metodlar Şöyle :

usings;

Altı çizili olan dll leri Biztalk un kurulduğu dizin içerisinde bulabilirsiniz;

Definitions;

private string TrackingServer = "Biztalk SQL Server";
private string TrackingDB = "DTA DB";

Biztalk SQL Server : Biztalk Server ın DB sinin bulunduğu server (local vs olabilir).
DTA DB : Tracking DB nizin adı, değiştirmediyseniz BiztalkDTAdb olmalı.

GetServiceMessages Metodu;

public Collection<BTMsgInstance> GetServiceMessages(string ServiceInstanceId)
{
Collection<BTMsgInstance> collection = new Collection<BTMsgInstance>();
Operations.BizTalkOperations ops = new Microsoft.BizTalk.Operations.BizTalkOperations();
Operations.TrackingDatabase tdb = new Microsoft.BizTalk.Operations.TrackingDatabase(TrackingDB, TrackingServer);
Operations.MessageFlow flow = ops.GetMessageFlow(new Guid(ServiceInstanceId), tdb);
foreach (Operations.MessageEvent message in flow.MessageEvents)
{
BTMsgInstance instance = new BTMsgInstance
{
EndTime = message.RoutingDetails.Source.EndTime,
StartTime = message.RoutingDetails.Source.StartTime,
InstanceID= message.RoutingDetails.Source.InstanceID,
ErrorInfo = message.RoutingDetails.Source.ErrorInfo,
ExitCode = message.RoutingDetails.Source.ExitCode,
ServiceName = message.RoutingDetails.Source.ServiceName
};
collection.Add(instance);
}
return collection;
}


GetTrackedMessageData Metodu;

public string GetTrackedMessageData(string MessageInstanceId)
{
Operations.BizTalkOperations ops = new Microsoft.BizTalk.Operations.BizTalkOperations();
Operations.TrackingDatabase tdb = new Microsoft.BizTalk.Operations.TrackingDatabase(TrackingDB, TrackingServer);

Guid guid = new Guid(MessageInstanceId);
IBaseMessage trackedMessage = ops.GetTrackedMessage(guid);
IBaseMessagePart part = trackedMessage.BodyPart;
Stream stream = part.Data;
StreamReader reader = new StreamReader(stream);
return string.Format(CultureInfo.CurrentCulture, "0", new object[] { reader.ReadToEnd() });
}

Unutmadan yukarıdaki kodun çalışması için Biztalk Server üzerinde bir IIS’ e kurmanızı öneririm, zira kodlar yetki ile ilgili problemlerden dolayı çalışmayabilirler. Bu yüzden bu metodları bir web service olarak hazırlamanız en iyisi olacaktır. Daha sonra yapacağınız ayrı bir web uygulaması ile de bu metodları çağırıp gerekli bilgileri alabilirsiniz.

GetServiceMessages metodu, Bir servisin Instance ID sini input olarak alır ve BTMsgInstance sınıfında bir değişken döndürür. Bunun içinde EndTime, StartTime, InstaceID, ErrorInfo, ExitCode, ServiceName gibi bilgiler bulunmaktadır.

GetTracketMessageData metodu ise Message Instance ID si verilen bir mesajın içeriğini XML olarak bize döndürür.

Bu kadar bilgiden sonra lan olm iyi güzelde ServiceName ve ServiceInstanceID lerini nereden bulacam da bu metodlara gönderip sonuçları alacam diyebilirsiniz. Demelisiniz de

Onu da düşündüm, onu da anlatıcam size

ServiceName leri bulabilmek için aşağıdaki SQL i çalıştırıyoruz,

SELECT DISTINCT sf.[Service/Name] AS [Service Name]
FROM [dtav_ServiceFacts]  sf
WHERE sf.[Service/Name] IS NOT NULL;

ServiceInstanceID leri bulabilmek için de aşağıdaki SQL e, ServiceName gönderiyoruz

SELECT sf.[Service/Name] AS [Service Name], sf.[ServiceInstance/InstanceId] AS [Service Instance Id]
FROM [dtav_ServiceFacts]  sf
WHERE sf.[Service/Name] = '" + serviceName + "'
ORDER BY sf.[ServiceInstance/StartTime] DESC

Daha da detaylı bilgi gerekirse dtav_ServiceFacts tablosundaki verileri inceleyebilirsiniz.

Son 10 mesajın Bilgilerini getiren SQL;

SELECT TOP 10
sf.[ServiceInstance/InstanceId] AS [Service Instance Id],
sf.[Service/Name] AS [Service Name], sf.[ServiceInstance/State] AS [State] ,
dateadd(minute, 180, sf.[ServiceInstance/StartTime]) AS [Start Time],
dateadd(minute, 180, sf.[ServiceInstance/EndTime]) AS [End Time],
sf.[ServiceInstance/Duration] AS [Duration],
sf.[ServiceInstance/ExitCode] AS [Error Code],
FROM [dtav_ServiceFacts]  sf
WHERE sf.[Service/Name] IS NOT NULL
AND  sf.[Service/Type]='Orchestration'
ORDER BY [Start Time] DESC


Aşağıdan indirebilirsiniz (x86 veya x64);

x86 için;

x64 için ;

Hatayı, Visual Studio da yeni bir Biztalk Projesi yaratmaya çalışırken alırsınız. Muhtemelen sadece sln dosyasını oluşturacak ve diğer gerekli dosyaları ve referansları eklemeden hata verecektir, bu durumda yapmanı gerekenler;

Hata : Creating project Biztalk Proje İsmi project creation failed.

Çözüm :

1. Başlat -> Çalıştır -> Regedit yolunu izleyerek Kayıt Defterini (Regediti) açın,
2. 32 bit VS için : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\9.0\Projects\{FAE04EC0-301F-11d3-BF4B-00C04F79EFBC}\PossibleProjectExtensions

64 bit VS için : HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\9.0\Projects\{FAE04EC0-301F-11d3-BF4B-00C04F79EFBC}\PossibleProjectExtensions

Yollarını izleyin,

3. Buradaki değere btproj kaydını ekleyin,

   Önceden bir kayıt varsa iki değeri ; (noktalı virgül) ile ayırın
   Örn : csproj;btproj

Biztalk Server için SAP RFC Libraries Yüklemesi;

1. SAP Front End Installer ekranında Next butonuna tıklanır,



2. SAP Product Selection ekranında sadece Unicode RFC Libraries ın seçilmesi yeterli olucaktır. Zira Biztalk sadece buradaki RFC kütüphanelerini kullanıyor,



3. Yol ve Kurulum için isim veriyoruz ve Next butonuna tıklıyoruz,



4. Finish butonu ile işlemimizi bitiriyoruz.

Biztalk Server için Oracle Client üzerine Patch geçilmesi;

1. Welcome ekranından Next butonuna tıklıyoruz,



2. Aşağıda ekranda görüldüğü gibi Name ‘ i Oracle Client kurulumu yaptığınızı dizin ve ismi seçmeniz gerekmekte. Eğer varsayılanı seçerseniz geçilen patchin bir işlevi ve anlamı olmaz. Mutlaka Path ve Name ‘ in Oracle Client kurulumu sırasında verdiğiniz değerler olup olmadığını kontrol edin.



3. Next butonuna tıklıyoruz,



4. Muhtemelen aşağıdaki gibi bir hata ile karşılaşacaksınız. Karşılaşmazsanız sorun yok Hata OracleMTSRecoveryService ini stop etmeniz gerektiğini söylüyor.



5. OracleMTSRecoveryService ini servisler ekranından stop edip, Retry butonuna tıklıyoruz,



6. Summary ekranında son kontrollerimizi yapıyoruz ve Install butonuna tıklayarak yükleme işlemini başlatıyoruz.

Oracle Client Kurulumu ;

1. Oracle Client kurulumu için setup çalıştırılır ve Next butonuna tıklanır.



2. Select Installation Type ekranından Custom seçilir ve Next butonuna tıklanır. Product Languages butonundan istenilen yükleme dili seçilir. Türkçe ve İngilizce seçili olması iyi olur,



3. Installa Location olarak C:\Oracle dizinini veya istediğiniz herhangi bir yol verebilirsiniz,



4. Product-Specific Prerequisite Checks ekranında hata almadığımızı görüp Next butonuna tıklıyoruz,



5. Biztalk için aşağıdaki resimdeki komponentleri yüklememiz gerekiyor. Bunları check liyoruz, ek olarak istediklerimizi işaretleyebiliriz,



6. Port Number ı 2030 a setleyip Next butonuna tıklıyoruz,



7. Summary ekranından son kontrollerimizi yapıyoruz ve Install butonuna tıklıyoruz,



8. Exit ile yükleme işlemini bitiriyoruz.