Installation av utvecklingsmiljö

Transkript

1 Installation av utvecklingsmiljö Stockholms stad SOA-plattform 1 (159)

2 Innehållsförteckning 1. Inledning Installationsfiler Preparera för SOA Utvecklingsmiljön Info OS Virtuell eller fysisk maskin m.m Windows Update (Uppdateringar) 5 4. Vad som inte har installerats 5 5. Lokala konton och grupper Skapa nödvändiga grupper och konton Installation av grundkomponenter NTLM NETFramework Installera Rollen Internet Information Services SQL SERVER 2008 R2 Installation installation av Analysis Services Office 2010 Professionell Plus Visual Studio 2010 Proffessional installation Installera BizTalk Server bit Enterprise BizTalk Server Konfiguration Konfigurera Enterprise Single Sign-On (SSO) Biztalk Group Skapa Hostar och hostinstanser Adapter Konfiguration Inställningar för http och SOAP sendportar BizTalks SQL Server Agent Jobs Backup Biztalk Server Enterprise Library MSChart Chart for.net Setup ESB Guidance Installation Installera ESB Toolkit Importera, installera MSI paket samt bindningar Konfigurera BizTalk ESB Toolkit core services och komponenter Installera BAM itinerary tracking activity definition Installera Exception Handling BAM Tracking Installing the Exception Management Framework Ändra rättigheter på Management Portal databas och Exception Management databaserna (159)

3 Skapa Management portalen...81 Verfiera ESB Portalen på noden Microsoft Management Server Engine MSE Notification Service Installation Notification Service Installations procedur Virtualisering av Notifieringstjänsten I MSE BizTalk Administrationsverktyg BizTalk Dokumenter V File Transfer Katalogstruktur WCF-tjänster FileTransfer.Service BizTalk-adapter Eventloggning Blogical Adapter BizTalk applikationerna Uppdatera BizTalk Config Send Ports Receive Ports Receive Locations Demo databas Demo Receive Locations Orkestreringar Rättigheter biztalk-kontot TEST av Fil Till Fil Test 2 Resend utan notifiering Länklista (159)

4 1. INLEDNING Detta dokument har tagits fram för att en utvecklare skall kunna installera och konfigurera utvecklingsmiljön för SOA-plattformen. OBS!!! Läs instruktionerna noga, samt i korrekt ordningsföljd, hoppa inte över några steg. 1.1 INSTALLATIONSFILER Länklista till nödvändig installationsmedia finns i slutet av detta dokument. Dessutom finns filen Installationsfiler 2.1.zip som återfinns i leveranspaketet för SOA SDK. Packa upp denna fil till lämplig sökväg, den kommer att skapa en mapp som heter install och konfig och innehåller: 1. BiztalkGroups.zip 2. ESB.Administration Database.zip 3. Installutil.zip 4. Notficationservice.zip 5. SkapaTestkataloger.zip 6. Soadevmsebackup.zip 4 (159)

5 2. PREPARERA FÖR SOA UTVECKLINGSMILJÖN Det är viktigt att läsa igenom allt till punkt 5.2 och utföra de förkrav som finns i dessa punkter. Se gärna till så att datornamnet blir soadev samt att administrator-kontot har abc123! som lösenord efter installation av OS INFO OS VIRTUELL ELLER FYSISK MASKIN M.M. Installationen av utvecklingsmiljön förutsätter att operativsystemet redan är installerat med Windows Server 2008 Standard R2 64-bit samt att Windows update har körts. Om denna installation ligger på en fysisk eller virtuell maskin är upp till utvecklaren eller leverantören att avgöra beroende på vilka resurser de har tillgängliga. I nedanstående installationer och konfigurationer har VMWare och en virtuell maskin använts. Storleken på RAM-minne är 4 GB för en virtuell maskin, och 6 GB för en fysisk maskin. Kravet när det gäller diskutrymme är att en c: partion finns med minimum 40 GB samt en d: partion med minimum 25 GB, där installationsfiler eller eventuella applikationer återfinns. CPU rekommenderad är 2 CPU. 3. WINDOWS UPDATE (UPPDATERINGAR) För att få en korrekt uppdaterad miljö skall Windows update köras efter varje produkt som installeras. 4. VAD SOM INTE HAR INSTALLERATS Det finns funktioner och programvara som inte finns med i denna installation såsom: 1.SMTP Server 2.Mail Klient 3.Mail Server 4.SFTP Server 5.SFTP Klient För att kunna testa fullt ut och om det inte finns access till externt nätverk och servrar med ovanstående funktionalitet, måste vissa lokala funktioner finnas i utvecklingsmiljön. Men då det finns många olika programvaror och konfigurationer, får utvecklaren ta ett eget beslut för att uppfylla dessa funktioner. 5 (159)

6 5. LOKALA KONTON OCH GRUPPER Installationen och konfigurationen av BizTalk är beroende av lokala grupper och servicekonton med tillhörande lösenord. Dessa grupper och servicekonton skapas med hjälp av filen CreateLocalGroups.vbs och tillhörande csv-filer där information om grupper och konton hämtas och skapas. Scriptet startas med StartScriptRunAs.bat för att kunna köras med rättigheter som Local Admin. Se till att kontot för Local Admin är korrekt uppsatt och att lösenordet är korrekt (abc123!) innan scriptet körs SKAPA NÖDVÄNDIGA GRUPPER OCH KONTON Filen BiztalkGroups.zip finns i installationspaketet se punkt 1.1. Lägg katalogen GroupsAccounts någonstans på C:. Katalogen ska innehålla följande filer: Dubbelklicka på StartScriptRunAs.bat och ange Administrator och det lösenord som valts för lokala adminkontot vid installationen av operativet. Det tar en liten stund för grupper och konton att skapas, vänta på dialogrutan script completed. DTC Access och Nätverks COM+ access För att få BizTalk att kommunicera med SQL-servern så måste vissa inställningar göras. För Windows 2008R2 server så är de default avstängda. Steg 1 gå till Component Services gå till My Computer Steg 2 bläddra ned till Distributed Transaction Coordinator / Local DTC. 6 (159)

