Enkelt brev - lex.solarplexusit.se file · Web viewEnkelt brev - lex.solarplexusit.se

Lex2 InstallationsinstruktionerRevisonshistorikVersion Datum Förändring

1.11 2014-06-26 Lagt till info om installation och konfiguration av Lex2.help (Hjälp-funktion)

1.12 2014 Uppdaterat info om uppgradering av Lex2Office.Konfigureringen av Hjälpservern är flyttad mellan version 6.4.0/6.4.1 och 6.7.0. Detta gör att LexConfigServer behöver uppdateras, men det ska göras först när sista miljön (produktionsmiljön) uppdateras till 6.7.0 – se Uppgraderingsinstruktion 1.210Ändring från version 6.4.0/6.4.1:* Inställning av hjälpserver är borttagen från LexConfigServer och Lex2Desktop.Config, valet Use ApplicationServer* Inställning av hjälpserver är tillagd under Lex2ServerConfiguration och Lex2WebServerConfiguration

1.13 2014-12-22 Lagt till lite information ang fastighetsadaptern och att användaren Lexsystem måste ha tillgång till FDS-databasen.Från och med version 6.10 försvinner möjligheten att installera på Windows XP (klient) och Windows Server 2003 (server).

1.14 2015-02-26 Förtydligat information om hur Adapterservern och dess adaptrar ska hanteras vid uppgradering och även hur ni som kunder får tillgång vill uppdaterade versioner av adaptrar.

1.15 2015-03-30 Från version 6.13 krävs .Net 4.5 både på server och klient.Ny skärmdump på Lex2 Server Configuration, Lex2 Web Server Configuration och i Lex2.Desktop.Config. Nu måste ett databaskonto som Lex2 använder anges (tidigare kontot ”lex”).OBS! De gamla konton som Lex1 använder (lex och lexsystem) måste finnas kvar så länge Lex1 finns i drift, t.ex. för administratörerna.

1.16 2015-04-10 Uppdaterat kapitlet Installationskrav med information om att MS Office på klienterna måste vara 32-bitars.

1.17 2015-05-18 Uppdaterat instruktioner för Lex Config Service gällande lösenord

1.18 2015-09-14 Det låg kvar en text om att MS Office på klienterna skulle vara 32-bitars. Texten togs bort då vi nu stödjer även 64-bitars MS Office

1.19 2015-11-04 Lagt till ett stycke om hantering av speciella användare påverkas av flytt av databas.Installationen av Lex2Office har förtydligats med avseende på vilket installationspaket som ska användas för 32/64-bitars MS Office.

1.20 2015-11-23 Lagt till ett avsnitt angående installation av Lex2 Meeting

/33

Solarplexus IT-strategi ABAdress: Industrivägen 5, 171 48 Solna • Flöjelbergsgatan 8A, 431 37 Mölndal • Strandgatan 2, 852 31 SundsvallHuvudkontor i Solna • Org. nr 556667-8339 • VAT nr SE556667833901 • Tel: 08-22 92 51 • www.solarplexusit.se

Server.

/33


InnehållsförteckningLex2 Installationsinstruktioner 1

Inledning 6

Klientapplikationen 6

Applikationsservern 6

Konfiguration av klienter 6

Lex2 databas 6

Rekommendation 7

Versionsnumrering 7

Installationskrav 8

.NET Framework 4.5 8

Installationer i IIS 8

Operativsystem 8

Korinto Hosting Server 9

Beskrivning av komponent 9

Installation 9

Khsutil.exe 9

Windows-brandvägg 9

Lex Config Service 10


Teknisk beskrivning 10

Installation 10

Konfigurering 11

Lösenord 11

Nollställa lösenord 12

Konfigurering av klient-konfigureringar 13

Ett exempel, köra klienten mot en applikationsserver 13

Lex2 Adapter Server 15


Installation 15

Ang uppdatering av adapterservern 17

Lex2 Server 18

/33


Beskrivning av komponenten 18

Installation 18

Single-SignOn och Delegation 19

Lex2 Webserver 21


Installation 21

Network Configuration 22

Konfigurera AD för Lex2 (Single-SignOn) 24

Inledning 24

Grupper i AD 24

Skapa upp inloggning i SQL Server 24

Skapa användarkonton 25

Lex2 Desktop 26


Installation 26

Lex2.Web 28


Installation 28

Viktigt! Säkerhetsinställningar i Internet Explorer 28

Lex2.Help 29


Installation 29

Konfiguration 29

Lex2.ClickOnce 29


Installation 29

Lex2.Office 30


Installation 30

Koppling till Lex2 30

Viktigt! Uppdatera MS Office 30

