Produktdokumentasjon

Transkript

1 ... 1 Forord... 4 Beskrivelse av programmet... 4 Lagdeling... 5 Figur: bblag Samsvar mellom kravspesifikasjon og produkt... 6 BissBase.DAL... 6 BlissBase (Web applikasjonen)... 7 Hoveddeler i programmet... 9 BlissBase.DAL (Data Access Layer)... 9 Introduksjon... 9 Figur: bbdal Symbolrelasjoner Figur: bbdal Synonymrelasjoner Figur: bbdal Brukertabellen med tilhørende Figur: bbdal Kodingen av DAL BlissBase.BLL (Business Logic Layer) BlissBase.Model (Modeller) BlissBase (Web applikasjonen) BlissBase.UT (Unit testing) Brukerveiledning Webapplikasjon Brukerregistrering Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb

2 Innlegging/opplasting av symboler Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Konvertering av Raw Symbol til Base Symbol Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Konvertering av Raw Symbol til Composite Symbol Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Skriving med symboler Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Figur: bbweb Bytte av språk Figur: bbweb Figur: bbweb Installasjon og driftsveiledning (Publish) Publiser applikasjonen Velg database tilkoblingen for din server

3 Figur: bbvs Figur: bbvs.1.1, bbvs Bygg applikasjonen med innstillinger for (release) Figur: bbvs Publiser pakken Figur.bbvs Figur: bbwin (Deploy) Installasjon av tjenester og BlissBase Installere IIS som Windows feature Figur: bbwin Lage en ny Site BlissBase Figur: bbwin Installere SSL sertifikat Figur: bbiis Figur: bbiis Installere og konfigurere MySql (Installasjon) Figur: bbwin (Konfigurering) Installere BlissBase Figur: bbwin Opprette Import mappe (Manage) Drift av applikasjonen Oppdater BlissBase applikasjonen Eksport av databasen (MySql) Figur: bbwin Import av database fil (MySql) Figur: bbwin

4 Forord Denne dokumentasjonen kommer til å gjennomgå programmets oppbygging, lagdeling og gi en innføring i applikasjonens enkelte lag. Den vil også inneholde en installasjonsveiledning, med noen føringer rundt drift og sikkerhet. Applikasjonen er utviklet for en bedrift med utviklere og dette dokumentet er ment for bedriften, og sensor. Dokumentet er derfor rettet mot personer med kompetanse rundt databaser og webutvikling. I installasjonsveiledningen tar vi også høyde for at personen som leser dette dokumentet har kjennskap til Visual Studio, og Windows generelt. Ved bruk av bilder og steg for steg veiledning i installasjonsdokumentet mener vi at det kan brukes av alle som er godt kjent med Windows. Beskrivelse av programmet BlissBase er et program som sikter mot å lage en relasjonsdatabase for Bliss symboler der det kan lages relasjoner mellom grunnsymboler og sammensatte symboler. Databaselaget «BlissBase.DAL» Har tatt høyde for at brukere skal kunne lage synonymer, sammensatte symboler skal kunne bli koblet med en språkkode, grunnsymboler skal kunne ha en type, m.m. Dette går vi nøyere inn på i databasedokumentasjonen. BlissBase.BLL er en pakke Business Logic Layer, som fungerer som grensesnittet til BlissBase.DAL BlissBase pakken er webapplikasjonen som er ment som en prototyp test på bruk av DAL. Etter ønske fra oppdragsgiver inneholder webapplikasjonen mulighet for import av Bliss symboler, mulighet for å definere grunnsymboler og sammensatte symboler med relasjoner i databasen. Webapplikasjonen har også et skriveprogram som lar brukeren skrive med symboler og få forslag fra et kontrollert vokabular. Webapplikasjonen lar også brukeren bytte språk, og vi har lagt til engelsk, norsk og svensk etter ønske fra oppdragsgiver. Videre har vi brukt lagdeling som muliggjør å bruke DAL, BLL og Model prosjektenes.dll er som bibliotek i andre prosjekter. Dette valgte vi for å møte oppdragsgiver sitt ønske om en gjenbrukbar database med en prototyp webapplikasjon. 4

5 Lagdeling Figur: bblag.1.0 Lagdelingen kort forklart. (Mer detaljert gjennomgang kommer for de enkelte lag) Som vanlig i lagdeling kan et lag kun kommunisere med laget rett under. Dette vil si at web applikasjonen kun kan kommunisere med BLL en, BLL kan kun kommunisere med DAL og DAL er det eneste laget som kontakter DMS. Dette skaper ett veldig oversiktlig hierarki. I tillegg gjør denne lagdelingen at man kan skrive om hele DAL og la resten av applikasjonen være uforandret så lenge de samme metodesignaturene blir beholdt. Med små endringer (eller ingen) kan man bytte DMS et for eksempel fra MSSQL til MySql. En utfordring denne type lagdeling byr på er at hvis man skal bruke data som er hentet fra en tabell (Users) som er definert i DAL.Users, så kan ikke Web applikasjonen bruke dette. Det finnes ikke noen referanse til DAL i Web applikasjonen og web laget kan derfor ikke opprette et objekt av Users. Derfor må det implementeres en pakke «.dll» Model som er tilgjengelig for alle lag. På denne måten kan lagene kommunisere data mellom hverandre i form av modeller. Dette er del av kjernen i «M»VC. 5

6 Samsvar mellom kravspesifikasjon og produkt Alle kravene som ikke er oppfylt i BlissBase ansees som «ikke enda implementert» Det er uansett implementert mesteparten av kravene og det som er implementert vil gi en god idé om hvordan resten kan implementeres. Det er også nøye kommentert i BlissBase.DAL hva hver klasse og metode gjør. Vi har også konfigurert Doxygen til å lese kommentarene i hele løsningen og generer en søkbar webside over alle pakker, klasser og metoder i prosjektet. Denne siden er tilgjengelig på vårt område på HIOA Denne siden vil være en god hjelp for alle som bruker prosjektet som et bibliotek eller som videreutvikler web applikasjonen. Utfra kravspesifikasjonen har vi implementert store deler av kravene. Noen punkter har vi derimot ikke rukket å implementere. Videre følger det punkt for punkt der hvor vi ikke har oppfylt kravspesifikasjonen. BissBase.DAL Krav: Det var et krav at brukere skulle kunne lage synonymer. Disse skulle ikke være godkjent for bruk, men skulle måtte godkjennes av en bruker med økte rettigheter «en pedagog eller annen person med nødvendig kompetanse». Etter at synonymene ble godkjent skulle brukeren som hadde lagd synonymet kunne bruke det som et hvilket som helst sammensatt symbol. Hvis synonymet viste seg og være pedagogisk korrekt skulle en administrator ha muligheten til å merke synonymet som et globalt synonym hvor alle brukere av BlissBase kunne bruke synonymet fritt. Mangler: I databasen har vi en tabell (Admins) som har ett felt UserID. Kort forklart vil alle brukere som har sin bruker ID i Admins tabellen være en administrator. Det er derimot ikke mulighet for å skille mellom brukere med økte rettigheter og administrator, en bruker er enten administrator eller ikke. Løsning: Admins tabellen kunne fått et nytt felt, «ElevatedLevel» [Required]. BlissBase.Model.Admin ville blitt utvidet med det nye feltet og fått lagt til: «public enum ElevationLevels { ADMIN = 1, ELEVATED = 2 }» Videre kunne Admins tabellen fått et nytt navn «ElevatedUsers». Ved 6