7 Högerklicka på Local DTC och välj Properties, därefter fliken Security. Konfigurera efter bildens inställningar. På SQL-servern krävs en omstart av SQL- instansen. På BizTalk-servern, starta om Component Services. 7 (159)

8 6. INSTALLATION AV GRUNDKOMPONENTER 6.1. NTLM För att kunna kommunicera med SQL-servern måste ändringar göras i Local Security Policy (om inte det redan är korrekt). Välj START Administrative Tools Local Security Policy Local policies Security Options Network Security: LAN Manager authentication level properties. Ändra till nedanstående om detta inte redan är ifyllt Klicka Yes 6.2..NETFRAMEWORK 4.0 Ladda ner och installera.net Framework 4.0 Se länklistan sist i dokumentet. Följ instruktionerna från installationsprogrammet. Kör Windows Update efter installationen och installera de uppdateringar som hittas. 8 (159)

9 6.3. INSTALLERA ROLLEN INTERNET INFORMATION SERVICES I Administrative Tools, öppna Server Manager och välj Roles, klicka på Add Roles. Välj Next och sedan Web Server (IIS). 9 (159)

10 Under Role Services, se även till att markera IIS 6 Management Compability. Markera även ASP.NET enligt bilden: Klicka Next på resterande bilder och slutligen Install. 10 (159)

11 7. SQL SERVER 2008 R2 INSTALLATION Ladda ner och installera SQL Server 2008 Standard R2 64-bit. Kör installationen av SQL Server SQLFULL_x64_ENU_Install.exe som admin. Klicka på New Installation. Klicka OK. 11 (159)

12 Klicka Next. Klicka Next. 12 (159)

13 Vänta tills det är klart. Klicka Next. 13 (159)

14 Välj SQL Server feature Installation. Välj funktionalitet options efter bilden. 14 (159)

15 Klicka Next. Välj enligt bilden. Du kan också välja att lägga denna t.ex. på D: om du så önskar. 15 (159)

16 Klicka Next. Ange konto SQLSRV och lösen = abc123! som skapats tidigare med scriptet som körts.. 16 (159)

17 Add Current user. 17 (159)

18 Klicka Next om du väljer att följa bilden, annars kan man också välja att lägga denna på D: om man så önskar. Klicka Next. 18 (159)

19 Klicka Next. Klicka Next. 19 (159)

20 Klicka Next. Klicka Install. 20 (159)

21 Vänta tills installationen har slutförts. Klicka på Close. 21 (159)

22 7.1. INSTALLATION AV ANALYSIS SERVICES Starta setup-programmet för SQL Server igen. Välj New Installation or add feature to an existing installation. 22 (159)

23 Välj Add features to an existing Instance. Markera Analysis Services enligt bild. 23 (159)

24 Använda nedan konto: Konto:SQLSRV Lösen:abc123! Add SQLSRV. Kör klart installationen och välj Close. Installationen av SQL Server är nu klar! 24 (159)

25 8. OFFICE 2010 PROFESSIONELL PLUS Installera endast Excel 2010 och InfoPath 2010 genom att välja custom avmarkera allt annat följ sedan anvisningarna och vänta tills det är klart. 9. VISUAL STUDIO 2010 PROFFESSIONAL INSTALLATION 1. Ladda ned Visual Studio 2010 Pro Trial (iso file) Se Länklista 2. Ladda ned och installera Magic Disk Se Länklista 3. Installera VS2010ProTrial.iso (se bild nedan) Högerklicka på iso-filen och välj MagicISO Mount VS2010ProTrial.iso Kör igång installationen. 25 (159)

26 Godkänn Licenskravet och klicka på Next. Välj Custom. Klicka på Next. 26 (159)

27 Välj allt utom nedan Installera INTE Microsoft SQL Server 2008 Express Service!!! Klicka på Install Vänta sedan på att installationen skall bli klar. 27 (159)

28 10. INSTALLERA BIZTALK SERVER BIT ENTERPRISE Om du har licens för Developer versionen av BizTalk väljer du denna. Alla lösenord till servicekonton som refereras till i bilder eller text är abc123! för de service konton som är inskriptade. Kör setup.exe som administrator. Acceptera licensvilkoren. 28 (159)

29 Klicka Next. Ange val enligt bilden. Klicka på Next. 29 (159)

30 Utöka Additional Software och ange val enligt bilden. Innan ni klickar Next, se till att internetåtkomst är korrekt konfigurerad och att det finns tillgång till internet, annars kan inte prerequisite-filerna hämtas automatiskt. Klicka Next. Klicka Install. Klicka Finish. Kör Windows update och installera de uppdateringar som finns tillgängliga efter installationen. 30 (159)

31 11. BIZTALK SERVER KONFIGURATION Starta Microsoft BizTalk Server 2010 Konfigurations verktyget: Se till så att du är inloggad som administrator samt att kontot har rättigheter i grupperna: DEV-SSOAdmin DEV-SSOAffAdmin DEV-BtsAdmin Klicka på Configure. 31 (159)

32 Ange datornamnet för databasservern, i detta fall det lokala datornamnet. 32 (159)

33 11.1. KONFIGURERA ENTERPRISE SINGLE SIGN-ON (SSO) Installera och konfigurera vilka komponenter som BizTalk skall ha. Klicka på Enterprise SSO för att fortsätta konfigurationen. En del av bilderna visar korrekt info men har redan konfiguerats när bilderna togs, därför är de gråaktiga, vilket innebär att de inte kommer att vara utgråade när en ny installation görs. Välj Enterprise SSO. 33 (159)

34 Klicka i The Enterprise Single Sign On Create a new SSO System Konfiguera enligt bilden. Klicka på Enterprise SSO Secret Skapa också SSO Secret: abc123! Spara en backup på lämpligt ställe. 34 (159)

35 11.2. BIZTALK GROUP Konfigurera BizTalk Server Group. Välj Enable BizTalk Server Group on this Computer. Konfigurera en ny BizTalk group enligt bilden. Konfiguera Biztalk Runtime. Fyll i enligt bilden; viktigt att stavningen på Hostarna blir korrekt, TrackingHost och IsoHost1. 35 (159)