Lex2 Meeting Server 31

/33



Installation 31

Uppdatering av databas 31


Installation 32

Flytt av databas 32

Lex.sql 32

LexSystem.sql 33

LexLoginAdmin.sql 33

Lexloguser.sql 33

/33


InledningLex2 är en 3-skiktslösning som går att konfigurerera och köra på ett antal olika sätt. Vilket sätt man väljer beror till stor del på de krav som ställs av kunden och på hur kundens miljö ser ut.

KlientapplikationenKlientapplikationen är i grund och botten samma applikation, men den kan köras på tre olika sätt:

På skrivbordet, Lex2.Desktop, installerad som ett vanligt program via msi-paket. För att uppdatera denna version måste man installera ett nytt msi-paket.

På skrivbordet, Lex2.ClickOnce, installerad via ClickOnce-teknologi där användaren startar programmet via en speciell länk till en fil som ligger på en nätverksenhet (detta är i praktiken samma skrivbordsprogram som Lex2.Desktop). För att uppdatera denna version räcker det med att en administratör uppdaterar filerna på nätverksenheten, och då uppdateras filerna hos klienterna automatiskt.

I Internet Explorer, Lex2.Web, där användaren kör Lex2 inbäddat i en plugin i web-läsaren. Denna version kan inte öppna separata fönster. Uppdatering av ”klienten” sker genom att uppdatera filerna på webservern.

ApplikationsservernLiksom klienten är även applikationsservern en och samma applikation, men denna kan också köras på 3 olika sätt:

Som en egen applikationsserver

Som en webb-tjänst under IIS (detta är när man kör klienten i Internet Explorer)

Inbäddat i klienten, s.k. fet klient.

Konfiguration av klienterKlienterna kan konfigureras på två sätt, antingen genom att man fyller i konfiguration under den interaktiva installationen (vilket är gemensamt för alla användare på en dator, en fördel om man kör på Terminal Server) eller att man kör med en lösning där man har en konfigurationsserver.

Följande möjligheter finns:

Lex2.Desktop kan konfigureras både lokalt och via konfigurationsserver. För att kunna ha en lokal konfiguration måste man köra installationen lokalt interaktivt. Om man installerar genom att ”skjuta ut” installationen via andra verktyg (motsvarande msiexec /quiet) så kommer installationen automatiskt att använda sig av konfigurationsservern.

Lex2.ClickOnce kan endast använda sig av konfigurationsserver. Eftersom ClickOnce är konfigurationslöst så är detta förinställda val den enda möjligheten.

Lex2.Web kommunicerar alltid tillbaka till webservern varifrån applikationen hämtats. Konfiguration som behövs hämtas från webservern.

Lex2 databasLex2 använder samma databas som den befintliga Lex-lösningen. Det som bägge systemen har gemensamt är data i tabellstrukturen. Det ingår som en del av Lex2-projektet att även uppdatera

/33


och modifiera koden i databasen, varför det finns en dubbel uppsättning stored procedures, funktioner, vyer och triggrar i AES-databasen, en för befintlig Lex och en för Lex2.

I grunden krävs version 10.2 av Lex, därefter så måste man även köra en skriptkö för Lex2 samt även en skriptkö för logg-funktionalitet.

RekommendationVi rekommenderar följande två sätt att köra på:

1. Installera applikationsserver och konfigurationsserver och kör klienten via ClickOnce

2. Installera servern under IIS och kör klienten inbäddat i Internet Explorer.

VersionsnumreringEn version av Lex2 identifieras av fyra olika siffror:Major.Minor.Revision (Build) – exempel på detta kan vara 4.2.1 (Build 257).

Major och Minor (ex. 4.2) identifierar en ny version av Lex2. En uppdatering av Revision (exempelvis till 4.2.1) innebär ingen ny version utan bara en revision. En sådan innehåller bara mindre buggfixar i enskilda lager och ingen förändring i gränssnitten mellan lagren.

Vid uppstart av en Lex2-klient så kontrolleras att det är samma Major och Minor i klient som i övriga lager.

Detta innebär att exempelvis Config Service bara tittar på Major och Minor. (se förtydligande i kapitlet om Config Service)

/33


Installationskrav.NET Framework 4.5Samtliga komponenter i Lex2 är utvecklade under .NET Framework 4.5 och därför måste detta vara installerat på alla servrar och klienter som skall köra Lex2. Vi rekommenderar att samtliga uppdateringar från Windows Update installeras, eftersom vi själva kontinuerligt alltid göra detta under utvecklingen.

Installationer i IISFörutom kravet på .NET Framework 4.5, så måste även ASP.NET vara påslaget i IIS.