7 å styre rettighetsnivået med en enum hadde det vært veldig enkelt å utvide med nye brukertyper etter hvert. BlissBase (Web applikasjonen) Krav: Det skal være mulig og velge både grunnsymboler og sammensatte symboler, som komponenter når det defineres et nytt sammensatt symbol. Mangler: Når man definerer et nytt sammensatt symbol vil man kun kunne velge mellom de forskjellige grunnsymboltypene. [symboler, indikatorer, bokstaver, tall] Løsning: Lage en fane til i /RawList/ConvetToComposite som heter «Composite». Denne kan på samme måte som grunnsymboler bli fylt med resultatet fra BlissBase.DAL.CompositSymbolDAL.GetALL() Hvis et symbol fra Composite fanen blir valgt hentes komponentene ut fra databasen med BlissBase.DAL.CompositeOfDAL.GetComponentsOf(CompositeSymbol). Denne metoden sender du inn det valgte Composite symbolet og får tilbake en liste med alle grunnsymbolene det består av. Disse legges til det nye sammensatte symbolet på samme måte som andre grunnsymbol. Krav: Brukere skal kunne lage synonymer. Mangler: Ikke implementert. Løsning: Dette kan gjøres på nøyaktig samme måte som å definere et nytt sammensatt symbol, med en modifikasjon. I stedet for å kalle BlissBase.DAL.CompositeSymbolDAL.Insert(CompositeSymbol, List<Symbol>), så gjør man et kall på BlissBase.DAL.UserSynonymDAL.InsertSynonym(CompositeSymbol, string, List<Symbol>). Denne metoden tar ordet det skal lages synonym for som første parameter, navn på synonymet som andre parameter og listen over grunnsymboler «komponenter» som 7

8 tredje parameter. I prosessen av å sette inn synonym vil alle bildefilene til alle komponentene bli satt sammen til en ny bildefil. Dette bildet vil være synonymets bildedata. Krav: Det skal vær mulig å godkjenne synonymer for en bruker. Mangler: Brukeren skal kunne lage synonymer, bruker gruppe for pedagoger som kan godkjenne bruker synonymer. Løsning: Bruk løsning nevnt i BlissBase.DAL for å få riktige brukergrupper. Bruk løsning for at «Brukere skal kunne lage synonymer» Videre må det lages en kontroller og en view «SynonymAdministration» som er tilgjengelig fra «SymbolAdministration» siden på web. I den nye siden må man liste opp alle brukersynonymer. Dette kan gjøres med BlissBase.DAL.UserSynonymDAL.GetAll(). Eventuelt kan man bruke GetSynonymForWord(), eller GetSynonymForUser() hvis man har ønske om å sortere resultatet. For å så godkjenne et synonym for en bruker brukes metoden SetUserSynonymApproved(int, bool) der integerverdien er id til synonymet og boolean en er om synonymet skal godkjennes eller om godkjenningen skal trekkes tilbake. Krav: Det skal være mulig å sette ett synonym som globalt (Tilgjengelig for alle brukere) Mangler: Brukere skal kunne lage synonymer. Synonymer skal kunne settes Globale. Løsning: Bruk løsning fra Det skal vær mulig å godkjenne synonymer for en bruker. Videre implementerer man et «sett global» valg på listen over brukersynonymer. Man kan da bruke «UserSynonym» modellen som ble valgt i listen og sende med innholdet til BlissBase.DAL.GlobalSynonymDAL.InsertSynonym( ). Etter dette er gjort, er det ikke noe behov for å beholde synonymet i brukerens liste, så man kan kalle metoden BlissBase.DAL.UserSynonymDAL.DeleteSynonym(id). Denne metoden tar IDen til synonymet som skal slettes, og fjerner det fra «UserSynonyms» tabellen. 8

9 Hoveddeler i programmet Vi har vært nøye på å dokumentere alle metoder i programmet. Kommentarene for Public metodene kan sees på Resten av kommentarene finnes i kildekoden og ansees som en del av dokumentasjonen. BlissBase.DAL (Data Access Layer) Introduksjon Som man ser på bildet over består databasen av 12 tabeller. Tabellene med størst betydning for databaselaget er CompositeSymbols, CompositeOf og Symbols. Det er disse tabellene som danner grunnlaget for at det skal kunne lages relasjoner mellom sammensatte og grunnsymboler. 9

10 Figur: bbdal.1.0 Vi har vært nøye på å holde databasen på 3NF (tredje normalform). Det har også vært sørget for å designe alle grunnelementene i databasen før implementeringen begynte. Vi har på den måten endt opp med et godt design og tabeller uten NULL verdier. Mer om prosessen ligger i prosessdokumentasjonen. 10

11 Symbolrelasjoner Figur: bbdal.1.1 Her har vi kjernen til databasen. Det er CompositeSymbols, CompositesOf og Symbols som er hoved tabellene i figur bbdal.1.1. Det vil si, CompositeSymbols og Symbols. CompositesOf er en mellomliggende tabell for «mange til mange» forholdet mellom CompositeSymbols og Symbols. Symbols og CompositeSymbols inneholder liknende felter, «ID, Navn og JPEG». JPEG er et navn som ikke har blitt byttet siden starten av utviklingen. I realiteten kan både PNG og JPEG bilder importeres fra filer med «.jpg.jpeg.png» endelser. Vi anbefaler å bruke PNG bilder med transparent bakgrunn da det er lettere å legge til stil på bildene. Grunnen til at grunnsymboler og sammensatte symboler er skilt ut i hver sin tabell er at de har forskjellige behov. Symbols har en SymbolTypes tabell som indikerer om et grunnsymbol er standardsymbol, indikator, tall eller bokstav. Dette gjøres ved en enum i BlissBase.Model.SymbolType, som inneholder typekoder. På samme måte har CompositeSymbols en tabell Language og CompositeScores. Language fungerer på samme måte som SymbolTypes og har en enum som inneholder språkkoder. CompositeScores brukes av det kontrollerte vokabularet til sortering av forslag. Hver gang et sammensatt symbol som vises som forslag blir valgt, oppdateres CompositeScores for det symbolet. «Symbolets poengsum økes med 1». 11