36 Markera Business Rules Engine. Välj konto enligt bilden och ange rätt lösen. För att verifiera att SQL instans kontot (SQLSRV) har rättigheter på Analysis Server, följ nedan anvisningar. Öppna SQL Management Studio som admin. Fyll i servernamnet, soadev. Klicka på connect. Välj Analysis Services. Ev måste servernamnet, soadev även fyllas i här (så kommer instansen upp i listan). Högerklicka på instansen och välj Properties; säkerställ att SQLSRV är upplagd som användare. 36 (159)

37 BAM Tools läggs till enligt nedanstående bild. Ange databasnamnen: Klicka sedan på BAM Portal och fyll i enligt bilden. Välj sedan Apply Configuration. 37 (159)

38 Verfiera installationen genom att: 1. Logga in i BizTalk Adminstrator konsolen 2. markera BizTalk gruppen, 3. tryck ner F5 tangenten så ser ni om allt fungerar. 38 (159)

39 12. SKAPA HOSTAR OCH HOSTINSTANSER Nedanstående bilder visar vilka Hostar och Hostinstanser som ska skapas. Efter bilderna kommer instruktioner hur de skapas. Öppna BizTalk Adminstrator konsolen. FTPHost1 Öppna Biztalk Server Administration. Bläddra fram Hosts enligt bilden. 39 (159)

40 Högerklicka på Hosts, välj New Host. Fyll i enligt bilden för FTPHost1: Windows Grupp: DEV-BTHostUsr Klicka OK. 40 (159)

41 Skapa Host Instance för FTPHost1: Högerklicka på Host Instance, välj New Host Instance. Välj enligt bild. Klicka OK. 41 (159)

42 Välj enligt bild. Klicka OK. [datornamn]\dev-btshostinst Lösen: abc123! Detta gäller för alla hostinstanserna du skall skapa. Klicka på Configure och fyll i Logon och Password. Klicka OK. 42 (159)

43 Gör nu samma sak för resten av Hostarna samt Hostinstanserna. 1. RecHost1 avmarkera 32-bit only och markera Make this the default host in the group 2. ProcHost1 avmarkera 32-bit only 3. SendHost1 avmarkera 32-bit only 4. SQLHost32bit (välj 32 bit only när du skapar hosten) 43 (159)

44 12.1. ADAPTER KONFIGURATION För att få en korrekt konfiguration så måste nedanstående adaptrar vara konfigurerade enligt bilderna. Instruktion för den första adaptern följer på följande bilder. Genomför samma procedur för återstående adaptrar, som också finns listade nedan. Öppna Adapters och högerklicka på File, välj New Send Handler. Välj SendHost1 som send för fil-adaptern, Klicka OK. 44 (159)

45 Gör likadant för RecHost som ska vara Receive för fil-adaptern, Klicka OK. 45 (159)

46 46 (159)

47 Kontrollera att du kan skapa ett nytt biztalk projekt i Visual studio. Alla BizTalk-tjänster samt ESSO-tjänsten skall ställas in på delayed start. Detta görs genom att dubbelklicka på tjänsten och sen ange detta. Detta fördröjning behövs för att SQL samt SQLagenten skall hinna starta, annars kommer varken ESSO eller BizTalk att kunna starta. 47 (159)

48 13. INSTÄLLNINGAR FÖR HTTP OCH SOAP SENDPORTAR Kör Visual Studio 2010 Pro med Run As Administrator. Välj File Open File för att öppna nedan filer. Filerna machine.config (existerar på 2 ställen och båda måste ändras!) ska editeras, se bilder nedan: Detta är 32-bitars machine.config. Detta är 64-bitars machine.config. Öppna och editera: C:\Windows\Microsoft.NET\Framework64\v \CONFIG machine.config och editera även här: C:\Windows\Microsoft.NET\Framework\v \CONFIG machine.config Observera att ta bort raden: <processmodel autoconfig= true /> (Annars startar inte IIS:en) 48 (159)

49 minfreethreads och minlocalrequestfreethreads sätts utifrån antalet processorkärnor. I BizTalk-servrarna det finns två quad-core processorer, d.v.s. åtta kärnor (88*8 = 704 och 76*8 = 608). Beroende på uppsättning måste detta räknas om. <processmodel autoconfig="false" maxworkerthreads="100" maxiothreads="100" minworkerthreads="25" miniothreads="25"/> <httpruntime executiontimeout="240" minfreethreads="350" minlocalrequestfreethreads="306"/> 49 (159)

50 14. BIZTALKS SQL SERVER AGENT JOBS För att BizTalk skall fungera så finns ett antal SQL-jobb som måste exekveras. I dessa jobb ingår även backup av BizTalk s databaser och dess transaktioner. Konfiguration av DTA Purge and Archive (BizTalkDTADb). DTA Purge and Archive är ett SQL Server Agent jobb som skapas av BizTalk och används för att ta bort och arkivera data ur BizTalks trackingdatabas (BizTalkDTADb) Skapa mappen C:\Backup\dta folders. Starta SQL Server Management Studio. Öppna Jobs enligt bilden. 50 (159)

51 Klicka på Steps. Dubbelklicka på Archive and Purge. Klicka på Edit Skriv: exec dtasp_backupandpurgetrackingdatabase 0, 29, 30, 'c:\backup\dta', null, 0 51 (159)

52 Gå tillbak till fliken General och klicka på Enabled (skall alltså vara ikryssad). Levande instanser av orkestreringar tas alltså bort efter sju dygn och all trackingdata äldre än 30 dygn rensas. Backuper av trackingdatabasen sparas under C:\backup\dta\. 52 (159)

53 14.1. BACKUP BIZTALK SERVER Backup Biztalk Server är ett SQL Server Agent jobb som skapas av BizTalk och används för att ta bort och arkivera data ur BizTalks databas (BizTalkMgmtDb). Dubbelklicka Backup Biztalk Server. Klicka på Steps fliken, dubbelklicka på BackupFull. 53 (159)