IIS 7.0 och framåt (i skrivande stund) är mer detaljerat gällande vilka komponenter av IIS som är installerade. Följande delkomponenter (Role Services) måste vara installerade:

Static Content Default Document ASP.NET IIS 6 Metabase Compatibility Windows Authentication, om man använder Single-SignOn

OperativsystemFrån och med version 6.10 försvinner möjligheten att installera på Windows XP (klient) och Windows Server 2003 (server).

/33


Korinto Hosting ServerBeskrivning av komponentKorinto Hosting Server är en programvara som används för att vara värd åt en eller flera applikationsservrar från Lex2-projektet. Syftet med denna är att inte vara beroende av att installera eller fylla upp med ett antal olika windowstjänster, utan kan ha en enda som aggregerar detta.

Korinto Hosting Server i sig är en ”tunn” applikation. Man kan enklast jämföra den med hur IIS, Tomcat med flera fungerar. En skillnad är dock att Korinto Hosting Server tillåter sina tjänster att köra ”för evigt” utan att stänga av dessa efter en viss period av inaktivitet. Tjänsterna är dessutom helt fria att kommunicera med omvärlden hur de vill.

Korinto Hosting Server körs som en vanlig windows-tjänst.

InstallationKör filen KorintoHostingServerSetup.msi, installationen kräver ingen konfiguration.

Viktigt! Om programvaran redan är installerad så måste den manuellt avinstalleras först!

Korinto Hosting Server sparar en konfigurationsfil som heter%PROGRAMDATA%\SolarPlexus IT Strategi\Korinto Hosting Server\Application.config

Khsutil.exeI applikationskatalogen finns ett program som heter khsutil.exe, detta kan användas för enklare administrering av Korinto Hosting Server. För instruktioner av programmet hänvisas till hjälptexten när man kör det utan några argument. Programmet är ett konsol-program.

Windows-brandväggOm man har windows-brandväggen påslagen så måste man lägga till KorintoHostingServer.exe som ett undantag i den för att ingående tjänster ska kunna svara på anrop från nätverket.

/33


Lex Config ServiceBeskrivning av komponentLex Config Service är en webtjänst som kan tillhandahålla konfigurationsinställning till Lex2.Desktop och Lex2.ClickOnce. Om dessa klienter är inställda att använda Lex Config Service så kommer dessa att hämta inställningar från denna. Lex2.ClickOnce är inställd att alltid hämta från Lex Config Service, i Lex2.Desktop är det konfigurerbart.

Teknisk beskrivningFöljande sker när klienten försöker hitta Lex Config Service:

1. Klienten kör ett uppslag på värdnamnet ’lexconfigservice’.

2. Klienten anropar sedan webapplikationen ’lexconfigservice’ och skickar in sitt versionsnummer som parameter – Major.Minor (exempelvis 4.2)

3. Lex Config Service returnerar de inställningar som gäller för aktuell version.

Som krav för att det skall fungera så måste kundens DNS-server konfigureras så att det finns en värd som heter ’lexconfigservice’, som är ett alias (CNAME) som i sin tur pekar på den webserver där Lex Config Service är installerad.

Det är viktigt att samtliga klienter kan namnupplösa just ’lexconfigservice’ utan fullt kvalificerat värdnamn till rätt web-server, detta kan kontrolleras genom att på klienterna skriva ’ping lexconfigservice’ och man ska då få svar (eller åtminstone rätt ip-adress) från aktuell webserver.

InstallationKör installationsfilen LexConfigServiceSetup.msi på webservern.

Viktigt! Val av applikationspool:

/33


Under inställningarna för LexConfigService IIS/Authentication se till att endast Anonymous Authentication är enablad. Övriga ska vara disablade.

På Windows 2008 Server och senare så väljer man ’ASP.NET v4.0’

KonfigureringÖppna en webläsare och skriv in ’ http://lexconfigservice/lexconfigservice/admin’, om namnupplösning och installation fungerar som det ska så ska det komma upp en websida.

LösenordFörsta gången applikationen startas så måste man sätta ett admin-lösenord;

När lösenordet väl satt så kommer övriga starter av admin-delen att kräva inloggning;

/33


http://lexconfigservice/lexconfigservice/admin

Nollställa lösenordOm man glömmer av lösenordet till Lex Config Server så kan en administartör manuellt radera lösenordet i konfigurationsfilen på server. Filen heter %ProgramData%\SolarPlexus IT Strategi\Lex Config Service\Lex2.config och I den så kan man radera informationen av lösenordet genom att radera posten EncPassword. Nästa gång så kommer applikationen att kräva att man sätter ett nytt lösenord.

