Installationsanvisning Boss delad databas
sid 2 (40) Innehåll 1 Inledning 3 2 Serverinstallation 3 2.1 Systemkrav 3 2.2 SQL Server 3 2.3 Behörighet vid installation 3 2.4 Behörighetskontroll i Microsoft SQL Server 4 2.4.1 Windows autentisering 4 2.4.2 SQL Server autentisering 4 2.4.3 Behörighetskontroll i Boss applikation 4 2.5 Skapa databaser 5 2.6 Installation av Boss klienten 6 2.6.1 Via metoden Click-Once 6 3 Nätverksinstallation 13 3.1 Åtkomstkontroll mellan applikation och databas 18 3.2 Installation av klienten Boss 18 3.2.1 Via metoden Click-Once 19 3.2.2 Inloggningsuppgifter 25 3.3 Scriptad Backup av MS SQL Express 26 3.3.1 Följande steg gäller Windows 7 och Vista 27 3.3.2 Följande steg gäller XP 31 3.3.3 Vilken användare ska köra backupjobben? 36 3.3.4 Backup till server 40 3.3.5 Hantering av backup-filer 40
sid 3 (40) 1 Inledning Boss kan installeras på flera sätt, Serverinstallation eller Nätverksinstallation. För båda dessa sätt kan man dela databasen med flera användare. I detta dokument beskrivs både Serverinstallation och Nätverksinstallation. Det är viktigt att IT-personal med behörigheter gör installationen av Boss. Serverinstallation, Boss installeras med en Microsoft SQL Server databas för delad databas på en databas-server. Se vidare avsnitt 2. Nätverksinstallation, Boss installeras med en Microsoft SQL Express databas för en användare (eller ett fåtal användare, max 5 användare) på ex en fil- eller nätverksserver. Se vidare avsnitt 3. För test- och utbildning kan Boss installeras helt lokalt på användarens dator (dock inget som rekommenderas för produktionsmiljö). Se vidare dokumentation Installation av Boss lokal databas, MS SQL Express. 2 Serverinstallation Boss rekommenderas att i första hand köras på en MS SQL Server. Det krävs dock att kommunen har licens för MS SQL Server och det finns möjlighet att lägga upp en ny databas för Boss på den. 2.1 Systemkrav Den dator som ska vara databasserver bör vara en dator/server som uppfyller följande: 1. Alltid tillgänglig. 2. Säkerhetskopiering sker. 3. Tillgänglig via nätverket för alla användare av Boss. 4. Uppfyller systemkraven för MS SQL Server 2008 r2 eller 2005 (beroende på vilken version det installeras på). 2.2 SQL Server Boss stöder MS SQL Server 2008 r2 och MS SQL Server 2005. För nyinstallation av SQL Server rekommenderas MS SQL Server 2008 r2. 2.3 Behörighet vid installation För att kunna följa installationsbeskrivningen krävs administrationsrättigheter till datorn/servern som ska köra MS SQL Server, alternativt om en existerande MS SQL Server ska användas krävs behörighet för att skapa databaser och databasanvändare.
sid 4 (40) 2.4 Behörighetskontroll i Microsoft SQL Server Boss har stöd för två olika mekanismer för att hantera behörighetskontroll till databaserna som används för att lagra applikationens data. De två mekanismer som stöds är MS SQL Server autentisering och autentisering med hjälp av Windows Integrated Security. 2.4.1 Windows autentisering För att användarna ska få åtkomst till databaserna (Boss och BossStatistik) krävs att de finns upplagda som användare (Security/Logins) med läs- och skrivbehörighet på den MS SQL Server som används. De ska även läggas upp som användare (Security/Users) för de två databaserna Boss och BossStatistik. 2.4.2 SQL Server autentisering För att använda MS SQL Server autentisering ska en intern Boss-användare läggas upp som används av applikationen. Kontakta Boss-supporten (boss@konsumentverket.se) för att få ett script (BossUserInit.sql) som skapar nödvändig Login och User i MS SQL Server. (Det är inte lämpligt att lägga detta script på Boss-sidan på Portalen då det innehåller lösenord.) OBS! Scriptet får inte ändras. 1. Anslut till MS SQL Server med MS SQL Server Management Studio (SSMS) som en användare med behörighet att skapa databaser. 2. Öppna filen BossUserInit.sql. 3. Välj Execute. 2.4.3 Behörighetskontroll i Boss applikation Behörighetskontroll i Boss kan göras på två sätt, dels direkt i applikationen, dels via Active Directory. Behörighetskontroll i applikationen Behörighetskontroll i applikationen görs genom att användarna läggs upp i Boss databas. De kopplas där till en roll (handläggare eller administratör). Registrering av användare görs av administratör i Boss. Denne lägger upp användare med användarnamn och lösenord som sparas i databasen. Användarna loggar sedan in i Boss med det användarnamn och lösenord man fått sig tilldelat. Behörighetskontroll via Active Directory Det finns också möjlighet att koppla denna behörighetskontroll till Active Directory, för att kunna använda Single Sign On inloggning och inte behöva ange lösenord varje gång. För att göra detta ska Active Directory innehålla grupperna BossAdmin respektive BossHandlaggare. Dessa läggs upp av en Domain Admin som via Active Directory Users and Computers skapar två globala grupper i Active Directory. Därefter ska de användare som ska använda Boss kopplas till respektive AD-grupp via Member Of-fliken.
sid 5 (40) Applikationen kommer att kontrollera att rätt nivå på säkerhet används (NTLM är inte tillåtet) samt om påloggad användare finns i någon av AD-grupperna. Finns användaren där och inte sedan tidigare är registrerad användare i Boss, kommer en registreringsruta att visas i Boss där information om aktuell användare hämtas från AD för vidare komplettering (dessa uppgifter används internt i Boss vid t ex brev och dokumentfunktionen, uppgifterna har dock inget med autentiseringen att göra). Användaren sparas sedan i Boss databas. Vid varje inloggning görs en kontroll av behörigheten enligt AD. Om användaren flyttas från den ena gruppen till den andra ändras också behörighetsnivån i Bossdatabasen. Om användaren inte längre ingår i någon av AD-grupperna kommer den inte längre att vara tillåten att logga in i Boss. 2.5 Skapa databaser Boss har två databaser, Boss och BossStatistik. De ska skapas innan Boss installeras och användarna kan läggas upp. För att skapa databaserna ska scripten som finns på http://bossdistribution.kov.se/ köras, länken heter Script för att skapa databas för serverinstallation, BossInstallationsscript.zip). Scripten ska köras i nedan nämnd ordning: 1. CreateBossDataBase.sql 2. BossTableInit.sql 3. BossStatistikTableInit.sql 4. BossDataInit.sql Skapa databaser För att skapa databaserna för Boss (databaserna Boss och BossStatistik) skall SQL scriptet CreateBossDataBase.sql köras. 1. Anslut till MS SQL Server med SSMS som en användare med behörighet att skapa databaser. 2. Öppna filen CreateBossDataBase.sql. 3. Välj Execute. Ärendedatatabeller Boss använder ett antal tabeller i de två databaserna. Boss databasen innehåller information om ärenden och användare, BossStatistik innehåller statistikgrundande information. För att skapa tabellerna för Boss databasen skall scriptet BossTableInit.sql köras. 1. Anslut till MS SQL Server med SSMS som en användare med behörighet att skapa databaser. 2. Öppna filen BossTableInit.sql. 3. Välj Execute. Statistikdatatabeller För att skapa tabellerna för Boss databasen skall scriptet BossStatistikTableInit.sql köras.
sid 6 (40) 1. Anslut till MS SQL Server med SSMS som en användare med behörighet att skapa databaser. 2. Öppna filen BossStatistikTableInit.sql. 3. Välj Execute. Grunddata För att fylla grunddata tabellerna skall scriptet BossDataInit.sql köras. 1. Anslut till MS SQL Server med SSMS som en användare med behörighet att skapa databaser. 2. Öppna filen BossDataInit.sql. 3. Välj Execute. 2.6 Installation av Boss klienten Installation av Boss kan göras på två olika sätt: via metoden Click-Once via msi-paket Valet Click-Once Boss distribueras och uppdateras med hjälp av ClickOnce från Konsumentverkets webserver. Grunddata och statistikgrundande data replikeras mellan installationer hos kommuner och Konsumentverket med Microsoft Sync Framework. Valet msi-paket Boss kan installeras via ett färdigpaketerat msi-paket. Kommunens IT-enhet hämtar hem paketet från http://bossdistribution.kov.se/ och distribuerar ut det till de datorer som ska ha Boss. 2.6.1 Via metoden Click-Once För att installera Boss på handläggarens dator, gå till sidan: http://bossdistribution.kov.se/
Välj länken Boss med stöd för delad databas(för Serverinstallation eller Nätverksinstallation). sid 7 (40)
sid 8 (40) Om ovanstående nödvändiga komponenter redan finns installerade på datorn, välj launch. Annars välj Install. Vid valet Install. Välj Kör. Välj Kör.
sid 9 (40) Välj Accept. Nödvändiga filer laddas ner, vänligen vänta Vid installation av Crystal reports krävs administratörsrättigheter, eventuellt visas nedan inloggningsruta om användaren inte har administratörsrättigheter på datorn.
sid 10 (40) Skriv in administratörsrättigheter (Användarnamn och Lösenord). Välj därefter OK. Installationen fortsätter Välj Installera.
sid 11 (40) Installationen fortsätter Nu är Boss installerat. Det återstår att peka ut rätt databas och att lägga upp användare för systemet. Välj flik Databas.
sid 12 (40) Skriv in IP adressen till databasen (fås från din IT-enhet eller de som installerat databasen) samt ange namnet på databasen.. Ovan är endast ett exempel på hur det kan se ut. Varje installation har olika IPadresser till databasen samt kan även ha olika namn på databasservern. Välj sedan Spara. Om Windowsautentisering används för uppkoppling mot databasen ska rutan för Integrated Security bockas i (kommunens IT-enhet vet om det används). Välj därefter flik Login. Skriv in admin i Användar ID och admin i Lösenord, tryck sedan Logga in..
sid 13 (40) Men om ni väljer att logga in med Singel Sign On ska den rutan kryssas i och användaruppgifter hämtas automatiskt från Active Directory och därefter väljs Logga in. 3 Nätverksinstallation Nätverksinstallation kan användas om kommunen saknar licens för MS SQL Server eller har plats att lägga upp ny databas på en redan befintlig MS SQL Server. Därför installeras SQL Express på en nätverksserver som de lokala installationerna av Boss pekar mot. För Nätverksinstallation ska MS SQL Server Express installeras på fil- eller nätverksserver innan Boss installeras. (Script för det finns på http://bossdistribution.kov.se/, länken Script för att installera MS SQL Server Express för nätverksinstallation InstalleraDeladSqlServerExpress.zip). Det är viktigt att välja rätt mellan 32- och 64- bitars installationspaket (välj det paket som är lämpligt för den server där databasen kommer att finnas). Att köra denna kommandofil som installerar SQLServerExpress tar ganska lång tid. För att det skall vara möjligt att använda MS SQL Server Express som en delad databas via nätverk krävs att följande funktioner är aktiverade: SQL Server Browser TCP/IP clienter
sid 14 (40) Om SQL Server-baserad inloggning skall användas krävs även att SQL Server authentication aktiveras. Se vidare länk hur det aktiveras, http://msdn.microsoft.com/en-us/library/ms188670.aspx När MS SQL Server Express är installerat ska sedan klienten Boss installeras. I samband med första installationen av Boss på en dator kommer även databaserna att skapas på den fil- eller nätverksserver som MS SQL Express finns installerat. Vi rekommenderar att första installationen av Boss sker av IT-personal, så att namnsättning och utpekning sker mot rätt server. För att automatiskt installera MS SQL Server Express med lämpliga inställningar kör scriptet för att installera MS SQL Server Express för nätverksinstallation, välj att acceptera villkoren, kör nästa igenom hela installationsguiden tills den är klar. Acceptera villkoren, klicka Next
sid 15 (40) De delar som kommer att installeras visas. Klicka Next Instanskonfigurationen visas. Klicka Next
sid 16 (40) Serverkonfigurationen visas. Klicka Next. Databasmotorkonfigurationen visas. Klicka Next.
sid 17 (40) Klicka Next för felrapporteringen Nu startar installationen. Denna kan ta mellan 10 och 20 minuter. Klicka Close när installationen är komplett
sid 18 (40) När kommandofönstret stängs är installationen klar. 3.1 Åtkomstkontroll mellan applikation och databas Boss kommunicerar med databasen med hjälp av en användare, Boss, som läggs upp automatiskt i samband med att databasen installeras. 3.2 Installation av klienten Boss Nedanstående steg ska gås igenom för att installera Boss med delad databas. Gå till http://bossdistribution.kov.se/
3.2.1 Via metoden Click-Once Välj länken Boss med stöd för delad databas(för Serverinstallation eller Nätverksinstallation). sid 19 (40)
sid 20 (40) Om ovanstående nödvändiga komponenter redan finns installerade på datorn, välj launch. Annars välj Install. Vid valet Install. Välj Kör. Välj Kör.
sid 21 (40) Välj Accept. Nödvändiga filer laddas ner, vänligen vänta Vid installation av Crystal reports krävs administratörsrättigheter, eventuellt visas nedan inloggningsruta om användaren inte har administratörsrättigheter på datorn.
sid 22 (40) Skriv in administratörsrättigheter (Användarnamn och Lösenord). Välj därefter OK. Installationen fortsätter Välj Installera.
sid 23 (40) Installationen fortsätter Nu är Boss installerat. Det återstår att peka ut rätt databas och att lägga upp användare för systemet. Välj flik Databas.
sid 24 (40) Skriv in servernamnet till MS SQL Express databasen (fås från din IT-enhet eller de som installerat databasen) samt ange namnet på databasen. Ovan är endast ett exempel på hur det kan se ut. Varje installation har olika servernamn och olika namn på databasen. Välj sedan Spara. Välj därefter flik Login. Skriv in admin i Användar ID och admin i Lösenord, tryck sedan Logga in.. När man kör Boss via nätverksinstallation ska inte Singel Sign On användas utan användarna läggs upp direkt i Boss.
sid 25 (40) Eftersom ingen databas ännu finns skapad och heller ingen användare finns upplagd måste det skapas. Svara Ja på nedan fråga för att Boss ska installeras korrekt. 3.2.2 Inloggningsuppgifter Det är viktigt att varje handläggare har sin egen inloggning i Boss. Ingen handläggare ska arbeta som administratör i Boss. Vid första inloggningen lägger administratören upp de olika handläggarna som ska finnas i systemet. Se vidare i handboken hur den funktionen fungerar. Det är endast då handläggaren ska utföra systemadministrativa arbetsuppgifter som man ska vara inloggad som administratör (ex utför gallring, administration av stödtabeller e t c).
sid 26 (40) 3.3 Scriptad Backup av MS SQL Express Backupjobb för MS SQL Express databaserna sätts upp efter att databaserna skapats. Databaserna skapas när Boss installeras på en dator första gången. Vi rekommenderar att första installationen av Boss sker av IT-personal, så att namnsättning och utpekning sker mot rätt server. 1. Skapa en mapp på C: på den dator/server som MS SQL Express är installerat på, döp mappen till Script. 2. Kopiera de tre filerna till mappen (scripten finns på http://bossdistribution.kov.se/, länken heter Script för att installera MS SQL Express för nätverksinstallation BackUpScript.zip). Backup Procedure.sql, Import Proc.cmd, SQL_Backup.cmd 3. Kör Import Proc.cmd 4. Verifiera att en ny Stored Procedure har skapats
sid 27 (40) 3.3.1 Följande steg gäller Windows 7 och Vista 5. Öppna Task Scheduler (under Accessories, System Tools) 6. Klicka först på Task Scheduler Library och sedan på Create Basic Task... 7. Skriv in ett namn och klicka på Next
sid 28 (40) 8. Välj hur ofta backup ska köras och klicka på Next 9. Välj vilket klockslag som backupen körs och klicka på Next
sid 29 (40) 10. Verifiera att Start a program är valt och klicka på Next 11. Ange att det är SQL_Backup.cmd som ska köras och ange den sökväg där backupen ska lagras (ex C:\SQLBackup\) (Sökvägen måste finnas och det är viktigt att avsluta med \). Klicka på Next
12. Klicka på Finish sid 30 (40)
sid 31 (40) 13. Verifiera genom att högerklicka på Backup_SQL och välj Run. Gör en Refresh (F5). Det ska nu stå The operation completed successfully. (0x0) under Last Run Result. 14. Högerklicka på Backup_SQL och välj Properties. I fliken General markeras kryssrutan Run wether user is logged in or not. Ange password för den användare som kör backupscriptet. 15. KLART! 3.3.2 Följande steg gäller XP 16. Gå till Kontrollpanelen, Välj Performance and Maintenance och välj Scheduled Tasks 17. Dubbelklicka på Add Scheduled Task
sid 32 (40) I den wizard som öppnas, klicka Next 18. Klicka Browse.
sid 33 (40) Leta reda på och välj filen SQL_Backup.cmd. (finns i C:\Script). Klicka Next 19. Skriv ett namn, välj hur ofta backupen ska gå och klicka Next
sid 34 (40) 20. Ange starttid och klicka Next 21. Ange vilken användare som ska köra backupen och med vilket lösenord. Klicka Next. 22. Markera kryssrutan och klicka Finish.
sid 35 (40) Följade dialog öppnas Klicka på Browse och ange det script som ska köras (C:\Script\SQL_Backup.cmd). Gör ett mellanslag och ange var backupfilerna ska lagras, (t ex C:\SQLBackup\). Ange enhet och en katalog som måste finnas. Viktigt att avsluta med \.
sid 36 (40) Ange vilken användare som ska köra jobbet. Om backupen ska köras utan att den valda användaren är inloggad måste man också ange lösenord. Annars kan man markera kryssrutan Kör bara om inloggad. Klicka OK. 23. Verifiera genom att i Scheduled Tasks högerklicka på det jobb som lagts upp och klicka Run. 3.3.3 Vilken användare ska köra backupjobben? Man bör skapa ett eget användarkonto för backupjobben. Om man kör backupjobbet med ett vanligt användarkonto slutar scriptet att fungera den dagen som användaren byter lösenord. Om backupen ska sparas lokalt är det enklast att lägga upp ett lokalt Admin-konto som man kopplar till backupjobbet. Om backupen ska sparas på nätverket någonstans måste man ha ett konto med behörighet att ta backup på klienten samt ha rättigheter att skriva till den mapp som backupjobbet skriver till. 3.3.3.1 Lokal backup Om backup ska sparas lokalt på klienten rekommenderas att den sparas på en USBdisk. 1. Skapa ett lokalt konto (ex SQL-Backup)
sid 37 (40) 2. Sätt ett lösenord enligt er lösenordspolicy och välj inställningar enligt bild 3. Se till att det nyskapade kontot har rätt att logga in (Log on as a batch job). Starta Local Security Policy och konfigurera detta under User Rights Assignment. 4. Koppla detta konto till det schemalagda jobbet.
sid 38 (40) 5. I Microsoft SQL Server Management Studio, skapa ett nytt konto. 6. Ange kontot som du skapade för backup 7. Under User Mapping, välj de två Boss-databaserna och sätt db_backupoperator för båda databaserna. Välj master och verifiera
sid 39 (40) att endast public är satt. Klicka på OK. 8. Välj Properties på dbo.sp_backupdatabases.
sid 40 (40) 9. Under Permissions, klicka search och leta upp backupkontot. Välj Execute för kontot. Klicka på OK. 10. Verifiera att kontot har rättigeter till den mapp som backupen skrivs till. 3.3.4 Backup till server Samma som ovan men kontot skapas i Active Directory, och alla kontohänvisningar är givetvis till domänkontot. Som sökväg till mappen anges lämpligen en UNC-sökväg (\\server\mapp). 3.3.5 Hantering av backup-filer Lagra backup och databasfiler på olika ställen för att kunna återskapa eventuell förlorad data. Tänk på att det skapas två nya backupfiler (en för Boss-databasen och en för statistikdatabasen) varje dag, så skapa en rutin för borttag av gamla backupfiler.