54 Ersätt Command med: exec [dbo].[sp_backupallfull_schedule] 'd' /* Frequency */, 'BTS' /* Name*/,'c:\Backup' /* location of backup files */ Gå tilbaka till Steps, dubbelklicka på MarkAndBackupLog. Ersätt Command med: exec [dbo].[sp_markall] 'BTS' /* Log mark name */, 'c:\backup' /* location of backup files */ Detta visar sista alternativet under Steps. 54 (159)

55 Med Clear Backup History kan man ändra på DaysToKeep=14 om man har behov av detta, behåll annars detta värde som är standard. Gå tillbak till fliken General och klicka på Enabled (skall alltså vara ikryssad). Man kan nu verifiera i c:\backups och i c:\backups\dta om det finns filer i dessa mappar. Om inte, prova att köra i gång de två jobben manuellt genom att högerklicka på jobben och sen run from step. För DTA körs den direkt och för BizTalk behöver man klicka på start. Om allt är ok borde det finnas filer i katalogerna. 55 (159)

56 15. ENTERPRISE LIBRARY 4.1 Ladda ner och installera Enterprise Library 4.1. Starta kommandoprompten med Run as Administrator. Kör msi paketet. Sedan Next, Next, Next och Install. 56 (159)

57 Klicka Finish. Klicka Next. Klicka Finish. Kommandofönstret kommer att visas en hel del information som bläddras förbi. När denna är slutförd är installationen klar. 57 (159)

58 58 (159)

59 16. MSCHART CHART FOR.NET SETUP Används av ESB-portalen för att visa grafer. I plattformen används MSChart för.net Framework 3.5. för att kunna visa grafer Ladda hem och installera. Se Länklista Kör MSChart.exe som administrator. Acceptera licenskraven. 59 (159)

60 Klicka Finish. Installationen är nu klar. 60 (159)

61 17. ESB GUIDANCE INSTALLATION INSTALLERA ESB TOOLKIT 2.1 Ladda ner och installera ESB Toolkit x Se Länklista Starta installationen av ESB Toolkit 2.1. Acceptera licenskraven. 61 (159)

62 Klicka Next. Installationsplatsen kan förändras om inte default passar bra. C:\Program Files (x86)\microssóft Biztalk ESB Toolkit 2.1\ Klicka Install. 62 (159)

63 Klicka Finish. 63 (159)

64 17.2. IMPORTERA, INSTALLERA MSI PAKET SAMT BINDNINGAR. Starta Biztalk Server Administration. Högerklicka på Applications, välj Import MSI file. Bläddra till C:\Program Files (x86)\microssóft Biztalk ESB Toolkit 2.1\ Microsoft.Practices.ESB.CORE_NOBINDING64.msi (om inte annan sökväg användes vid tidigare installation av ESB binärer). 64 (159)

65 Klicka Next. Klicka Next. 65 (159)

66 Klicka Next. (skall vara default) Klicka Import. 66 (159)

67 Kör MSI paketet direkt. Klicka Next. Låt default sökväg vara ifyllt C:\Program Files (x86)\generated by BizTalk\Microsoft.Practices.ESB\ 67 (159)

68 Klicka Next. Klicka Next. 68 (159)

69 Klicka Next. (detta är redan utfört) Klicka Close. 69 (159)

70 Editera C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1\Bindings\ Microsoft.Practices.ESB.CORE_Bindings.xml Öppna filen som Administrator. Så det blir rätt Hosts och grupper: BizTalkServerIsolatedHost ändras till IsoHost1. BizTalkServerApplication ändras till RecHost1 SQL SendHost = SQLHost32Bit 70 (159)

71 Markera ESB applikationen och sen högerklicka Import Binding se nästa steg Bläddra fram C:\Program Files (x86)\microssóft Biztalk ESB Toolkit 2.1\bindings\Microsoft.Practices.ESB.CORE_Bindings.xml Klicka Open. Är allt rätt konfigurerat så skall importen lyckas och då är denna del klar. 71 (159)

72 17.3. KONFIGURERA BIZTALK ESB TOOLKIT CORE SERVICES OCH KOMPONENTER Observera att namnet för host byts ut mot det som valts som datornamn. Kör ESBConfigurationTool.exe med Run as administrator som ligger: C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1\Bin\ESBConfigurationTool.exe Fyll i enligt bilden. Klicka på Apply Configuration. 72 (159)

73 Fyll i enligt bilden. Klicka på Apply Configuration. Fyll i enligt bilden. Klicka på Apply Configuration. 73 (159)

74 Fyll i enligt bilden. Klicka på Apply Configuration. Sökvägen till konfigurationsfilen är: C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1\Bin\ESBConfigurationTool.exe.Config Fyll i enligt bilden. Klicka på Apply Configuration. 74 (159)

75 17.4. INSTALLERA BAM ITINERARY TRACKING ACTIVITY DEFINITION. BAM definitionsfil (Microsoft.BizTalk.ESB.BAM.Itinerary.xml) finns i mappen BAM i installationskatalogen och installeras med verktyget Bm.exe. Starta kommandoprompten som administrator och ändra katalog till: C:\Program Files (x86)\microsoft BizTalk Server 2010\Tracking. Exekvera följande kommando: Bm.exe deploy-all -DefinitionFile:"C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1\Bam\Microsoft.BizTalk.ESB.BAM.Itinerary.xml" 75 (159)

76 17.5. INSTALLERA EXCEPTION HANDLING BAM TRACKING Starta först Internet Information Services (IIS) Manager med Run as Administrator. Klicka på Application Pools. Dubbelklicka på BAMAppPool, verfiera enligt bilden. Klicka OK. Starta SQL Server Management Studio Database Engine. Öppna Security och öppna Logins. Verifiera att SQLSRV har rättigheter enligt bilden. 76 (159)