/33


Konfigurering av klient-konfigureringarVälj länken Lex2;

Då visas följande sida:

Och här sätter man upp konfigurationen som den skall uppfattas hos klienten.

Ett exempel, köra klienten mot en applikationsserverI rutan Version skriv in versionen av Lex, i skrivande stund 1.1, tryck Add new. Välj sedan 1.1 under Saved configurations och i högerdelen fylls det nu i en grundkonfiguration.

/33


Förtydligande: Version ska anges med 2 siffror (Major.Minor), se mer i kapitlet om Versionsnumrering i inledningen.

Skriv in namnet på applikationsservern som den uppfattas från klienterna i Application Server Name.

Om inte applikationsserver används, så måste adressen till adapterservern anges tillsammans med databasinställningarna. Adapter Server Name är namnet på servern där adapterservern körs.

Beroende på hur kommunikationen sätts upp så välj rätt kombination under Network Configuration. Se vidare instruktionerna för Lex2 Server.

Till sist tryck på Update Record för att uppdatera posten och sedan på Save application configuration för att spara det permanent på disk.

Konfigurationsfilen sparas som %PROGRAMDATA%\SolarPlexus IT Strategi\Lex Config Service\Lex2.config

/33


Lex2 Adapter ServerBeskrivning av komponentLex2 Adapter Server är en ny komponent från och med version 2 av Lex2. Syftet med denna komponent är att hantera kopplingar för att hämta in data från andra system, i nuläget fastighetssystem.

Lex2 Adapter Server konfigureras upp att använda en eller flera adaptrar som i sin tur konfigureras med det som de behöver veta för att fungera. I version 2 finns endast en adapter tillgänglig som heter FdsPropertyAdapter som följer med som standardadapter. FdsPropertyAdapter använder sig av den befintliga FDS-databasen för att söka efter fastigheter, så de modifikationer som finns i denna idag fungerar fortfarande. I framtiden så kommer det att skrivas adaptrar som kan läsa direkt mot externa fastighetssystem som t.ex. Tefat, Geosecma etc.

Lex2 Adapter Server körs inte som en egen process utan körs under värdprogramvaran Korinto Hosting Server. Se vidare dokumentationen för denna.

InstallationLex2 Adapter Server måste installeras och konfigureras centralt på en server.

Installera först Korinto Hosting Server.

Kör sedan installationen Lex2AdapterServerSetup.msi. Viktigt, om Lex2 Adapter Server redan är installerad så måste den avinstalleras först. (se stycke nedan)

När installationen är klar visas följande dialogruta:

/33


Tryck på knappen ’Add…’ för att visa följande öppna-dialog:

Välj filen ’FdsPropertyAdapter.dll’ och tryck på Open (eller dubbelklicka).

Nu innehåller konfigurationsrutan följande information:

/33


Välj FdsPropertyAdapter.dll och tryck Configure:

Här måste konfigurationen för att komma åt databasen FDS skrivas i. Database name och User name är förinställt. Lösenordet för denna användare är normalt sett blankt, så det som behövs skrivas i här är server\instans till databasservern.

OBS: Kontrollera att användaren Lexsystem har tillgång till databasen FDS via rollen FDSguests.

Ang uppdatering av adapterservernNär Adapterservern behöver uppdateras måste de adaptrar som används på nytt kopieras in på rätt plats. De läggs i samma mapp som Adapterservern ligger på.

Nya versioner av adaptrar skickas inte med i installationspaketet utan ni som kund begär manuellt att få skickat till er de adaptrar som ni använder (vissa ingår i basutbudet och vissa köps till separat).

TIPS: Innan Adapterservern avinstalleras (då försvinner alla inställningar) så bör ni göra noteringar om vilka inställningar som gäller för er.

/33


Lex2 ServerBeskrivning av komponentenLex2 Server är en applikationsserver för Lex2 klienter (Lex2.Desktop och Lex2.ClickOnce). Lex2 Server körs inte som en egen process utan körs under värdprogramvaran Korinto Hosting Server. Se vidare dokumentationen för denna.

InstallationInstallera först Korinto Hosting Server.

Kör sedan installationen Lex2ServerSetup.msi. Viktigt, om Lex2 Server redan är installerat så måste det avinstalleras först.

När installationen är klar visas följande dialogruta:

Här behöver följande information anges:

1. Database Server Name anger databasserverns namn. Glöm inte att ange eventuellt instansnamn också.

2. Database Name anger databasnamnet.3. Database account name anger det databaskonto (motsvarar kontot ”lex” som används av

gamla klienten). Kontot ska ha serverrollen Public, och vara mappad som AESapplication och Public på Lex-databasen

