Driftsdokumentasjon for ePhorte

3.1.1   Oracle

Installasjon av Oracle 11gR2 (istedefor 10.2):

Kjør: \\tro-install\Trofastprog\Oracle\win64_11gR2_client\client\setup.exe
Kjør CUSTOM install
Velg kun engelsk
Base: C:\oracle\
Installer:

  * Oracle Database Utilities
  * SQL*Plus
  * Oracle NET
  * Oracle ODBC Driver
  * Oracle Data Provider for .NET
  * Oracle Providers for ASP.NET

Kopier inn sqlnet.ora, tnsnames.ora og ldap.ora:

  copy \\usitadmin\GenericDist\Oracle-config\*.ora c:\oracle\product\11.2.0\client_1\network\admin

Installasjon av Oracle 10.2 (Gammel versjon, dokumentasjon beholdt for bakoverkopabilitet - installer versjon 11gR2!):

Kjør: \\tro-install\Trofastprog\Oracle\Ora_10.2.0.3.32bit\Disk1\setup.exe
Kjør CUSTOM  install
Name: OraHome102
Path: c:\oracle\ora102
Installer:

  * Oracle Database Utilities
  * SQL*Plus
  * Oracle Windows Interfaces
    * Oracle Objects for OLE
    * Oracle ODBC driver
    * Oracle Provider for OLE DB
    * Oracle Data Provider for .NET
  * Oracle Call Interface (OCI)
  * Oracle NET

Huk av på "Operating system not supported" slik at den går over til "user verified" når du installerer Oracle 10.2.0.3 - da får du installert.
Kjør patch:

  \\tro-install\Trofastprog\Oracle\Ora_10.2.0.4.upg.32bit\Disk1\setup.exe

Legg inn sqlnet.ora, tnsnames.ora og ldap.ora i c:\oracle\ora102\NETWORK\ADMIN:

  copy \\usitadmin\GenericDist\Oracle-config\*.ora c:\oracle\ora102\NETWORK\ADMIN)

Sett så riktig NLS_LANG ved å starte regedit og legge til nøkkel:

  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraHome102\NLS_LANG = AMERICAN_AMERICA.WE8MSWIN1252

Med Powershell:

  Set-ItemProperty HKLM:\SOFTWARE\Wow6432Node\ORACLE\KEY_OraHome102\ -name NLS_LANG -value AMERICAN_AMERICA.WE8MSWIN1252

3.1.2   ePhorte

Last dokumentasjon fra Gecko: http://gecko.no/getfile.aspx/document/epcx_id/802/epdd_id/828

Installer rollene IIS og APP server som beskrevet i installsjonsdok til Ergo

Før du lager App-pool for ePhorte gjør følgende:

Høyreklikk "Application Pools" og velg "Set Application pool defaults"
Sett "Managed Pipeline Mode" til "Classic"
Sett "Queue Length" til 4000
Sett "Idle Time-out" til 0
Sett "Regular Time Interval" til 0
Velg "Specific Times" / "Add" og sett "0200"
Sett "Process Model" -> "Load User Profile" til TRUE

Installer ephorte 2010.1:

Start CMD vindu som Administrator
Kjør i CMD vinduet: \\tro-install\Trofastprog\ePhorte\ePhorteWeb_x64_XXX.XX.msi
Velg C:\Program Files\ePhorteWeb- c:\program files (x86)\ephorteweb som installasjonskatalog

Gi trofast\ephortesys(-test) "WRITE" rettigheter på katalogen ePhorteWeb. Viktig at han ikke får "Full Control" eller "Modify" for da har ePhorte en tendens til å slette moderkatalogen.

Kopier inn Dummy.appSettings og dummy.intellisearchConfiguration.config fra app_data\config\ til ePhorteWeb\Configuration og fjern prefix.

Lag Virtual Directory "ephHjelp" i IIS - link mot C:\Program Files\ePhorteWeb\shared\help

Lag katalogen c:\temp\tmpMessage

3.1.3   Event Viewer

Vi har litt problemer med dette på dagens versjon av ephorte4/2.0.23 Trikset nå er å legge til ephortesys brukern i admin gruppa på servern, gå på c:\windows\\System32\winevt\Logs og gi ephortesys brukern read/write rettigheter på Ephorte.evtx. La den stå over natta og fjerne den ifra admingruppa dagen etterpå. Da vil den logge nogenlunde. Dagens versjon har også begynt å logge til Application loggen som tidligere. Meldt inn men vi fant ut at vi måtte re-installre serverne for å få dette så vi avventer.