12 Synonymrelasjoner Figur: bbdal.1.2 Det er UserSynonyms og GlobalSynonyms som muliggjør oppretting av synonymer. Måten dette er designet på er med en enkel filosofi at det ikke er forskjell på synonymer og sammensatte symboler. Grunnsymboler er det ikke mulig å lage synonymer på da det ikke har noen praktisk hensikt. Derimot har oppdragsgiver lagt ned i kravspesifikasjonen at en bruker skal kunne forandre skrivemåten til et synonym. Måten dette gjøres på er at det kan lages et nytt sammensatt symbol og sette det som et synonym til et eksisterende sammensatt symbol. Dette gjøres ved å velge en liste grunnsymboler og ett navn og deretter sende dette til UserSynonymDAL.InsertSynonym() sammen med symbolet du skal lage et synonym for. Du vil da ha lagd et nytt sammensatt symbol, satt det inn i CompositeSymbols tabellen og definert det som et synonym. UserSynonyms har et par felter GlobalSynonyms ikke har. UserID og USynApproved. UserID er enkelt og greit bruker ID til brukeren som har lagd synonymet. USynApproved er en boolean som indikerer om brukeren står fritt til å benytte seg av synonymet. 12

13 For å gjøre et synonym globalt, flytter man ID en til ordet og synonymet over til GlobalSynonyms. GSynWord = USynWord, GSynSynonym = USynSynonym. Det er da trykt og samtidig slette raden i UserSynonyms ettersom globale synonymer er tilgjengelig for alle. Brukertabellen med tilhørende Figur: bbdal.1.3 Det som vises på figur bbdal.1.3 er Users, Admins og UsersSynonymList. UserSynonymsList er kun lagd så man slipper å lete gjennom UserSynonms tabellen for å se om en bruker har synonymer. En bruker kan ha «ubegrenset» mange synonymer, men kun en oppføring UsersSynonymList. Søk på denne listen vil derfor gå mye raskere. Admins tabellen har også kun ett felt, UserID. Dette betyr at alle brukere i Admins tabellen er ansett som administratorer. Det er foreslått endringer på denne tabellen i «Samsvar mellom kravspesifikasjon og produkt». Users tabellen inneholder en oppføring for alle brukere. Vi har ikke valgt å ta med mye personalia da det ikke har vært noe som har blitt spesifisert fra oppdragsgiver. Vi har kun tatt med brukernavn, fornavn og etternavn for å identifisere brukere. Tabellen kan naturligvis enkelt utvides med felter som adresse, epost, osv. om det er ønsket. 13

14 Videre har alle brukere en unik bruker ID, et passord og «salt». Saltet er for øyeblikket kun brukt for å maskere passordet i databasen i tilfelle uvedkommende skulle klare å få tilgang. Kort forklart kan det nevnes at UserSalt brukes til å utføre en sikrere hashing av passordet. Dette er tilfelle noen skulle bryte seg inn «hacke» databasen, skal det fortsatt være en stor utfordring å kunne få tak i passord. Alle passord blir satt sammen med et tilfeldig generert «salt» og hashet med SHA256. Eneste mulighet for å finne et passord vil derfor være å sende nøyaktig samme passord gjennom den samme algoritmen for å se om resultatet samsvarer. Når passord blir hashet med SHA256 får alle resultater samme lengde uansett hva som blir sendt inn. Det er heller ikke noen sammenheng med hvor lav eller høy verdien til hashen blir utfra passordet som blir hashed, så man har derfor ingen indikasjon på hvor man skal starte. I avsnittet om «Drift av applikasjonen» går vi nærmere inn på drift av applikasjonen hvor det blant annet anbefales bruk av SSL. Alle brukere har også ett felt UserApproved. Dette feltet står som false etter at en bruker har opprettet en konto, og må settes til true av en administrator før en ny bruker kan logge inn. Vi har ikke implementert mulighet for å administrere det fra webapplikasjonen, så dette må gjøres i SQL. Dette er også forklart i avsnittet om «Drift av applikasjonen». Kodingen av DAL Vi har bygget database laget ved hjelp av «Entity Framework» og «Code First». Alle tabellene er klasser definert i filen BlissBase.DAL.BlissBaseContext. Alle tabellene har også en tilhørende DAL klasse. «Som eksempel for Users tabellen finnes det en BlissBaseDAL.UserDAL». Alle metoder som kjører spørringer på en tabell finnes i den tilhørende DAL klassen. Hvis det er behov for å oppdatere en tabell fra DAL klassen til en annen tabell, gjøres dette med metodekall for å benytte seg av «Code First» filosofien. Som eksempel, hvis man skal sette inn et nytt synonym brukers UserSynonymDAL. Det er i midlertid nødvendig å lage et nytt sammensatt symbol for synonymet. Dette gjøres ved at CompositeSymbolDAL.CreateCompositeByComponents() blir kalt fra UserSynonymDAL.InsertSynonym(). Dette gjør at bruken av databasen blir forenklet. Det blir ikke veldig komplekse spørringer som kan være vanskelig å vedlikeholde, endre og utvide. Vi synes derfor vi har et veldig oversiktlig og gjennomført databaselag. Som nevnt i avsnittet om «Lagdeling» er DAL pakken avhengig av BlissBase.Model, og bruker BlissBase.BLL som et grensesnitt til resten av applikasjonen og eventuelle andre programmer som kan benytte seg av den. Alle klasser, og alle metoder er nøye kommenter i koden. Hele databaselaget følger oppbyggingen forklart i overordnede avsnitt, og skal være enkel å manøvrere seg i. Det ligger 14