4. Database account password anger kontots lösenord5. Integrated Security skall kryssas i om Single-SignOn används (windowsinloggning)6. Namnet på servern där adapterservern körs.7. Namnet på hjälpservern – den webbserver där hjälpen ligger

/33


Under Network Configuration kan man välja om hur klienten och applikationsservern kommunicerar med varandra.

Windows Authentication måste väljas om man kör med Single-SignOn.

SSL kan också väljas om man vill ha säker (krypterad) kommunikation. Om SSL väljs så måste man ha ett giltigt certifikat installerat på applikationsservern, som klienterna kan validera till fullo. Så kallade Self-Signed certifikat fungerar inte. Enklast är att antingen ha ett köpt certifikat eller ett domäncertifikat från Windows Certificate Server.

Single-SignOn och DelegationOm man kör med Single-SignOn (inloggning med windows-användare) och applikationsserver samt databasserver är installerat på separata servrar, så måste man göra en inställning i Active Directory för att detta skall fungera.

På en domänserver så kör man programmet Active Directory Users and Computers, och leta upp domänkontot för applikationsservern. Detta finns normalt under OU:t Computers i domänen. Öppna upp egenskaperna för datorn och välj fliken Delegation. Kryssa i Trust this server for delegation to any service enligt nedan:

Anledningen till att man måste göra detta är att datorer i en windows-domän inte per automatik har rättighet att skicka en användares user-token vidare för impersonation från en dator till en annan. Detta behövs för att Integrated Security skall fungera när applikationsservern anropar SQL Server.

/33


Viktigt! När man kör med Single-SignOn är det viktigt att använda s.k. FQDN-namn när man anropar applikationsserver och/eller webbserver. FQDN står för Fully Qualified Domain Name vilket innebär att man använder datornamn där även domännamn ingår, t.ex. servernamn.domain.se istället för bara servernamn.

/33


Lex2 WebserverBeskrivning av komponentLex2 Webserver har i grunden samma funktionalitet som Lex2 Server, men med skillnaden att den körs under IIS. Lex2 Webserver har också uppgiften att distribuera webbklienten (Lex2.Web) till klienterna.

InstallationKör installationsfilen Lex2WebServerSetup.msi på webservern.

Viktigt! Val av applikationspool:

På Windows 2008 Server och senare så väljer man ’ASP.NET v4.0’

När installationen är färdig kommer det upp en dialogruta där man konfigurerar web-applikationen:

/33


Här behöver följande information anges:

1. Database Server Name anger databasserverns namn. Glöm inte att ange eventuellt instansnamn också.

2. Database Name anger databasnamnet.3. Database account name anger det databaskonto (motsvarar kontot ”lex” som används av

gamla klienten). Kontot ska ha serverrollen Public, och vara mappad som AESapplication och Public på Lex-databasen

4. Database account password anger kontots lösenord5. Integrated Security skall kryssas i om Single-SignOn används (windowsinloggning)6. Namnet på servern där adapterservern körs.7. Namnet på hjälpservern – den webbserver där hjälpen ligger

Network ConfigurationUnder Network Configuration kan man välja om hur klienten och applikationsservern kommunicerar med varandra.

Windows Authentication måste väljas om man kör med Single-SignOn.

SSL kan också väljas om man vill ha säker (krypterad) kommunikation. Om SSL väljs så måste man ha ett giltigt certifikat installerat på applikationsservern, som klienterna kan validera till fullo. Så kallade Self-Signed certifikat fungerar inte. Enklast är att antingen ha ett köpt certifikat eller ett domäncertifikat från Windows Certificate Server.

Viktigt! Ovanstående konfiguration ställer endast in hur klienten och webservern kommunicerar med varandra, det är även viktigt att man efteråt ställer in Lex2Web-applikationen i IIS så att IIS’s inställningar matchar konfigurationen enligt följande tabell:

Konfiguration IIS Authentication Binding (protokoll)

/33


No Windows Authentication + No SSL

Anonymous Authentication HTTP

No Windows Authentication + SSL

Anonymous Authentication HTTPS

Windows Authentication + No SSL

Anonymous Authentication

Windows Authentication

HTTP

Windows Authentication + SSL Anonymous Authentication

Windows Authentication

HTTPS

Anonymous Authentication måste alltid vara påslaget, även när man använder Single-SignOn, anledningen till det är att klienten börjar med att göra ett anrop till webservern för att ta reda på om Windows Authentication skall användas i applikationen eller inte.

/33


Konfigurera AD för Lex2 (Single-SignOn)InledningEn finess med Lex2 och windowsinloggning är att man kan använda grupper i Active Directory för att styra behörighet och nivå av behörighet för Lex2. Detta kan genomföras genom en korrekt konfigurering i AD samt i SQL Server.