Kjør følgende for å få inn ePhorte-events:

\\USITADMIN\ephorte\install_scripts\ephorte_eventsource.reg

3.1.4   FEIDE

Kopier inn innstilliger:

mkdir "C:\Program Files\EphorteWebMetadata"
xcopy /E \\usitadmin\ePhorteConfig\EphorteWebMetadata\* 'C:\Program Files\EphorteWebMetadata\'

Man må sjekke config-fila ePhortewebConfigurationsystem.web.sessionState.config. Den skal se omtrent slik ut:

<sessionState mode="StateServer"
              stateConnectionString="tcpip=127.0.0.1:42424"
              sqlConnectionString="data source=127.0.0.1;user id=sa;password="
              cookieless="false"
              timeout="1440">

</sessionState>

Følgende verdier må sjekkes:

• Verdien mode MÅ IKKE stå til InProc, men StateServer som ovenfor eller SQLServer
• Verdien timeout er i minutter, og bør ha en relativt høy verdi. (Ovenfor: 1440 = 24 timer.)

Start Servicen "ASP.NET State Service" og sett denne på Automatisk Oppstart.

3.1.5   Sertifikater

Legg inn root-sertifiktat for FEIDE:

copy \\tro-install\Trofastprog\ePhorte\idp.feide.no.pem c:\temp
mmc
legg til "certificates" (CTRL-M -> certificates -> add) som "Computer Account" på "local computer"
Velg "Trusted Root Certificate Authorities" og "Certificates"
Høyreklikk og velg "All tasks -> Import" og importer ``c:\temp\idp.feide.no.pem``

3.1.6   Kataloger

Lag katalogen c:\ephorte og gi ephortesys(-test) full tilgang til katalogen. Lag så underkatalogene workfolder og tmpmessage.

3.1.7   Kloning

3.1.8   Tilpasningskriptene

Under c:\etc på "Master" templaten så er det ei fil som heter customization.bat. Sjekk der hvilke filer som blir kjørt. Det er gjort en del modifikasjoner.

Til slutt kopierer du inn tilpasnings-scriptene fra \\TRO-INSTALL\Trofastprog\ePhorte\customize til c:\etc og legger inn riktig passord:

• certacl.ps1 - kopieres rett inn uten forandringer
• createapp.ps1 - bytt ut "PASSORD" med passordet til trofast\ephortesys
• getconfig.ps1 - bytt ut "PASSORD" med passordet til trofast\trofastproginst
• customize.bat - bytt ut "PASSORD" med nøkkelen til SSL-sertifikatet *.ephorte.uninett.no

9.2.1   Slå av feide

Endre <AllowEphorteAuthentication>false</AllowEphorteAuthentication> i ephorte.config til true og fjern følgen XML tagger:

<FederatedAuthenticationMode>Saml2</FederatedAuthenticationMode>
<FederatedSignOutUrl>https://uiotest.ephorte.uninett.no/ePhorteWeb/logout.ashx</FederatedSignOutUrl>

så kjører du en iisreset og dermed så er feide slått av for den skolen.

9.2.2   Editere ephorte.config

c:\program files (x86)\ephorteweb ephorte.config er selve master konfigurasjonsfilen for ephorte servern. Beksrivelser av feltene som finnes, finner du her:http://gecko.no/getfile.aspx/document/epcx_id/816/epdd_id/841 Her setter du opp hvilken database du skal bruke. Det du skriver mellom database taggene her leter den etter i ConnectionStrings.config for å få riktige oppkoblingsparamtere til DB. Ellers så får du ofte beskjed ifra kunden eller Evry hva du skal endre. Etterpå så kjører du enten en IIS reset evt en delcache for å få "satt" det.

9.2.3   Feide.federation.config

c:\program files (x86)\ephorteweb\Configuration Denne fila blir brukt av FEIDE implementasjonen til ephorte for godkjenne inn/utlogging av ephorteserveren igjennom feide. Verdet å merke seg her er SigningCertificate findValue taggen. Den må være lik ett av ssl sertifikatene på web serveren. Kan godt være et av de utgåtte men det MÅ være der.

9.2.4   EphorteWebMetadata