15 også en søkbar side over alle public metoder i DAL og Controllers på HIOA sine sider. BLL og Model er også tatt med i dette dokumentet, men er ikke kommentert da det er åpenlyst hva de gjør. Så lenge man har satt seg inn i denne dokumentasjonen. Kommentarer i koden ansees som en del av dokumentasjonen. Alle C# filer i dette prosjektet med.cs filendelse er egen generert. De resterende filene er generert av Visual Studio, men kan ha blitt redigert manuelt. BlissBase.BLL (Business Logic Layer) Denne pakken fungerer som laget mellom BlissBase og BlissBase.DAL.Dette er en del av lagdelingen og gjør det mulig å ha et fast grensenit nett l DAL. På denne måten kan endringer bli gjort i DAL uten at det er nødvendig å gjøre endringer i webapplikasjonen eller andre applikasjoner som kan benytte DAL, BLL og Model som et bibliotek. Vi hadde i utgangspunktet tenkt til å legge det kontrollerte vokabularet i BLL, men fant ut at det var bedre om dette kjørte på klienten ved hjelp av JQuery. Noe som burte gjøres er å flytte Exception håndteringen til BLL en. Da ville det vært enklere å skrive unit tester til DAL som sjekker at det kastes Exceptions ved ugyldige parameterverdier, eller andre situasjoner hvor en metode prøver på en ugyldig operasjon. Dette kan sees på som et punkt i videre utvikling. Alle C# filer i dette prosjektet med.cs filendelse er egen generert. De resterende filene er generert av Visual Studio, men kan ha blitt redigert manuelt. BlissBase.Model (Modeller) Model laget er et lag som er tilgjengelig for alle andre lag. Dette er for å kunne sende data mellom lag som ellers ikke har kontakt. Nesten alle klassene i BlissBase.Model inneholder de samme feltene som tilsvarende tabelldefinisjon i BlissBase.DAL.BlissBaseContext.cs. Unntak er SubscribeViewModel, som håndterer data fra skjemaet for å lage brukerkonto. Og SuggestionsModel som håndterer forslag med symboler til skjermtastaturet i BlissBase/Write/Index. Alle C# filer i dette prosjektet med.cs filendelse er egen generert. De resterende filene er generert av Visual Studio, men kan ha blitt redigert manuelt. 15

16 BlissBase (Web applikasjonen) Webapplikasjonen bruker flere forskjellige Controller'e til å ta i bruk metodene som i BLL, som igjen bruker metodene i DAL. I webapplikasjonen kan du registrere deg som en bruker, logge inn, og få tilgang til «Symbol Administration». Her kan man laste opp nye symboler, konvertere dem til grunnleggende symboler eller til sammensatte symboler. Når man konverterer et symbol til et sammensatt symbol, velger man da fra en liste grunnleggende symboler de symbolene som inngår i det sammensatte. Slik blir relasjonene mellom grunnleggende symboler og sammensatte symboler skapt. Tastaturet vårt tar i bruk disse relasjonene. I tastaturet kan man skrive med de symbolene som ligger i databasen, både grunnleggende og sammensatte. Knappene i tastaturet er grunnleggende symboler som har blitt fordel i fire forskjellige kategorier: «Symbol» (Normale Symboler), «Indicators», «Numbers» og «Letters». De grunnleggende symbolene kan enten brukes til å skrive med for seg selv, eller til å søke opp et sammensatt symbol. En forslagsliste vil dukke opp når man trykker på ett grunnleggende symbol, og denne forslagslisten inneholder da forslag til sammensatte symboler basert på relasjonene som nå ligger i databasen. Forslagslisten blir generert og filtrert av de symbolene som har rød understrek i input-feltet. Navnet på symbolene vil dukke opp både i tastaturet, forslagslisten og i input-feltet dersom man tar musen over symbolene. BlissBase.UT (Unit testing) Dette laget inneholder en Unit test klasse for alle lag med C# kode (UnitTestsDAL, UnitTestsBLL og UnitTestControllers). Vi så ikke noen grunn til å lage unit test klasse for BlissBase.Model, da det kun er {set; get;} metoder og enum i disse klassene. BlissBase.UT/App.config er satt opp med de samme «connection strings» som resten av applikasjonen, men har engen testing database. Vi kom dessverre sent i gang med å lage unit tester, så det er i skrivende stund veldig få tester, men grunnlaget for å skrive tester til prosjektet er lagd, så det er en naturlig del av videre utvikling av prosjektet. Alle C# filer i dette prosjektet med.cs filendelse er egen generert. De resterende filene er generert av Visual Studio. BlissBase.UT/App.config har flere manuelle endringer. 16

17 Brukerveiledning Webapplikasjon Detter er en kort veiledning ment for å vise hvordan denne webapplikasjonen fungerer. Her vil vi gå igjennom brukerregistrering, innlegging av symboler, konvertering av symboler, relasjonsskapning, skriving med symboler og bytte av språk. Brukerregistrering Figur: bbweb1.0 På navigasjonsbaren til nettsiden vil det ligge en knapp hvor det står «Sign-Up» (Engelsk). Vi trykker på denne for å kunne registrere oss som brukere på nettsiden. Figur: bbweb.1.1 På «Sign-Up» siden fyller vi ut all nødvendig informasjon, og trykker deretter på «Complete Registration». Her er det validering på navnefeltene, og det sjekkes om et brukernavn allerede eksisterer. «Confirm Passord» brukes til å dobbeltsjekke «Password». Dette hjelper brukerne med å være helt sikre på at passordet de skrev inn var skrevet riktig. 17

18 Figur: bbweb.1.2 Denne beskjeden blir da vist på skjermen ved fullført registrering. Etter at administrator har godkjent brukeren din, vil du da kunne logge inn ved å trykke på «Log In». Figur: bbweb.1.3 Deretter fyller du ut informasjonen: Figur: bbweb.1.4 Hvis innlogging er vellykket vil du da bli sendt til MyPage, brukerens hjemmeside, sammen med denne beskjeden: Figur: bbweb.1.5 Innlegging/opplasting av symboler 18

19 Nå skal vi ta en titt på hvordan vi skal laste opp symboler. Når vi først laster opp symboler, vil de bli konvertert til en litt mindre størrelse, og satt in i en tabell i databasen som heter RawSymbolImport, så fra nå av refererer vi til symbolene i denne tabellen for «Raw Symbols». For å sette inn et «Raw Symbol» må du først logge inn. Etter at det har blitt gjort trykker du på «Symbol Administration». Figur: bbweb.1.6 Da vil du komme til denne siden: 19

20 Figur: bbweb.1.7 Figur: bbweb.1.8 Her trykker du da på «Velg filer» (Norsk pga. browser), velger minst én fil, og trykker deretter på «Upload Images of Bliss symbols». Du vil få en beskjed om at opplastingen var vellykket, og hvor man filer du har lastet opp. For nå så laster vi opp én fil og sjekker hva som skjer. 20

21 Figur: bbweb

22 Konvertering av Raw Symbol til Base Symbol Nå har vi lastet opp et tegn, og dette tegnet vil nå ligge i «Raw Symbols»-tabellen. Vi kan nå enten trykke på den blå «Raw Symbols» knappen rett under fil-opplastningsknappen, eller ta musen over «Symbol Administration» i navigasjonsbaren og deretter trykke på «Raw Symbols». «Raw Symbols»-tabellen ser slik ut: Figur: bbweb.2.0 Her kan vi konvertere et symbol til enten et «Base Symbol», altså et grunnleggende symbol, eller til et «Composite Symbol», altså et sammensatt symbol. For å kunne legge til et sammensatt symbol, må noen av symbolene i «Raw Symbols» tabellen ha blitt konvertert til «Base Symbols», ellers vil det ikke være mulig å konvertere til «Composite Symbol». Dette fordi de sammensatte symbolene er sammensetninger av de grunnleggende, og uten de grunnleggende symbolene vil vi ikke kunne skape relasjonene mellom de grunnleggende og det sammensatte. Vi vil gå igjennom denne prosessen litt senere, men for nå skal vi velge det symbolet vi nettopp lastet opp, symbolet til Wheel (hjul). 22