SQL Server har ett begrepp som heter databasroller, vilket är de begrepp som styr behörigheten till Lex2. Genom att koppla grupper i AD till dessa roller så får man en smidig hantering av att tilldela domän-användare access till Lex2 utan att behöva lägga till enskilda användare i SQL Server.

Grupper i AD

Lägg till 2 grupper, i det här exemplet LexAesAdmins och LexAesUsers. Lägg sedan till alla användare som skall ha access till Lex2 i LexAesUsers. Användare som även är administratörer i Lex2 skall också läggas till i LexAesAdmins.

Skapa upp inloggning i SQL ServerDessa 2 AD-grupper kan nu läggas in som inloggningar i SQL Server;

CREATE LOGIN [LEX\LexAesAdmins] FROM WINDOWSGOCREATE LOGIN [LEX\LexAesUsers] FROM WINDOWSGO

I nästa steg så måste även användarna ges access till Lex2’s databas (AES);

USE [AES]GOCREATE USER [LEX\LexAesAdmins] FOR LOGIN [LEX\LexAesAdmins]GOCREATE USER [LEX\LexAesUsers] FOR LOGIN [LEX\LexAesUsers]GO

/33


I sista steget så skall användarna ges behörigheter i Lex2;

EXEC sp_addrolemember @rolename = 'AESadmins', @membername = 'LEX\LexAesAdmins'GOEXEC sp_addrolemember @rolename = 'AESusers', @membername = 'LEX\LexAesUsers'GO

Skapa användarkontonOm systemet är inställt för SSO så kommer administratören hitta ett nytt menyval i menyn Systemadministration, ”Skapa användare”.

I denna modul anger administratören namnet på AD-gruppen för Lex-användare, t.ex. LexAesUsers. I modulen visas sedan vilka användare i AD-gruppen som ännu inte har användarkonton i Lex och dessa kan sedan enkelt skapas.

Användarkonton som skapas denna vägen måste manuellt kopplas till rätt befattning i organisationen.

Observera att dessa användarkonton skapas utan en SQL-user, dvs dessa konton kan inte användas för inloggning i gamla klienterna.

/33


Lex2 DesktopBeskrivning av komponentLex2.Desktop är den lokalt installerbara varianten av Lex2-klienten.

InstallationKör installationsfilen Lex2DesktopSetup.msi på klientmaskinen. Efter installationen visas följande konfigurationsdialog:

Konfigurationen kan ställas in på ett av följande sätt:

1. Use Configuration Service, detta val gör att konfigurationsservern används och måste vara tillgänglig. Här kan man även ange url och tag. De värden som visas är de förinställda. Tag anges om man har en speciell installation, t.ex. testmiljö, som man vill ska få andra inställningar än de ordinarie. Motsvarande fält finns för konfiguration i Lex Config Service.

2. Use In-Process Server, detta val använder ingen extern applikationsserver utan kör klienten som en s.k. fet klient vilket gör att klienten kommunicerar direkt med databasservern och inställningar för var den finns måste anges. Även namnet på server där adapterservern körs, samt Hjälpserver måste anges.OM In-Process Server väljs så måste databasanvändaren anges (se Lex2Server och Lex2WebbServer ovan)

3. Use Application Server, detta val anger att klienten skall använda en applikationsserver (Lex2 Server) och inställningar för var den finns och hur den kommunicerar med denna måste göras.

Viktigt! Om man använder programvaror för att automatiskt installera programvaran på klientmaskinerna så kommer ingen dialogruta att visas (motsvarande msiexec /quiet). I detta fall kommer klienten automatiskt att konfigureras för att använda en konfigurationsserver.

/33


Konfiguration sparas i en konfigurationsfil (Lex2.Desktop.exe.config) som ligger i program-katalogen, vilket innebär att den gäller för alla användare på en dator. Detta är särskilt praktiskt om programvaran installeras på en Terminal Server, Citrix Server eller dylikt.

/33


Lex2.WebBeskrivning av komponentDetta är den variant av Lex2-klienten som körs i Internet Explorer, och som distribueras till klienten via web-servern.

InstallationLex2.Web har inget eget installationspaket, utan är en självuppackande exe-fil där filerna skall packas upp i katalogen xbap under Lex2WebServer-installationen, normalt katalogen C:\inetpub\wwwroot\Lex2Web\xbap. Anledningen till att Lex2.Web inte ingår i installationen för Lex2WebServer är att dessa nödvändigtvis inte behöver vara av exakt samma version, Lex2WebServer kan vara av versionen 1.1.0 och Lex2.Web av versionen 1.1.1.