77 I kommandoprompten, exekvera: Bm.exe deploy-all -DefinitionFile:" C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1\Bam\Microsoft.BizTalk.ESB.BAM.Exceptions.xml" INSTALLING THE EXCEPTION MANAGEMENT FRAMEWORK Starta SQL Server Management Studio. Välj Open file och bläddra till ESB.Administration.Database.sql Beroende på var installationsfilerna packades upp se punkt (159)

78 Ändra grupperna längst ner i filen till Biztalk Usergrupp och Biztalk Admingrupp enligt markeringarna i bilden. Klicka på Execute en rad skall ha blivit påverkad 78 (159)

79 17.7. ÄNDRA RÄTTIGHETER PÅ MANAGEMENT PORTAL DATABAS OCH EXCEPTION MANAGEMENT DATABASERNA Kontrollera rättigheterna innan du går vidare. Öppna SQL Server Management. Öppna Security Logins och välj Properties på DEV-BTSHostUsr. 79 (159)

80 Kontrollera att rättigheterna stämmer med bilden. 80 (159)

81 17.8. SKAPA MANAGEMENT PORTALEN I kommandoprompten, exekvera C:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation>ServiceModelReg.exe -r y Skapa mappen Projects direkt på C:\ och sedan undermapp Microsoft.Practices.ESB, dvs C:\Projects\Microsoft.Practices.ESB. Navigera till C:\Program Files (x86)\microsoft BizTalk ESB Toolkit 2.1 och extrahera ESBSource.zip tillc:\projects\microsoft.practices.esb Exekvera PowerShell(x86) med Run as Administrator och exekvera kommando: Set- ExecutionPolicy unrestricted. Exekvera PowerShell med Run as Administrator och exekvera kommando: Set- ExecutionPolicy unrestricted. Öppna kommandoprompten med Run as Administrator och kör: cd C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\Install\Scripts Exekvera: Management_Install.cmd Öppna Internet Information Services och verifiera EsbPortalNetworkAppPool enligt nedan: 81 (159)

82 Öppna web.config med Visual Studio 2010: C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\ESB.Portal\web.config Ändra roller enligt bild: DEV-BTHostUsr och DEV-BTSAdmin Ändra i connectionstrings enligt rutorna i koden: Lägg till Windows Authentication i IIS. 82 (159)

83 Se till så att Windows Authentication i IIS är eneblad. 83 (159)

84 17.9. VERFIERA ESB PORTALEN PÅ NODEN Logga in på ESB-portalen, Om ni får problem kan det bero på vilka uppdateringar som har lagts på nyare som inte fanns när denna installationsbeskrivning gjordes. Om problem uppstår och Eventloggen visar Event Id 1310, hämta web.config från ESB_Webconfig som finns under tidigare uppackad folder install och konfig. Kopiera den och ersätt web.config här: C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\ESB.Portal 18. MICROSOFT MANAGEMENT SERVER ENGINE MSE Ladda ner och installera MSE. Se Länklista Starta installationsprogrammet. Klicka Next. Acceptera Licensvillkoren. Klicka Next. 84 (159)

85 Välj Custom. Klicka Next. Klicka Next. (default sökväg kan ändras, men behövs inte) 85 (159)

86 Klicka Next. Klicka Next. 86 (159)

87 Klicka Next. Vänta på att installationen skall slutföras, en dialogruta skall poppa up med information. 87 (159)

88 19. NOTIFICATION SERVICE INSTALLATION NOTIFICATION SERVICE Skapa mappen NotificationServiceSite under C:\inetpub INSTALLATIONS PROCEDUR Starta IIS. Högerklicka på Sites Add Web Site. I C:\install och konfig\notficationservice\version (eller där Installationsfiler 2.1.zip valdes att packas upp) ligger Stockholm.August.Services.Setup.Notification.msi Starta kommandopromten med Run as Administrator Exekvera installationen Skriv: cd C:\install och konfig\notficationservice\version Tryck Enter, skriv Stockholm.August.Services.Setup.Notification.msi Klicka Next. 88 (159)

89 Verifiera att värdena stämmer enligt bilden. Klicka Next. Vänta tills installationen slutförs, detta påvissas genom att en dilaogruta talar om när den är slutförd. Testa genom att ansluta till URL:en: Det kan ta en liten stund första gången då tjänsten måste startas av IIS. Ett korrekt svar visas i bilden. Om det inte skulle fungera, ändra då till.net Framework v4.0 på Applications poolen i IIS enligt bild: 89 (159)

90 Testa även URL:en: Tjänsten bör då svara som bilden. 90 (159)

91 91 (159)

92 20. VIRTUALISERING AV NOTIFIERINGSTJÄNSTEN I MSE Starta MSE Model Viewer. Välj File Import Metadata from File. Klicka Select File, välj mappen där ni har packat upp msebackup.zip. 92 (159)

93 Klicka i Import endpoint. Klicka Next. Klicka Next. Klicka Close. Testa den virtualiserade tjänsten genom att öppna Internet Explorer och ange denna adress: Klicka på översta länken svcutil.exe. Bilden visar det svar som skall erhållas. 93 (159)

94 21. BIZTALK ADMINISTRATIONSVERKTYG BIZTALK DOKUMENTER V 3.4 Ladda hem och installera Biztalk Server 2010 Documenter. Se Länklista Bläddra till den mapp du vill lägga installationsfilerna eller välj default sökväg. Klicka Next. 94 (159)

95 Klicka OK. Klicka Yes. 95 (159)

96 Klicka OK. Klicka OK. Klicka Close. 96 (159)

97 22. FILE TRANSFER Installation och konfiguration av tjänsten FileTransfer visar hur man kommer igång med en enkel fil till fil integration. För att implementera övriga protokoll, se dokumentet FileTransfer Installation och Konfigurering. Ladda ner paketet FileTransfer Här finns filen Installationsfiler 2.1.zip. Paketet innehåller ett skript som skapar en databas med konfigurations-parametrar, men utan applikationer, kunder eller logg-data. Eventuellt befintlig databas tas bort eller ändras namn på. Öppna SQL Server Management Studio. Skapa en ny databas med namnet Stockholm.FileTransfer. Högerklicka på Database och välj New Database. 97 (159)