23 Figur: bbweb.2.1 Vi trykker så på «Convert to Base Symbol», og får opp denne siden: Figur: bbweb.2.2 Her ser vi ID til symbolet, men detter er da ID'en til symbolet i «Raw Symbols»-tabellen. Deretter har vi navnet på symbolet, bildet og symbol type. På symboltype må du velge om dette symbolet skal være et normalt grunnleggende symbol, en indikator, et nummer eller en latinsk bokstav. En indikator er et symbol som befinner seg over andre grunnleggende symboler, og forteller oss om et symbol skal leses som et substantiv, adjektiv, verb, osv.. Vi velger «Normal Symboler», og trykker så på «Save». 23

24 Figur: bbweb.2.3 Vi blir da sendt til denne tabellen, tabellen for «Base Symbols». Vi får beskjed om at konverteringen av raw symbolet «Wheel» til et «Base Symbol» var vellykket. «Wheel» blir da slettet fra «Raw Symbol»-tabellen og blir lagt til i «Base Symbol»-tabellen. Her kan man trykke på «Edit» for å endre på symbolets verdier/attributter, eller «Delete» for å slette det. Knappene over tabellen brukes til enten å dra tilbake til «Raw Symbols»-tabellen, eller for å dra tilbake til «Symbol Administration». Konvertering av Raw Symbol til Composite Symbol Her skal vi konvertere et «Raw Symbol» til et «Composite Symbol». Vi laster da opp et bilde i «Symbol Administration», og blir sendt til «Raw Symbol»-tabellen. Deretter finner vi symbolet vi nettopp lastet opp og trykker på «Convert To Composite Symbol». Siden vi allerede har lastet opp «Wheel» og konvertert det til et «Base Symbol», laster vi opp et symbol som inneholder symbolet «Wheel» som et grunnleggende symbol. Deretter trykker vi på «Convert To Composite Symbol» og får opp denne siden: 24

25 Figur: bbweb.2.4 Her ser vi ID'en til symbolet i «Raw Symbols» tabellen, navnet på symbolet og bildet. Listen under brukes til å finne de symbolene som er «byggeklosser» i «Cart, carriage». I dette tilfellet har vi valgt symbolene «Wheel», «Forward» og «Enclosure». Tab'ene brukes til å få opp indikatorer, nummere og bokstaver, men siden dette symbolet ikke inneholder noen av dem, trenger vi ikke å gå inn i dem. 25

26 Vi trykker nå på «Save» og kommer til denne siden: Figur: bbweb.2.5 Dette er tabellen for «Composite Symbols». Her kan man trykke på «Edit» for å endre på sammensatte symbolet, og «Delete» for å slette det. 26

27 Her ser vi symbolet vårt: Figur: bbweb.2.6 Symbolet vårt, «Cart, Carriage», ligger nå i denne tabellen. Vi ser på bildet over at vi fikk en melding om at «Raw Symbol 'cart, carriage' is now a composite symbol», og dette betyr da at relasjonene mellom de grunnleggende symbolene og det sammensatte symbolet «cart, carriage» nå eksisterer i databasen. Dersom man sletter et «Composite Symbol», vil også relasjonene mellom symbolet og «Base Symbol»'ene slettes. «Base Symbolene» finnes fortsatt, men de har da ingen relasjon til det symbolet som nettopp ble slettet liggende i databasen. Hvis man sletter et «Base Symbol» derimot, vil symbolet bli slettet fra databasen, samt alle relasjonene som det symbolet hadde med sammensatte symboler. Altså hvis et «Composite Symbol» har en relasjon til «Base Symbol» med ID 7, en relasjon til «Base Symbol» med ID 8 og en relasjon til «Base Symbol» med ID 9, og «Base Symbol» med ID 7 blir slettet, vil kun den relasjonen slettes, mens det sammensatte symbolet beholder relasjonene til «Base Symbol»'ene med ID 8 og 9. Hvis vi trykker på «Edit», vil vi se at ID'ene til «Base Symbolene» dukker opp i et eget felt, og at alle grunnleggende symboler som «cart, carriage» består av på forhånd har blitt avkrysset. 27

28 Figur: bbweb.2.6 Skriving med symboler Her skal vi demonstrere hvordan man skriver med symbolene som ligger i databasen, både «Base Symbols» og «Composite Symbols», altså grunnleggende og sammensatte symboler. Tastaturet vårt består av knapper som tilsvarer hvert eneste grunnleggende symbol som ligger i «Base Symbols»-tabellen. Knappene er fordelt i typene «Symbols», «Indicator», «Number» og «Letter». 28

29 Figur: bbweb.2.7 Hvis man tar musen over en knapp, vil det dukke opp en boks med navnet på symbolet: Figur: bbweb

30 La oss nå taste inn det symbolet og se hva som skjer: Figur: bbweb.2.9 Vi ser symbolet vi trykket på ligger nå i input-feltet med en rød understrek, og at vi har fått noen knapper til høyre her. Knappene til høyre er forslag til sammensatte symboler. Disse forslagene dukker opp på grunn av relasjonene som ligger i databasen. Siden det grunnleggende symbolet vi trykket på har en relasjon til de fire symbolene til høyre, dukket de fire opp som forslag. Den røde streken under det grunnleggende symbolet som ligger i input-feltet, forteller oss at vi akkurat nå er i «Forslags Modus». Dette betyr at symbolet blir brukt til å generere og filtrere forslagslisten til høyre. En grundigere forklaring blir gitt i løpet av disse sidene, så det er bare å lese videre. 30

31 Hvis vi nå trykker på det grunnleggende symbolet til høyre for den første vi trykket på, vil vi se dette: Figur: bbweb.3.0 Vi ser nå at det grunnleggende symbolet vi trykket på også har blitt satt inn i inputfeltet, og at denne også har en rød understrek. Dette betyr at de to symbolene som vi tastet inn ble brukt til å generere og filtrere forslagslisten til høyre. Vi ser klart og tydelig at forslagslisten til høyre har nå blitt filtrert. Den gikk fra fire knapper til kun en knapp. Dette fordi de grunnleggende symbolene med rød understrek har relasjoner til det symbolet som nå ligger som et forslag til høyre. Dersom vi trykker på et grunnleggende symbol som ikke har en relasjon til symbolet i den nåværende forslagslisten, vil forslagslisten bli tom, siden den kombinasjonen av grunnleggende symboler ikke finnes. Dette betyr at de symbolene med rød understrek i input-feltet blir brukt til å finne forslag. Rekkefølgen på symbolene i «Forslags Modus» har ingenting å si, det vil si at grunnleggende symboler 2, 3 og 4, vil vise samme liste av forslag som 4, 3 og 2. Dersom relasjoner ikke eksisterer vil det vises en tom liste, og dersom kombinasjoner av grunnleggende symboler ikke finnes, vil det også vises en tom liste. 31