Viktigt! Säkerhetsinställningar i Internet ExplorerEftersom Lex2.Web körs i Internet Explorer så kan i många fall adressen till web-servern behöva läggas till i säkerhetsinställningarna i Internet Explorer.

Adressen som man lägger till här http://<servernnamn> eller https://<servernamn>. Servernamnet måste se exakt likadant ut som användarna skriver i Internet Explorer.

/33


Lex2.HelpBeskrivning av komponentHjälpfunktionen i Lex2 är är webbbaserad. Hjälpfunktionen är inte versionsstyrd vilket gör att det möjligt att uppgradera bara hjälpen om den skulle släppas i ett separat paket.

InstallationLex2.Help har inget eget installationspaket, utan är en självuppackande exe-fil där filerna skall packas upp i katalogen help under Lex2WebServer-installationen, normalt katalogen C:\inetpub\wwwroot\Lex2Web\help.

KonfigurationHjälpservern ska pekas ut i administrationsgränssnittet för Lex2Server, Lex2Webserver och i Lex2.Desktop (valet InProcessServer). Se dessa avsnitt för detaljer.

Lex2.ClickOnceBeskrivning av komponentLex2.ClickOnce är i praktiken samma program som Lex2.Desktop, men med skillnaden att den distribueras via antingen en web-sida eller en nätverksdisk. Om applikationen uppdateras på distributionsplatsen så uppdateras den även hos klienterna automatiskt nästa gång de startar applikationen. ClickOnce-applikationer behöver inte lokala adminsitrationsrättigheter för installeras, utan installeras per användare och i en lokalt isolerad miljö. För vidare information om ClickOnce; http://en.wikipedia.org/wiki/ClickOnce och http://msdn.microsoft.com/en-us/library/t71a733d.aspx.

Lex2.ClickOnce kräver att det finns en konfigurationsserver tillgänglig, som kan bistå med konfiguration.

InstallationLex2.ClickOnce kommer som en självuppackande exe-fil som behöver packas upp på lämplig plats. Det finns följande två sätt som detta kan göras på:

1. Nätverksdisk som användarna har tillgång till. En länk till startfilen Lex2.ClickOnce.application behöver distribueras ut till användarna.

2. På en webserver, t.ex. i katalogen cc under Lex2Web om man har installerat denna. Även i detta fall måste man distribuera ut en länk till användarna, t.ex. http://<webserver>/Lex2Web/cc/ Lex2.ClickOnce.application.

/33


http://msdn.microsoft.com/en-us/library/t71a733d.aspx

http://en.wikipedia.org/wiki/ClickOnce

Lex2.OfficeBeskrivning av komponentLex2.Office är den nya kopplingen till MS Office07/10/13.Funktionellt så läggs en ny ribbon till i Microsoft Word/Excel/Powerpoint. Här finns knappar för olika operationer samt statusfält. För de handlingar som lagras i Lex databas och öppnas i Office så är den vanliga ”Spara”-knappen disablad.

Från och med version 4.3.0 finns inte längre stöd för den gamla Officekopplingen (från gamla Lex-webb) i Lex2.

InstallationLex2.Office kommer som ett msi-paket och detta installeras på klientmaskinerna av en användare som har Administratorsbehörighet.

Det finns 2 varianter av installationspaketet:Lex2OfficeSetup.msi - detta används om ni har 32-bitars MS Office installeratLex2OfficeSetup(x64).msi - detta används om ni har 64-bitars MS Office installerat

Koppling till Lex2 Innan Lex2.Office används första gången måste Lex2-klienten ha startats minst en gång. Detta för att klienten skriver vissa registervärden som Lex2.Office använder sig av.

Lex2.Office använder sig av vissa registervärden som Lex2-klienten skriver ner i Registryt och efter en installation/uppdatering så behöver dessa värden uppdateras. Om en användare försöker spara en handling som inte ligger i Lex om en ny handling till Lex (utan att klienten startats efter installation/uppgradering) så kan det i sällsynta fall krävas en start av klienten först. Nedan beskrivs hur detta undviks.

Om användaren inte har startat Lex2 någon gång så förutsätter Word att användaren vill spara i den miljö som pekas ut av LexConfigService (normalt produktionsmiljön). Om LexConfigService inte finns så visas varningstext i Lex-knappraden (Spara till Lex är då utgråad). Detta innebär att varningen inte kommer att visas för användaren förrän användaren försöker spara till Lex, och bara om inte LexConfigService är definierad.