98 Fyll i Database name: Stockholm.FileTransfer Klicka OK. Öppna filen med File Open File. 98 (159)

99 Välj filen där du packade upp filetransfer zip filen se punkt 1.1 Klicka Open. Kör skriptet med Execute. 99 (159)

100 Öppna Security Users. Högerklicka och välj New User. Klicka enligt bilden. 100 (159)

101 Skriv system. Klicka på Check Names. Klicka i [NT AUTHORITY\SYSTEM]. Klicka OK. 101 (159)

102 Klicka OK. Kryssa i db_datareader och db_datawriter i både Owned Schemas och Role Members. Klicka OK. 102 (159)

103 22.1. KATALOGSTRUKTUR Skapa följande testkataloger. Antingen manuellt eller ladda ner och dubbelklicka på filen SkapaTestkataloger.bat. C:\Test C:\Test\in C:\Test\out C:\Test\Resend C:\tmpfilestore C:\tmpfilestore\saf C:\tmpfilestore\SharePoint Ange rättigheter för BTSHostInst Starta kommandoprompten med Run As Administrator och skriv explorer. Högerklicka på C:\Test, välj Properties Security fliken, välj Edit. Välj Add tryck på Advanced och Find Now. Leta upp DEV-BTSHostInst och sedan OK. Kryssa i Full control för denna. Gör samma procedur med C:\tmpfilestore WCF-TJÄNSTER Paketet innehåller WCF:er som skall installeras eller köras som tjänster/webapplikationer. Stockholm.August.FileTransfer.Service\FileTransfer.Service.msi Är en WCF för kommunikation med databasen. Installeras som en Windows-Service. Stockholm.August.FileTransfer.Service\ConsoleHost.exe Är samma WCF som ovan men är en console-applikation för test-ändamål. Stockholm.August.WCF.FileTransfer\Service.exe Är en test-wcf service som kan användas lokalt när man vill testar konfigurationer av typen WCF (skicka från SharePoint). Är en konsol-applikation som körs igång vid test. Filen sparas i följande katalog: C:\temp\<ErrandID>\ Stockholm.August.WCF.FileTransfer\FormClient.exe Är en test-applikation (Win Form) för att kunna skicka filer till WCF ReceiveLocation och vidare till SharePoint. 103 (159)

104 22.3. FILETRANSFER.SERVICE Installera Stockholm.August.FileTransfer.Service\FileTransfer.Service.msi. Klicka Next. Klicka Next. Klicka Next. 104 (159)

105 Klicka Yes om denna dialogruta dyker upp. Klicka Close. 105 (159)

106 Starta kommandoprompten med Run as Administrator. Byt katalog till installationskatalogen genom att skriva: cd C:\Program Files (x86)\volvo Information Technology\FileTransfer WCF Service Exekvera: C:\Windows\Microsoft.NET\Framework\v \InstallUtil.exe FileTransfer.ServiceHost.exe Om allt gick bra får man detta meddelande. 106 (159)

107 22.4. BIZTALK-ADAPTER Paketet innehåller en tredjeparts adapter, Blogical BizTalk SFTP Adapter, som skall installeras innan BizTalk applikationerna installeras. Starta installationen av Blogical.Shared.Adapters.Sftp.Setup.msi, se sökväg till filen i bilden. Installera inte scheman vid installationen. Detta skall göras manuellt efteråt. Klicka Next. Klicka Next. Klicka Next. 107 (159)

108 Klicka Yes om denna dialogruta kommer upp. Välj No för att inte installera schema, som görs vid ett senare tillfälle. 108 (159)

109 Klicka Close. Starta Biztalk Administration Console. Expandera mapparna enligt bilden. Högerklicka på Adapters. Välj New Adapter. 109 (159)

110 Skriv Name: SFTP Skriv Adapter Blogical.Shared.Adapters.Sftp v1. Klicka OK. Högerklicka på Biztalk Application. Välj Add Resources. 110 (159)

111 Klicka Add. Välj Blogical.Shared.Adapters.Sftp.Schemas.dll Klicka Open. 111 (159)

112 Välj Inställningar enligt bilden. Klicka OK. 112 (159)

113 22.5. EVENTLOGGNING BLOGICAL ADAPTER För att Eventlogging ska visas korrekt behöver InstallUtil.exe exekveras med Blogical.Shared.Adapters.Common.dll. I den tidigare uppackade Installationsfiler 2.1.zip skapades katalogen install och konfig. I den finns InstallUtil. Kopiera alla filer under InstallUtil till C:\Program Files (x86)\blogical\blogical.shared.adapters.sftp Kör kommandoprompten med Run As Administrator och skriv explorer. Skriv: cd C:\Program Files (x86)\blogical\blogical.shared.adapters.sftp Skriv: InstallUtil.exe Blogical.Shared.Adapters.Common.dll Nedanstående svar skall visas efter installationen. The Commit phase completed successfully. The transacted install has completed. 113 (159)

114 22.6. BIZTALK APPLIKATIONERNA Paketet innehåller 4 BTS applikationer, som skall installeras i rätt ordning. Är en tidigare version av dessa applikationer installerade måste de tas bort innan installationen. Stockholm.August.Pipeline.Components Stockholm.August.BizTalk.Common Stockholm.August.FileTransfer Stockholm.SAF Stockholm.SB Observera: Applikationerna måste dels tas bort från BizTalk, dels måste de avinstalleras med Windows UnInstaller. Starta Biztalk Server Administration Console. Under BizTalk Group, högerklicka på Application. Välj Import MSI file. 114 (159)

115 Klicka på knappen enligt bilden Välj Common.ConfigAndLogging.msi och Open 115 (159)

116 Klicka Next. Klicka Next. Klicka Import. 116 (159)

117 Välj Run the applicarion. Klicka Finish. Klicka Next. Klicka Next. Klicka Next. 117 (159)

118 Avvakta tills installationen är klar. Klicka Next. 118 (159)

119 Klicka Close. Högerklicka Application. Välj Import MSI File. 119 (159)

120 Klicka på knappen, efter fältet MSI file to import (se bild). Markera enligt bilden. Klicka Open. 120 (159)