32 Nå, hvis vi trykker på det sammensatte symbolet i forslagslisten, vil dette skje: Figur: bbweb.3.1 De symbolene som var i «Forslags Modus» ble erstattet med det sammensatte symbolet som vi trykket på! Slik kan vi fortsette å finne frem til sammensatte symboler og få dem inn i input-feltet. Trykker vi nå på «Space», vil vi få et mellomrom foran symbolet som nå ligger i inputfeltet. Vi trykker på «Space», og trykker deretter på et nytt grunnleggende symbol. Denne gangen trykker vi på det grunnleggende symbolet vi skapte sammen, altså symbolet «Wheel». 32

33 Figur: bbweb.3.2 Vi ser at «Space» skapte et lite mellomrom mellom det sammensatte symbolet og det grunnleggende symbolet «Wheel». Videre ser vi at «Wheel» er i «Forslags Modus», og at to forslag dukket opp i listen til høyre. I forslagslisten til høyre ser vi også det sammensatte symbolet som vi skapte tidligere i brukerveiledningen, altså «Cart, Carriage». Dette bekrefter nok en gang at relasjonene mellom symbolene finnes og at det fungerer akkurat som det skal. Siden «Wheel» er i «Forslags Modus», blir det brukt til å generere og filtrere forslagslisten til høyre. Men hva om vi har lyst til å beholde «Wheel»? Da trykker man bare på «Space», og symbolet vil da gå ut av «Forslags Modus», og ligge i input-feltet på samme posisjon som før. Slik vil det da se ut: 33

34 Figur: bbweb.3.3 Her ser vi at «Wheel» er ute av «Forslags Modus», og at forslagslisten til høyre har forsvunnet. De to neste bildene er kun her for å demonstrere kombinasjonen av grunnleggende symbol + «Space». Figur: bbweb

35 Figur: bbweb.3.5 «Backspace»-knappen brukes til å slette symboler fra input-feltet. «Backspace» sletter det siste symbolet fra input-feltet ved hvert trykk. Hvis man er i «Forslags Modus», vil «Backspace» fortsatt slette det siste symbolet, og forslagslisten vil da oppdatere seg til kun å inneholde forslag basert på kombinasjonen av symboler som er i «Forslags Modus» fortsatt. La oss vise dette med bilder. 35

36 Figur: bbweb.3.6 Trykker vi nå på «Backspace», vil kun forslag som inneholder symbolet «Wheel», dukke opp. Figur: Figur: bbweb.3.7 Hvis man tar musen over symbolene i forslagslisten, eller symbolene i input-feltet, vil et felt dukket opp med navnet til symbolet. Som vist tidligere, vil dette skje dersom musen befinner seg over et grunnleggende symbol i tastaturet også. Bildene under demonstrerer dette. 36

37 Figur: bbweb.3.8 Bytte av språk Denne seksjonen skal vise brukerne hvordan de kan bytte språket på nettsiden. Til høyre i navigasjonsbaren ligger det en knapp som heter «Language». Holder man musen over denne, vil det dukke opp en liten meny med de språkene man kan se nettsiden i. Figur: bbweb.3.9 Trykker vi nå på «Norsk», vil hele nettsiden vises på norsk. Her viser jeg bare navigasjonsbare på norsk. 37

38 Figur: bbweb.4.0 Installasjon og driftsveiledning (Publish) Publiser applikasjonen I Visual studio finnes det flere måter å publisere en applikasjon. Vi har valgt å bruke en metode som heter «Web deploy package». Denne typen publisering lager en Zip fil og nødvendige installasjonsscript. Zip filen er i vårt tilfelle ca. 6 MB stor, så den lastes raskt opp til en server som kjører IIS. Prosessen for å publisere består av 3 steg, hvor første steg er: Velg database tilkoblingen for din server. Vi har satt opp to måter å koble applikasjonen til en database. Mssqllocaldb og tilkobling til en MySql server. Mysqllocaldb har vi kun brukt som testing lokalt i Visual Studio. Den er satt opp til å bruke brukernavn og passord til brukeren som kjører Visual Studio, eller eventuelt brukeren som har startet IIS. Det er derfor ikke nødvendig å bytte passord i connection string om man bruker mssqllocaldb. Den andre løsningen vi har satt opp etter ønske fra oppdragsgiver er MySql. Dette var en enkel overgang. Siden vi har brukt entety framework og code first og har passet på ikke å bruke noen MSSQL spesifikke teknikker, var det kun connection string som måtte byttes og MySql.Data + MySql.Data.Entety.EF6 som måtte installeres for at databasen skulle fungere på MySql. Det skal derfor være enkelt og greit å sette opp databasen på for eksempel MariaDB ved å bytte connection string og installere nødvendige Entety framework.dll er for MariaDB. VI har valgt å bruke MySql siden det er en godt dokumentert og velkjent plattform for de fleste som har kjennskap til databaser. Hvis du skal bruke MySql trenger du kun å velge servernavn, brukernavn og passord i connection string. Brukeren som skal settes opp her må være en bruker med rettigheter til å lage nye databaser på MySql serveren. Oppsett av MySql på Windows 8 kommer senere i (Deploy) seksjonen. 38

39 Figur: bbvs.1.0 Dersom du skal installere MySql på samme server som IIS kan du bruke localhost. Er MySql installer på en annen server må du bytte ut localhost med serverens FQDN (Fully Qualified Domain Name). Serverens FQDN er alltid lik «hostname.domain.[top-level domain]»et eksempel kan være mysequel.blissbase.no for en maskin med navn «mysequel» i domenet «blissbase.no». Om du bruker MySql må du passe på at MSSQL innstillingene er kommentert ut i BlissBase/Web.config, og motsatt om du bruker MSSQL. Figur: bbvs.1.1, bbvs.1.2 Bygg applikasjonen med innstillinger for (release) Dette er ganske enkelt og greit. Øverst i vinduet av Visual Studio har du et valg om du bygger for (debug) eller (release) Figur: bbvs.1.3 Det er mulig og konfigurere release innstillingene til å bruke en annen Web.config så du slipper å bytte connection string hvis du bruker andre innstillinger når du utvikler. Dette har 39