C:\Program Files\EphorteWebMetadata Her ligger selve connectoren mellom ephorte og feide. Her er det en del sertifikater som må stemme overnes med hva som står i xml filene. Ta kontakt med uninett for disse. Under C:\Program Files\EphorteWebMetadata\Idp så finner du ei fil som heter metadata.xml. Her må du oppdatere entityID="https://idp-test.feide.no" til idp.feide.no. Dette for at ephorte serveren skal koble seg til riktig feide server.

9.2.5   ConnectionStrings.config

c:\program files (x86)\ephorteweb\Configuration Denne filen inneholder oppkoblingsparameterne til databsen for den enkelte ephorte institusjon. Hva ephorte servern skal benytte seg velger du i følgende seksjon i ephorte.config. MERK: Det er <NAME> taggen som stryer hvilken database du skal koble deg til.

<Database.Config>
       <Database>
               <Name>uiotest2</Name>
               <AvailableOnServers>uiotest.ephorte.uninett.no:443/ePhorteWeb</AvailableOnServers>
               <Description>ePhorte uio testserver</Description>
               <Theme />
               <TransactionLevel />
               <Type>oracle</Type>
               <UseDatabaseKeyGeneration>true</UseDatabaseKeyGeneration>
         </Database>

9.3.1   Services

Gecko Converter Controller: Servicen som MÅ være startet for at dokumentene skal kunne konverteres. Gecko PDF konverten: Selve programmet som konverterer word til PDF. Filene blir streamet over til PDF konverteren også starter denne servicen å konvertere dokuemntet. Den stopper igjen når jobben er gjort. Gecko Cleanup Service

9.3.2   Konfigurasjons filer

PdfConfiguration.config: Inneholder konfigurasjon for den enkelte skole. Her setter du logg stien, intervall samt loggnivå. Kjekt når du skal debugge. Du må legge inn en "bolk" pr skole. Hvis ikke så vil ikke skolen bli konvertert. Eksempel på "bolk":

<PdfConvertSetting>
        <DatabaseName>UiOkurs</DatabaseName>
        <ConvertInterval>5</ConvertInterval>
        <LogFile>C:\log\PDFConvertEphorte.log</LogFile>
        <MaxDocumentsToConvert>10</MaxDocumentsToConvert>
        <MaxDocumentConvertTime>180</MaxDocumentConvertTime>
        <PdfDocActive>true</PdfDocActive>
        <StorageUnit>PROD</StorageUnit>
        <UseMultiLingualSupportOnPdf>false</UseMultiLingualSupportOnPdf>
        <UseTableBasedPdfConvert>true</UseTableBasedPdfConvert>
        <VerboseLevel>5</VerboseLevel>
</PdfConvertSetting>

PDF.ConnectionString.config: Inneholder oppkoblings parameterer for PDF konverteren til databasen.

GeckoPDFConverter.exe.config: Inneholder overordene konfigurasjonsvalg og vil gjelde alle brukere av PDF konverteren. Her setter du valg om feks ActivePDF, logfil, char set encoding etc..

9.3.3   ephorte.config

Under c:\windows\ så ligger ephorte.config for PDF konverteren. Fått beskjed om at denne ikke gjelder men for sikkerhets skyld så oppdater den som dokumentasjonen ifra leverandøren ønsker. Eksempel på bolk:

<Database.Config>
  <Database> <---"Bolkstart"
        <Name>UiOkurs</Name>
  </Database> <--"Bolkslutt"
<Database.Config>

Viktig! Du kan klone opp PDF konverteren ifra en av den andre, men du må oppdatere systembrukere etc etc som dokumentasjonene sier, dvs du må oppdaterre hvilke av ephorte brukerene som skal kjøre servicene, rettigheter på share og filrettigheter, office brukere etc etc. Ta kontakt med support'n til Evry hvis du er usikker.

9.3.4   DocumentUploader/PixEdit

Opplastingen av dokumenter ifra klienten fungerer på følgende måte.

1: Det må installeres et program på klienten som heter DocumentUploaderSVS.exe, dette programet streamer dokumenter over til ephorte serveren igjennom webservicen. 2: Det finnes 2 config filer, en på klienten og en på serveren, som styrer hvor filene havner. På server siden så er det c:ProgramFiles (x86)ephortewebConfigurationUploadStorage.config som styrer hvor på C:filene blir lagt.

Dokumentasjon for hvordan du klargjør servern for DocumentUploadern.