Viktigt! Uppdatera MS OfficeI Lex2.Office används vissa funktioner som Microsoft har rättat nyligen. Därför är det viktigt att era Officeinstallationer är uppdaterade till senaste servicepack/rättning.

Dessa hotfixar krävs:

Word 2007 fix :- http://support.microsoft.com/kb/2687259

Word 2010 fix : http://support.microsoft.com/kb/2687296

/33


http://support.microsoft.com/kb/2687296

http://support.microsoft.com/kb/2687259

Lex2 Meeting ServerBeskrivning av komponentLex2 Meeting Server är en web-service för att hantera anropen från appen Lex Meeting. Förut låg dessa web-servicar inbakade i Lex2 WebServer men de är nu utbrutna till en egen komponent, bl.a. för att bara exponera behövd web-service ut mot internet samt för att bättre kunna möta driftbehoven för Lex2 Meeting Server.

InstallationFör att köra installationen körs filen Lex2MeetingServerSetup.msi. Följande val finns under installationen;

Fyll i uppgifterna för server, databas samt om Integrated Security används eller inte.

Vid installationen så skapas följande i lokal IIS:

1. En applikation som heter Lex2MeetingServer och den web-service som skall exponeras mot internet är http://webservernamn/Lex2MeetingServer/services/LexMeeting.svc.

2. En applikationspool som heter Lex2MeetingServer.

En lämplig säkerhetslösning kan vara att köra trafiken via SSL genom en Proxyserver. Detta då det skickas känsliga uppgifter så som sekretessbelagda handlingar till LexMeeting över Internet.

Uppdatering av databas

/33


http://webservernamn/Lex2MeetingServer/services/LexMeeting.svc

Beskrivning av komponentSom en del i Lex2-projektet ingår även att uppdatera och skriva om den kod som finns i databasservern (lagrade procedurer, vyer, funktioner och triggrar) och eftersom Lex2 under en överskådlig framtid kommer att samexistera med den befintliga Lex så innebär detta att det kommer att finnas en dubbel uppsättning kod i databasen. Det bägge systemen har gemensamt även i fortsättningen är datat i tabellerna.

Lex lagrade procedurer ligger kvar i schemat ’dbo’ där dom alltid har legat, Lex2’s lagrade procedurer läggs däremot scheman som är namnmässigt mer beskriver funktionen. Inga av Lex2’s lagrade procedurer ligger i schemat ’dbo’.

InstallationFör att köra installation och uppdatering av databas körs filen Lex2UpgradeDatabase.exe.

Om man trycker på knappen ’…’ så får man upp en dialogruta där man enkelt kan fylla i servernamn, databas samt inloggningsuppgifter. Notera att Integrated Security inte kan användas för att logga in i databasen, utan man måste använda en sql-inloggning, t.ex. sa eller någon annan användare som har sysadmin-rättigheter.

Det finns 2 stycken skriptköer som man måste köra, Lex2 och Lex2 log. Man väljer först Lex2 och trycker på Kör uppgradering, och när detta är klart så väljer man Lex2 Log och trycker på Kör uppgradering.

Flytt av databasNär man flyttar en Lex2’s databas från en databasserver till en annan, så är det viktigt att få med några speciella användare och inställningar över till den nya servern. I en underkatalogen ’SqlTools’ i installationskatalogen för Lex2Server finns det några skriptfiler för att hjälpa till med flytten. Dessa skript behöver köras på den nya databasservern.

Lex.sql

/33


Kör detta skript i Lex2’s databas (”AES”) för att sätta upp kontot ”lex”.

Eftersom det är möjligt att ändra detta kontos namn och lösenord så är det viktigt att redigera denna fil först och ersätta kontot ”lex” (6 förekomster) med det konto som används.

Om kontot inte finns i SQL Server som inloggning sedan innan så är det viktigt att även sätta rätt lösenord (1 förekomst) i filen också.

LexSystem.sqlKör detta skript i Lex2’s databas (”AES”) för att sätta upp kontot ’LEXsystem’.

LexLoginAdmin.sqlKör detta skript i Lex2’s databas (”AES”) för att sätta upp kontot ’LexLoginAdmin’. Observera att man måste ändra texten ”DatabasNamn” till namnet på Lex2’s databas innan man kör skriptet.

Lexloguser.sqlKör detta skript i Lex2’s databas (”AES”) samt även i logdatabasen om sådan används för att sätta upp kontot ’lexloguser’. Observera att man måste ändra texten ”DatabasNamn” till namnet på Lex2’s databas (samt eventuellt logdatabasen) innan man kör skriptet.

/33


Documents

Enkelt brev - lex.solarplexusit.se file · Web viewEnkelt brev - lex.solarplexusit.se