40 ikke vi brukt, så jeg går ikke så nøye inn på det. Ved å velge release får man uansett andre innstillinger for hva av feilmeldinger og innholdet i de som blir vist frem til brukeren. Publiser pakken. Dette gjøres ved å høyre-klikke på BlissBase prosjektet og velge publish. Figur.bbvs.1.4 Her har vi lagd noen innstillinger for publisering som burte være greie å bruke. Det blir opprettet en konfigurasjonsfil med en IIS Site med navn BlissBase og default Directory /. Det blir også laget en.zip fil BlissBase.zip, og et viktig cmd script BlissBase.deploy.cmd. Videre er blir det generert en readme tekstfil og et par.xml filer som gir muligheten til å forandre noen av innstillingene uten å publisere på nytt. Etter dette programmet har kjørt så får du alle filene i mappen som er valgt for «publish to». Disse skal kopieres over på serveren som du skal installere BlissBase på. 40

41 Figur: bbwin.1.0 Da er stegene for å publisere applikasjonen gjennomgått og det nå på tide å installere MySql og IIS på en Windows maskin for å sette opp nettsiden. (Deploy) Installasjon av tjenester og BlissBase Hvor vidt man burte gå inn for å installere en Windows klient som en server er noe mange har forskjellige meninger om. Nå er det sånn at hvis man kun har tenkt til å bruke Windows som en webserver med IIS og ikke har tenkt til å bruke ADDC (Active Directory Domain Controller) eller andre Microsoft tjenester som kommer med en Windows server, så kan du komme langt med en klientversjon. Da står du fortsatt fritt til å bruke Linux til VPN, DNS, DHCP og andre tjenester du kan ha nytte av på et bedriftsnettverk, og kan slippe en del store lisensutgifter. God maskinvare er naturligvis like viktig uansett om man bruker klient eller serverversjon av Windows. IIS 8 versjonen som kommer med Windows 8 og 8.1 er den samme versjonen som kommer med Windows server versjonen med samme muligheter for SSL, Logging, m.m. Det er heller ikke noen større forskjell mellom klienter og servere når det kommer til Defender, Firewall, Service, Update eller andre Windows standard programmer. En server vil få en del oppdateringer en klient ikke får siden det er en del andre forhåndsinstallerte tjenester, men hvis de ikke skal brukes så kan man komme langt med en klientversjon. MySql server for Windows er også den samme installasjonen uansett om man er på Windows server eller Klient, det er derimot forskjellige versjoner for x86 og x86_64. Denne installasjonsveiledningen tar derfor for seg installasjon på en Windows 8 klient. Alle stegene utenom installasjon av IIS 8 vil uansett være de samme på en Windows server. 41

42 Installere IIS som Windows feature. Får å kunne fullføre de neste stegene må man være logget inn på Windows maskinen med en administrator bruker, eller ha tilgang på brukernavn og passord til en administrator bruker. For å gjøre dette navigerer man til «Control Panel -> Programs and Features». I margen på venstre side velger man Turn Windows features on or off. Man får da opp et vindu som viser alle tilgjengelige tjenester i en mappestruktur. Derifra velges og ekspanderes «Internet Information Service» og undermappene «Web Management Tools» og «World Wide Web Services». Her skal det hukes av for alle delene av IIS som skal installeres. Husk at noen av undermenyene blir ikke valgt om man kun velger en toppmeny som for eksempel «World Wide Web Services» uten og ekspandere den og velge undervalgene. Dette kan resultere i litt «tilfeldige» feilmeldinger når applikasjonen startes og en god del tid for å finne ut hvorfor. Fyll derfor ut alle valgene som vist på bildet. 42

43 Figur: bbwin.1.1 Lage en ny Site BlissBase. Nå er IIS installert og det er på tide å sette opp en ny Site i management applikasjonen til IIS (IIS Manager). Start applikasjonen og høyreklikk på server ikonet i menyen på venstre side. Velg «Add Website». Hvis du ikke har gjort noen endringer i publiseringsinnstillingene så skal du lage en ny Site med navn BlissBase. Figur: bbwin

44 Minimumsinnstillingene er vist på bildet over. På Windows skal websider ligge i C:\inetpub\wwwroot på grunn av rettigheter IIS trenger på mappen applikasjonen ligger i for å kunne vise den på web. Litt ut i fra hvordan du har satt opp domene på IP adressen din kan det være lurt å fylle inn «Host name» feltet med DNS til siden. Eksempler ser man på bildet. Dette er fordi du kan få problemer hvis du setter opp en side og den er tilgjengelig på med andre ord at siden er tilgjengelig på din IP. Da kan det bli vanskelig for søkemotorer som Google å lage søketreff med domenenavnet og du kan ende opp med xxx.xxx.xxx.xxx/write som søkbare Google treff. Legger du inn et vertsnavn, så setter IIS opp en Virtual Host og siden kan kun nåes via nettlesere når det har blitt søkt på hele vertsnavnet. Installere SSL sertifikat. Denne applikasjonen er utviklet for at ingen passord skal ligge som klar tekst i databasen. Vi vil allikevel anbefale å bruke SSL sertifikat på serveren for at passord ikke skal kunne leses med programmer som Wire Shark når brukere kobler seg til tjenesten. Vi kunne valgt å gjøre innloggingen litt sikrere fra applikasjonens side ved å sende «saltet» til en brukers passord ned til klientmaskinen som prøver å logge seg inn og hashe passordet på klienten ved hjelp av javascript. Med dette hadde vi oppnådd at passordet ikke var lesbart når det ble sendt over nettverket. Det hadde allikevel ikke økt sikkerheten i stor grad. Det hashede passordet hadde måtte bli sent over nettverket til en logg inn sjekk og det kunne hackere benyttet seg av. Bruker man derimot et SSL sertifikat på serveren vil all informasjon sendes kryptert mellom klient og server og innloggings siden vil ha tilstrekkelig sikring. Noen muligheter og prisklasse på SSL sertifikater er: Start SSL o Dette er en tjeneste fra Start COM Certification Authority som er helt gratis. Begrensningene innebærer at sertifikatet ikke vil inneholde noen form for informasjon om bedriften, epost, Disse sertifikatene er også av en enklere type som bruker SHA2 kryptering. Noen nettlesere vil derfor vise sertifikatet som «svakt» litt utfra hvilken nettleser som blir bruk kan URL en bli vist oransje som en indikasjon til brukeren om at siden ikke har betryggende sikkerhet. Vi anbefaler derfor kun dette til testing, eller i en startfase. No-Ip.com o Dette er en bedrift som tilbyr vertsnavn for både statisk og dynamisk IP. Bedriften tilbyr også SSL sertifikater. GEO Trust QuickSSL er et sertifikat 44