121 Klicka Next. Klicka Next. Klicka Import. 121 (159)

122 Klicka Finish. 122 (159)

123 Klicka Next. Klicka Next. Klicka Next. Klicka Close. 123 (159)

124 Högerklicka Application. Välj Import MSI File. Välj enligt bilden. Klicka Open. 124 (159)

125 Klicka Next. Klicka Next. Klicka Next. Klicka Import. Kryssa i enligt bilden. Klicka Finish. 125 (159)

126 Klicka Next. Klicka Next. Klicka Next. Klicka Next. Klicka Close. Högerklicka Application. Välj Import MSI File. 126 (159)

127 Välj enligt bild. Klicka Open. Klicka Next. 127 (159)

128 Kryssa i valen enligt bilden nedan. Klicka Next, Next och Import. Markera Run the Application Installation Wizard och klicka Finish. 128 (159)

129 Kör sedan Next Next Next Next Close UPPDATERA BIZTALK CONFIG Uppdatera både BTSNTSvc64.exe.config och BTSNTSvc.exe.config med binding till Stockholm.August.BizTalk.FileTransfer.Service. Texten placeras innan den avslutande </configuration> taggen. Öppna Visual Studio 2010 med Run As Administrator. Välj File Open File. Välj C:\Program Files (x86)\microsoft BizTalk Server 2010\BTSNTSvc.exe.config. 129 (159)

130 130 (159)

131 Kopiera denna text: <system.servicemodel> <bindings> <basichttpbinding> <binding name="bts_manager" closetimeout="00:01:00" opentimeout="00:01:00" receivetimeout="00:10:00" sendtimeout="00:01:00" allowcookies="false" bypassproxyonlocal="false" hostnamecomparisonmode="strongwildcard" maxbuffersize="655360" maxbufferpoolsize=" " maxreceivedmessagesize="655360" messageencoding="text" textencoding="utf-8" transfermode="buffered" usedefaultwebproxy="true"> <readerquotas maxdepth="32" maxstringcontentlength="81920" maxarraylength="163840" maxbytesperread="4096" maxnametablecharcount="163840" /> <security mode="none"> <transport clientcredentialtype="none" proxycredentialtype="none" realm="" /> <message clientcredentialtype="username" algorithmsuite="default" /> </security> </binding> </basichttpbinding> </bindings> <client> <endpoint address="http://localhost:8002/service" binding="basichttpbinding" bindingconfiguration="bts_manager" contract="ifiletransferlogging" name="bts_manager" /> </client> </system.servicemodel> 131 (159)

132 Klistra in enligt bilden, innan sista </Configuration> taggen: Spara och stäng filen. Öppna på samma sätt BTSNTSvc64.exe.config. (samma sökväg till denna fil) Ändra den likadant, spara och stäng filen. 132 (159)

133 22.8. SEND PORTS Det skall redan finnas två dynamiska send-portar upplagda. Dessa skall startas. Öppna Biztalk Server Administration Console. Under Stockholm.August.Biztalk.FileTransfer, klicka på Send Ports: Starta båda send-portarna enligt bilden. Skapa en ny send-port för loggningen, genom att: Högerklicka Send Ports, välj New Static Solicit-Response Send Port. 133 (159)

134 Konfiguera send och recive piplines enligt nedan: Send Pipeline = XML Transmit Recive pipeline = XML Receive Klicka Configure. 134 (159)

135 Konfigurera WCF-BasicHttp enligt följande (se även bild efter detta stycke): Address (URI): SOAP Action header: <BtsActionMapping xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Operation Name="FileLog" Action="http://Stockholm.August.BizTalk.FileTransferManager/IFileTransferLogging/Fi lelog" /> <Operation Name="FileLogEvent" Action="http://Stockholm.August.BizTalk.FileTransferManager/IFileTransferLogging/Fi lelogevent" /> </BtsActionMapping> Under fliken Security Välj mode: None Alla andra inställningar default. 135 (159)

136 Skapa en ny send-port för notifieringen, genom att: Högerklicka Send Ports, välj New Static Solocit-Response Send Port. Konfiguera send och recive piplines enligt nedan: Send Pipeline = PassThruTransmit Recive pipeline = XML Receive 136 (159)

137 Klicka Configure. Address (URI): SOAP Action header: 137 (159)

138 Klicka på fliken Binding. Välj Message encoding: Mtom. Klicka på fliken Security. Välj Security mode: None Klicka OK. 138 (159)

139 Klicka på Transport Advanced Options, välj Retry count: 0: Alla andra inställningar default. Starta båda portarna. 139 (159)

140 22.9. RECEIVE PORTS Högerklicka Receive Ports. Välj New One-way Receive Port. Skriv Resend_RP i fältet Name. Klicka OK. 140 (159)

141 Högerklicka Receive Ports. Välj New One-way Receive Port. Skriv FILE_RP i fältet Name. Klicka OK. 141 (159)

142 Högerklicka Receive Ports. Välj New Request Response Receive Port. Skriv WCF_RP i fältet Name. Klicka OK. 142 (159)

143 RECEIVE LOCATIONS Skapa en location för omsändningar. Högerklicka Receive Locations. Välj New One-way Receive Location. Klicka på Resend_RP. Klicka OK. 143 (159)

144 Skriv Resend_RL i fältet Name. Välj Type:FILE. Välj Receive pipeline: XMLReceive. Klicka OK. Skriv: C:\Test\Resend\ i fältet Receive Folder. Välj File mask: *.xml Allt annat skall vara default. Klicka OK. 144 (159)

145 Högerklicka Resend_RL, Välj Enable DEMO DATABAS Starta SQL Server Management Studio. Bläddra till Stockholm.FileTransfer, öppna Tables. 145 (159)

146 Högerklicka på dbo.customer, Välj Edit Top 200 Rows. Kontrollera att följande är ifyllt: ID Name ContactID 1 VIT NULL 146 (159)