45 med god sikkerhet for en vert «ett subdomene» Dette er moderat priset til rundt 550,- NOK per år. Videre finnes det mange andre som tilbyr SSL sertifikater med varierende nivå, garanti og pris. Det vil ofte lønne seg å benytte seg av SSL sertifikat fra bedriften man har registrert domenet sitt hos, da det kan bli rabatter. For å anskaffe et sertifikat til, og installere det på IIS 8 gjør man følgende. Åpne «Internett Information Service Manager» og klikk på servernavnet i menyen til venstre. I ikonfeltet i midten av applikasjonen velger du «Server Sertificates». Åpne dette og velg «Create Certificate Request» I menyen som kommer opp fyller du ut alle feltene. Figur: bbiis.1.0 Common name feltet er FQDN til siden. Med andre ord URL uten [ Gå videre til neste side og velg «Bit length». Større lengde gir bedre sikkerhet, men kan ha negativ innvirkning på hastighet bit er en fornuftig lengde på sertifikat til denne siden. Lagre den resulterende filen med.csr endelse. Dette vil alle sertifikat utgivere kunne lese. Neste del av prosessen er å få sertifikatet signert. Dette kan variere fra aktør til aktør, så jeg går ikke inn på det. Det er i alle tilfeller filen du lagde over som skal signeres. Når du har fått sertifikatet signert må det installeres på serveren. Dette gjør du også i IIS Manager. Åpne «Server Sertificates» som før og velg «Complete Certificate Request» i menyen på høyre side. Der får du beskjed om å angi filen som er det signerte sertifikatet. Dette må være i DER format og ha filendelsen [.crt.cer eller.der]. Angi et vennlig navn på sertifikatet, dette er kun til at du skal kjenne det igjen så velg noe du husker. 45

46 Nå må du be siden «BlissBase» bruke sertifikatet. I IIS Manager høyreklikk på BlissBase i menyen til venstre og velg «edit bindings». Velg «add» og fyll ut. «Host name» fungerer her på samme måte som nevnt i punkt: a.ii) Lage en ny Site BlissBase. Figur: bbiis.1.1 Installere og konfigurere MySql. Pakken lastes ned fra Velg plattform: Microsoft Windows og Recomended Download: Windows(x86, 64-bit), MySql Installer MSI (Installasjon) Start installasjonen på serveren og gå gjennom veiledningen og godkjenn lisensavtalen. På neste vindu velger du «Custom» for å kunne velge hva du vil installere. På serveren trenger du: MySql Server og Connector/NET, hvis du installerer MySql på en utviklermaskin kan det være lurt og også installere MySql for Visual Studio, som gir deg mulighet til å sette opp Server Explorer og SQL Server Object Explorer til å koble seg til MySql. 46

47 Figur: bbwin.1.3 (Konfigurering) Hvis du har fulgt de tidligere stegene så kobler BlissBase seg til MySql som localhost. Man kan derfor huke bort «Open firewall port for network access». Har du derimot installert MySql på en annen maskin en BlissBase og har tatt høyde for det når applikasjonen ble publisert, må brannmuren åpnes. Når du får valg om å lage en ny bruker kan du lage en bruker «bliss» og gi den rolle som «DB Manager» på localhost. Da vil brukeren kunne opprette nye databaser som er nødvendig for at BlissBase sin Create if not exist metode skal kunne generere databasen. Installere BlissBase Last opp alle filene fra publiseringen i Visual Studio til serveren. Deretter startes cmd som administrator. Bruk cd til å gå til mappen der filene ligger. Kommandoen for å installere pakken er: «BlissBase.deploy.cmd /Y» Utfører du denne kommandoen nå vil du få en feilmelding om at «Web Deploy» ikke er installert. Dette gjøres ved å velge en av installasjonsmetodene til Microsoft. Jeg brukte «Web Platform Installer». Den installerte deler av avhengighetene selv, men noen ekstra pakker må installeres. Skriv «Web Deploy» i søkefeltet og installer pakken vist på bildet. 47

48 Figur: bbwin.1.4 Nå er alle avhengigheter for BlissBase installert, MySql og IIS installert og konfigurert, så da er det bare å installere BlissBase. Gjør som nevnt øverst i avsnittet. CMD som administrator, cd til BlissBase.zip og de tilhørende filene og kjør kommandoen «BlissBase.deploy.cmd /Y» For tydelighet: «BlissBase.deploy.cmd[SPACE][FORWARD SLASH][CAPITAL Y]». Nå er BlissBase installert. Det eneste som gjenstår av installasjonen er å opprette en mappe for import av bildefiler «/Import». Opprette Import mappe Åpne en fil browser og gå til C:\inetpub\wwwroot\BlissBase og opprett en mappe Import der. Det må oppdateres noen rettigheter på mappen. Siden det skal kunne lastes opp filer fra en klientmaskin som besøker nettsiden, så må IIS sin bruker ha skrivetilgang. Høyreklikk på mappen velg Properties og gå til Security taben. Der velger du Edit og finner deretter brukeren som heter IIS_IUSRS. På Allow feltet krysser du av for Write. Velg deretter apply og lukk vinduet. Har alt gått riktig og alle stegene utført skal du nå kunne gå til BlissBase via nettleseren din. I IIS manager er det et browse valg i menyen til høyre som du raskt kan sjekke at siden er oppe. 48

49 (Manage) Drift av applikasjonen Oppdater BlissBase applikasjonen Er det på tide å oppdatere applikasjonen følger du stegene for å publisere fra Visual Studio og laster opp de nye filene til serveren. Deretter følger du veiledningen i 2c for å installere (oppdatere) ny versjon. Nå skal alle avhengigheter være installert, så dette går raskt. Hvis du vil beholde filene i Import mappen tar du en sikkerhetskopi av mappen før du kjører installasjonsscriptet, siden den blir overskrevet. Så er det bare å gjenopprette Import mappen som forklart i forrige steg. Husk at dersom det har blitt gjort endringer på tabelldefinisjoner, må databasen bygges på nytt. Det er viktig å ta en sikkerhetskopi av all data før dette gjøres. Har det blitt gjort endringer på felter, f.eks. en INT som har blitt byttet til en VARCHAR, må.sql filen endres før import. Eventuelt kan man lage ett migrasjonsscript for å endre tabelldefinisjoner uten å miste data. Husk at hvis du hat oppdatert tabelldefinisjonene så må det lages et migrasjonscript for å kunne beholde all data i den nye tabellstrukturen. Eksport av databasen (MySql) Med jevne mellomrom lønner det seg å ta en sikkerhetskopi av databasen. Dette gjøres enkelt i MySql med mysqldump.exe i cmd. Figur: bbwin.1.5 Kjør programmet med parameterne: «-u BRUKERNAVN p h TJENERNAVN blissbasemaster > NAVN_PÅ_FIL.sql» Du vil da bli bedt om passord for MySql. Du kan bruke passordet til bruker BRUKERNAVN eller angi MySql root passordet. 49