147 Kontrollera på samma sätt dbo.application: ID CustomerID Name Description 1 1 Test Test of FileTransfer Högerklicka på dbo.config, Välj Edit Top 200 Rows. Börja med att kopiera tabellen nedan: ID ConfigTypeID ApplicationID Description Demo File_2_File Demo SharePoint_2_WCF Demo WCF_2_SharePoint Dubbelklicka på raden där tabellen ska in, så att den blir helt grå. Välj Paste. Högerklicka på dbo.config Parameter, Välj Edit Top 200 Rows. Kopiera tabellen nedan. ID ConfigID ParameterID Value file://c:/test/out/%sourcefilename% WCF-Custom basichttpbinding <ns0:uploadfilemessage xmlns:ns0="http://stockholm.august.biztalk.filetransfer"> <ns1:filebytestream xmlns:ns1="http://stockholm.august.biztalk.filetransfer"> <bts-msg-body 147 (159)

148 xmlns="http://www.microsoft.com/schemas/bts2007" encoding="base64"/> </ns1:filebytestream> </ns0:uploadfilemessage> UseTemplate <binding name="basichttpbinding" messageencoding="mtom" transfermode="streamedrequest"></binding> Dubbelklicka så raden är grå och välj Paste DEMO RECEIVE LOCATIONS Högerklicka Receive Locations. Välj New One-way Receive Location. Välj FILE_RP. Klicka OK. 148 (159)

149 Fyll i namnet VIT_Demo_File. I Recive pipeline, Välj FileSaverPipeline. Klicka sedan på knappen (...) till höger om detta fält. Konfigurera receive pipeline enligt följande: ArchivePath: C:\tmpfilestore\saf ConfigID: 1 Klicka OK. 149 (159)

150 Klicka på Configure, se bild. Konfigurera FILE enligt följande: Receive folder: C:\Test\in\ Filter mask: *.txt Allt annat skall vara default. Klicka OK. 150 (159)

151 Konfigurera på samma sätt nedan Receive Location: VIT_Demo_WCF Skapa en ny Request Response Receive Location med: - Receive Port: WCF_RP - Name: VIT_Demo_WCF - Type: WCF_Custom - Receive pipeline: WcfFileSaverPipeline - Send pipeline: PassThruTransmit Konfigurera receive pipeline enligt följande: - ArchivePath: C:\tmpfilestore\SharePoint - ConfigID: 3 Konfigurera WCF-Custom enligt följande: - Address (URI): - Binding: basichttpbinding - BasicHttpBindingElement, messageencoding: Mtom - BasicHttpBindingElement, maxreceivedmessagesize: Allt annat default Se till att alla Receive Locations för test får status Enable, genom att högerklicka och välj Enable. 151 (159)

152 ORKESTRERINGAR FileTransfer innehåller 4 orkestreringar, som skall konfigureras med de portar som skapats. Observera: Det går inte att koppla portar i Bindings innan det finns en ReceiveLocation till en ReceivePort. Klicka på Stockholm.August.BizTalk.FileTransfer Orchastrations. Högerklicka på Stockholm.August.Filetransfer.Filetransfer_Resend, Välj Properties. Välj RecHost1 som Host. Resend_InPort = Resend_RP. Logging_WCF_SP = WCF_Logging. Klicka OK. 152 (159)

153 Stockholm.August.FileTransfer.FileTransfer_Dispatcher Konfigurera följande bindings: Host: SendHost1 Outbound Logging_WCF_SP: WCF_Logging Outbound Notification_WCF_SP: WCF_Notification Klicka OK. Stockholm.August.FileTransfer.FileTransfer_File Konfigurera enligt nedan: Host: RecHost1 Inbound File_RecPort: FILE_RP Outbound Logging_WCF: WCF_Logging Klicka OK. 153 (159)

154 Stockholm.August.FileTransfer.FileTransfer_WCF Konfigurera enligt nedan: Host: RecHost1 Inbound WCF_RecPort: WCF_RP Outbound Logging_WCF: WCF_Logging Klicka OK. Starta alla orkestreringarna, genom att högerklicka och välj Start för varje orkestrering. 154 (159)

155 155 (159)

156 RÄTTIGHETER BIZTALK-KONTOT Rättigheter för Biztalk-kontot måste sättas i registret för DEV-BTSHostInst. Detta behövs för att File Transfer skall fungera korrekt. Klicka Start, Välj Run. Skriv Regedit. Klicka på HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\eventlog Högerklicka på Eventlog, välj Permissions. Lägg till DEV-BTSHostInst, bocka i Allow för Full Control. Starta om servern. 156 (159)

157 TEST AV FIL TILL FIL Test 1 utan notifiering Kopiera en txt-fil till C:\Test\in. Kontrollera att filen dyker upp i C:\Test\out. Kontrollera i databasen att loggningen är OK, genom att kör denna sql fråga på två rader Select top 10 * Filelog order by ID desc Select top 10 * FilelogEvent order by ID desc Kontrollera resultatet 157 (159)

158 TEST 2 RESEND UTAN NOTIFIERING Rensa C:\Test\out från eventuella filer Skapa filen ReSend.xml med följande text <ns0:resendfiledata xmlns:ns0="http://stockholm.august.biztalk.filetransfer.resendfile"> <FileLogID>1</FileLogID> </ns0:resendfiledata> Lägg filen i C:\TempFileStore\Resend Verifiera att filen dyker upp i C:\Test\out. Kontrollera loggarna. 158 (159)

159 23. LÄNKLISTA Detta är en samlad lista med länkar till allt media som används vid installationen. Samtliga är för evaluation copies, dvs. gratis under en begränsad period. Windows Server 2008 R2 180 dagar Evaluation download: Microsoft SQL Server 2008 R2 64 bit edition: BizTalk Server 2010 Evaluation: Microsoft.NETFramework 4 Microsoft Office Professional Plus Visual Studio 2010 Pro Web Deploy 2.0 x64 ASP.NET and Windows Forms Chart Controls for.net Framework 3.5 SP1 Enterprise Library 4.1-October Windows Server AppFabric BizTalk ESB Toolkit 2.1-x64.msi MagicDisc MSE BizTalk Documenter (159)