Changeset 998

Timestamp:

01/30/09 10:34:10 (3 years ago)

Author:

hovenko

Message:

Translated the user and system documentation from Norwegian to English

Files:

• trunk/doc/systemdoc/en/configuration.tex (modified) (2 diffs)
• trunk/doc/systemdoc/en/introduction.tex (modified) (1 diff)
• trunk/doc/systemdoc/en/solution.tex (modified) (1 diff)
• trunk/doc/systemdoc/en/systemdocumentation.tex (modified) (2 diffs)
• trunk/doc/systemdoc/en/technical.tex (modified) (1 diff)
• trunk/doc/userdoc/en/error-situations.tex (modified) (1 diff)
• trunk/doc/userdoc/en/introduction.tex (modified) (1 diff)
• trunk/doc/userdoc/en/printer-setup.tex (modified) (2 diffs)
• trunk/doc/userdoc/en/userdocumentation.tex (modified) (2 diffs)
• trunk/doc/userdoc/en/webinterface.tex (modified) (1 diff)

trunk/doc/systemdoc/en/configuration.tex

@@ -1 @@
-Konfigurasj
-
-Det er flere deler av Bifrost-lÞsningen som må konfigureres. Det meste er kort forklart i \texttt{INSTALL}-dokumentet som ligger på roten av prosjektkatalogen
-I dette kapittelet presenteres konfigurasjonsfilene for CUPS Backend-drivere og Bifrost Back
+Configurati
+
+A number of aspects of Bifrost need to be configured. Most of this is explained in the \texttt{INSTALL} document on the project catalog root
+This chapter describes the configuration files for the CUPS Back-end drivers and Bifrost Back-
-
-
-\section{CUPS Backend}
-
-
-
-
-
+
+
+
+
-
-\subsection{followme}
-Konfigurasjon for backend-driveren ``followme''
+Configuring the ``followme'' back-end driver
-
-\subsubsection{URL\_BASE}
-URL til Bifrost backend
-Denne vil trolig måtte settes til en ny verdi, da den ellers tilbakefaller til
-Dersom applikasjonen er satt opp på rota med for eksempel Apache og FastCGI må denne konfigurasjonsparameteren settes til
+the Bifrost back-end URL
+Usually, you will have to set a new value, so it doesn't fall back to
+If the application is set up on the root with e.g. Apache and FastCGI, this configuration parameter must be set to
-
-\subsubsection{URL\_UPDATE\_QUOTA}
-t URL til Bifrost backend for oppdatering av kvote
-Denne vil tilbakefalle på ``/backend/cups/decrement\_quota'', prefikset med ``URL\_BASE''
+e URL for the Bifrost back-end for updating quotas
+This will fall back to ``/backend/cups/decrement\_quota'', with a ``URL\_BASE'' prefix
-
-\subsubsection{URL\_ENOUGH\_QUOTA}
-t URL til Bifrost backend for sjekking av brukerens kvote
-Denne vil tilbakefalle på ``/backend/cups/enough\_quota'', prefikset med ``URL\_BASE''
+e URL for the Bifrost back-end for checking user quotas
+This will fall back to ``/backend/cups/enough\_quota'', with a ``URL\_BASE'' prefix
-
-\subsubsection{URL\_REPORT\_ERROR}
-t URL til Bifrost backend for rapportering av feil
-Denne vil tilbakefalle på ``/backend/cups/error'', prefikset med ``URL\_BASE''
+e URL for the Bifrost back-end for error reports
+This will fall back to ``/backend/cups/error'', with a ``URL\_BASE'' prefix
-
-\subsubsection{USER\_AGENT}
-Navnet på brukeragenten som kaller på Bifrost back
-Denne vil tilbakefalle på
-Denne behÞver du ikke endre, ved mindre du har spesielle behov med tanke på for eksempel traversering igjennom proxy-tjenester eller logging av trafikk basert på agent
+The name of the user agent that calls the Bifrost back-
+This will fall back to
+You do not need to modify this, unless you have specific needs for e.g. traversing through proxy services or agent-based traffic logging
-
-\subsubsection{TIMEOUT}
-Antall sekunder å maksimalt vente fÞr en HTTP request mot Bifrost backend avbrytes
-Denne vil tilbakefalle på ``15'' sekunder
+The maximum number of seconds to wait before a HTTP request against Bifrost back-end is canceled
+This will fall back to ``15'' seconds
-
-\subsubsection{DEBUG}
-
-
+
+
+
-
-\begin{verbatim}
----
-         
- 
- 
- 
-       
-           
-             
+Â  Â  Â  Â  Â 
+Â 
+Â 
+Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â 
-\end{verbatim}
-
-
-\subsection{route}
-Konfigurasjon for backend-driveren ``route''
+Configuration of the ``route'' back-end driver
-
-\subsubsection{LPR}
-Full sti til programmet \textbf{lpr} som brukes for utskrift
+Complete path to the \textbf{lpr} application used for printing
-
-\subsubsection{DEBUG}
-tes til en \textbf{SANN} verdi for å skru på
-Denne vil tilbakefalle til en \textbf{USANN} verdi, som skrur av
+ to a \textbf{TRUE} value to enable
+This will fall back to a \textbf{FALSE} value, disabling
-
-\begin{verbatim}
----
-               
-             
-
-
-
-
-
-Ta utgangspunkt i konfigurasjonsfilen som ligger
-Konfigurasjonsfilen forventes å ligge under roten hvor Bifrost backend ble installert, for eksempel
-Denne konfigurasjonsfilen er skrevet i
-
-Noen konfigurasjonsparametere kan vÊre unnlatt å nevne her\footnote{Det er Þnskelig å gjÞre dokumentasjon mer komplett, vennligst meld i fra dersom noe mer bÞr inn her
-Det henvises derfor til \textbf{POD} i de forskjellige modulene som kan leses med
-
-entisering
+Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â 
+
+
+
+-
+
+Start with the configuration file
+The configuration file is expected to reside under the root where the Bifrost back-end was installed, for instance
+This configuration file is written in
+
+Certain configuration parameters may have been left out here\footnote{We wish to make the documentation as complete as possible; please notify us of suggested additions
+Please refer to \textbf{POD} in the respective modules, readable with
+
+hentication
-\label{configuration-authentication}
-er konfigurert til å autentisere mo
-Det er slik at brukere og administratorer er lagt i to forskjellige grener i LDAP-treet, og derfor er det konfigurert opp to realms, én for brukere og én for administrasjonen
-
-entisering er konfigurert under parameteren \textbf{autentication} i konfigurasjonsfilen
-GjÞr nÞdvendige endringer for ditt miljÞ, som \textbf{ldap\_server} og
-Konfigurasjon av denne parameteren er forklart i Perl-modulen \textbf{Catalyst::Plugin::Authentication}\footnote{http://search.cpan.org/perldoc?Catalyst::Plugin::Authentication}
+is configured to authenticate agains
+Users and administrators are placed in two different branches of the LDAP tree. As a consequence, two realms have been configured; one for users and another for administrators
+
+hentication is configured under the \textbf{authentication} parameter in the configuration file
+Make the appropriate modifications for your environment, such as \textbf{ldap\_server} and
+Configuration of this parameter is described in the \textbf{Catalyst::Plugin::Authentication}\footnote{http://search.cpan.org/perldoc?Catalyst::Plugin::Authentication} Perl module
-
-\subsubsection{store - roles}
-Konfigurasjonsparameteren \textbf{roles} inneholder en liste over roller/grupper som brukere i valgt realm tildeles
-I Bifrost skiller vi bare på vanlige brukere (user) og administrasjonsbrukere
-
-Denne konfigurasjonsparameteren benyttes av modulen \textbf{Followme::Authentication::Store::LDAP}, som er en utvidelse av standardmodulen til Catalyst for autentisering mo
+The \textbf{Roles} configuration parameter contains a list of roles/groups that are assigned to users in the selected realm
+Bifrost only distinguishes between ordinary users (user) and administrator users
+
+This configuration parameter is used by the \textbf{Followme::Authentication::Store::LDAP} module, which is an extension of the default Catalyst module for authentication agains
-
-\begin{verbatim}
-authentication:
-  default_realm:  
- 
-   
-     
-        class:          
-       
-        password_type:  
-     
-        class:          
-        ldap_server:    
-        start_tls:      
-        user_basedn:    
-        user_filter:    
-        user_scope:    
-        user_field:    
-       
-          deref:          
-       
-          -  
-   
-     
-        class:          
-       
-        password_type:  
-     
-        class:          
-        ldap_server:    
-        start_tls:      
-        user_basedn:    
-        user_filter:    
-        user_scope:    
-        user_field:    
-       
-          deref:          
-       
-          -  
-
-
-
-Brukere i samme gren
-Dersom vanlige brukere og administrasjonsbrukere finnes i samme gren i LDAP-treet og er delt inn i grupper kan fÞlgende konfigurasjon benyttes
+Â  default_realm: Â 
+Â 
+Â  Â 
+Â  Â  Â 
+Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  password_type: Â 
+Â  Â  Â 
+Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  ldap_server: Â  Â 
+Â  Â  Â  Â  start_tls: Â  Â  Â 
+Â  Â  Â  Â  user_basedn: Â  Â 
+Â  Â  Â  Â  user_filter: Â  Â 
+Â  Â  Â  Â  user_scope: Â  Â 
+Â  Â  Â  Â  user_field: Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  deref: Â  Â  Â  Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  - Â 
+Â  Â 
+Â  Â  Â 
+Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  password_type: Â 
+Â  Â  Â 
+Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  ldap_server: Â  Â 
+Â  Â  Â  Â  start_tls: Â  Â  Â 
+Â  Â  Â  Â  user_basedn: Â  Â 
+Â  Â  Â  Â  user_filter: Â  Â 
+Â  Â  Â  Â  user_scope: Â  Â 
+Â  Â  Â  Â  user_field: Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  deref: Â  Â  Â  Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  - Â 
+
+
+
+Users in the same branch
+If ordinary users and administrator users reside in the same LDAP tree branch, and are grouped, the following configuration can be used
-
-\begin{verbatim}
-default_realm: ldap
-realms:
- 
-   
-      class:          
-     
-      password_type:  
-   
-      class:          
-      ldap_server:    
-      start_tls:      
-      user_basedn:    
-      user_filter:    
-      user_scope:    
-      user_field:    
-     
-        deref:          
-      use_roles:      
-      role_basedn:    
-      role_filter:    
-      role_scope:    
-      role_field:    
-      role_value:    
-     
-        deref:          
-
-
-Bemerk at modulen \textbf{Followme::Authentication::Store::LDAP} ikke lenger brukes, men heller
-
-
-brukere i konfigurasjonsfilen
-Dersom man Þnsker et enklere oppsett over administratorbrukere i Bifrost kan man konfigurere opp brukernavn og passord i
-
-FÞlgende konfigurasjon setter opp en administrator som heter ``superadmin'' med passordet ``hemmelig''
+Â 
+Â  Â 
+Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â 
+Â  Â  Â  password_type: Â 
+Â  Â 
+Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  ldap_server: Â  Â 
+Â  Â  Â  start_tls: Â  Â  Â 
+Â  Â  Â  user_basedn: Â  Â 
+Â  Â  Â  user_filter: Â  Â 
+Â  Â  Â  user_scope: Â  Â 
+Â  Â  Â  user_field: Â  Â 
+Â  Â  Â 
+Â  Â  Â  Â  deref: Â  Â  Â  Â  Â 
+Â  Â  Â  use_roles: Â  Â  Â 
+Â  Â  Â  role_basedn: Â  Â 
+Â  Â  Â  role_filter: Â  Â 
+Â  Â  Â  role_scope: Â  Â 
+Â  Â  Â  role_field: Â  Â 
+Â  Â  Â  role_value: Â  Â 
+Â  Â  Â 
+Â  Â  Â  Â  deref: Â  Â  Â  Â  Â 
+
+
+Please note that the \textbf{Followme::Authentication::Store::LDAP} module is no longer used; instead use
+
+
+ users in the configuration file
+If you want a simpler setup for Bifrost administrator users, you can configure user names and passwords in
+
+The following configuration defines an administrator called ``superadmin'' with ``secret'' as his password
-
-\begin{verbatim}
-realms:
- 
-   
-      class:          
-     
-      password_type:  
- 
-    class:          
-   
-     
-
-       
-          -  
+Â 
+Â  Â 
+Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â 
+Â  Â  Â  password_type: Â 
+Â 
+Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â 
+Â  Â  Â 
+
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  - Â 
-\end{verbatim}
-
-
-\subsection{Realms}
-
-Fordi denne modulen ble laget som en ``workaround'' for å stÞtte opp under oppdelingen av brukere og administrasjonsbrukere i forskjellige grener i LDAP-treet, er det ikke mulig å endre på denne konfigurasjonen for å legge til fle
-Dette fordi malfilene for nettsidene kun stÞtter ``admins'' i tillegg til ``default'', som i vårt tilfelle er
+
+This is where you specify the available realms, or user groups. Since this module was developed as a ``workaround'' to support the split of users and administrator users into separate branches on the LDAP tree, it is not possible modify this configuration in order to add mo
+The template files for web pages only support ``admins'' in addition to ``default'', which in our case equals
-
-\subsubsection{realms}
-En nÞkkel/verdi-liste over
-NÞkkelen må matche mot realms definert i \textbf{authentication} (se seksj
-Verdien er et menneskevennlig navn på realmet
+A key/value list of
+The key needs to match realms defined in \textbf{authentication} (see secti
+The value is a user-friendly name of the realm
-
-\begin{verbatim}
-Model::Realms:
- 
-   
-    users:  
-
-
-
-postadresser
-Konfigurasjon av e-postadresser og -utsending gjÞres under parameteren \textbf{Model::Email}
+Â 
+Â  Â 
+Â  Â  users: Â 
+
+
+
+mail addresses
+Configure e-mail addresses and e-mail submission under the \textbf{Model::Email} parameter
-
-\subsubsection{admin}
-Dette er e-postadressen til systemadministrator. Denne e-posten vil motta kopi av feilmeldinger som sendes ut til brukere
+This is the system administrator's e-mail address, which receives copies of error messages to users
-
-\subsubsection{from}
-Dette er e-postadressen som står som avsender på e-post som sendes ut fra
+This is the e-mail address displayed as sender of e-mail messages from
-
-\subsubsection{default\_locales}
-Dette er det forhåndsvalgte språket for e-post som sendes ut dersom klienten som meldte fra om feilen ikke har spesifisert hvilket språk som skal benyttes
-Dette kan vÊre navnet på språket eller en liste med navn
+This is the pre-selected language for e-mail messages submitted if the client who reported the error has not specified which language to use
+This could be the name of the language or a list of names
-
-\subsubsection{user\_fmt}
-Dette er formatstrengen som brukes for å finne fram til brukernes e-postadresser
-byttes ut med brukernavnet til brukeren
-e brukere må kunne nås på samme domenenav
+This is the format string used for finding the users' e-mail addresses
+is replaced with the user's user name
+ users must be reachable on the same domai
-
-\begin{verbatim}
-Model::Email:
-  admin:              
-  from:              
-  default_locales:    
-  user_fmt:          
-
-
-
-sj
-Konfigurasjonen for administrasjonsgrensesnittet spesifiserer hvilke roller som har tilgang med parameternavnet \textbf{require\_roles}
-Dette kan vÊre navnet på rollen eller en liste med rollenavn
-
-Det anbefales å ikke endre på denne
+Â  admin: Â  Â  Â  Â  Â  Â  Â 
+Â  from: Â  Â  Â  Â  Â  Â  Â 
+Â  default_locales: Â  Â 
+Â  user_fmt: Â  Â  Â  Â  Â 
+
+
+
+ti
+The configuration of the administration interface specifies role access with the \textbf{require\_roles} parameter
+This could be the name of the role or a list of role names
+
+We recommend that you do not modify this
-
-\begin{verbatim}
-Controller::Admin:
- 
+Â 
-\end{verbatim} 
-
-
-Tilgangskontroll til backend
-
-Realm-et \textbf{cardreaders} bestemmer hvor kortlesere kommer fra
-Realm-et \textbf{ez} bestemmer hvor portallÞsninger kan komme fra; disse har anledning til å liste ut, legge til og slette jobber og liste ut kvote for brukere
-
-t
-inneholder en liste over subnett som har tilgang
-Disse defineres med nettverksadressen med CIDR-notasj
-Det er viktig at localhost (127.0.0.1/8) har tilgang for at CUPS skal kunne sjekke og oppdatere kvoter
+Back-end access control
+
+The \textbf{cardreaders} realm decides where card readers come from
+The \textbf{ez} realm decides where portal solutions can come from; these can list, add and delete print jobs and list user quotas
+
+
+contain a list of subnets with access
+These are defined with the network address using CIDR notati
+Important: localhost (127.0.0.1/8) must have access in order for CUPS to check and update quotas
-
-\begin{verbatim}
-authentication:
-   
-       
-           
-                class:          
-           
-                class:          
-               
-                   
-                        network:    
-                        cidr:      
-                   
-                        network:    
-                        cidr:      
-       
-           
-                class:          
-           
-                class:          
-               
-                   
-                        network:    
-                        cidr:      
-                   
-                        network:    
-                        cidr:      
-                   
-                        network:    
-                        cidr:      
-
-
-
-
-Kortinnlesing
+Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  network: Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  cidr: Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  network: Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  cidr: Â  Â  Â 
+Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  class: Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  network: Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  cidr: Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  network: Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  cidr: Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  network: Â  Â 
+Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  Â  cidr: Â  Â  Â 
+
+
+
+
+Reading cards
-\label{configuration-mac-lookup}
-Det er mulig å konfigurere mottaket for kortdata til å tillate kortlesere å sende sin MAC-adresse som parameter\footnote{MAC-adressen setter med parameternavnet ``macaddress''} sammen med kortdataene
-
-Bemerk at denne adressen benyttes kun dersom oppslag i ARP-tabellen feiler
+It is possible to configure the card data reception to allow card readers to submit their MAC addresses a parameter\footnote{the MAC address is set with the ``macaddress'' parameter} together with the card data
+
+Please note that this address is only used if inquiries to the ARP table fail
-
-\subsubsection{allow\_mac\_address}
-tes til en \textbf{SANN} verdi for å tillate egenspesifisert MAC-adresse sammen med kortdataene
-Bemerk at aktivering av dette kan innebÊre en sikkerhetsrisiko
+ to a \textbf{TRUE} value to allow specified MAC address with the card data
+Please note that activating this option may cause a security risk
-
-\begin{verbatim}
-Controller::Backend::Cardreader::Swipe:
-  allow_mac_address:  
-
-
-
-kodeinnles
-Samme konfigurasjon fra kortinnlesing for oppslag av MAC-adresser (se \ref{configuration-mac-lookup}) gjelder også for pinkodeinnles
+Â  allow_mac_address: Â 
+
+
+
+ code read
+The configuration of card reading for MAC address inquiries (see \ref{configuration-mac-lookup}) also applies to  pin code read
-
-\begin{verbatim}
-Controller::Backend::Numpad::Pincode:
-  allow_mac_address:  
+Â  allow_mac_address: Â 
-\end{verbatim}
-
@@ -323 +323 @@
-\subsection{LDAP}
-\label{configuration-ldap}
-
+
+
-
-\subsubsection{host}
-til LDAP-tjeneren
-Kan vÊre på fÞlgende former
+for the LDAP server
+This can use the following formats
-\begin{itemize}
- 
- 
- 
- 
+Â 
+Â 
+Â 
+Â 
-\end{itemize}
-
-settes til standard LDAP-port\footnote{Standard port for LDAP er 389}, dersom den ikke er satt
+is set to default LDAP port\footnote{Default LDAP port is 389}, if it hasn't been set already
-
-\subsubsection{base}
-sÞk i LDAP-databasen
+LDAP database searches
-
-\subsubsection{dn}
-Navnet på administratorbrukeren i LDAP, med tilgang til å opprette og endre på objekter
+The name of the LDAP administrator user, with access rights to create and modify objects
-
-\subsubsection{password}
-Passordet til administratorbrukeren
+The administrator user password
-
-\subsubsection{connection\_class}
-Klassen som brukes for tilkobling til LDAP-tjenesten
-Her brukes \textbf{Followme::LDAP::Connection} for å stÞtte filtrering basert på en felles verdi blant objektene
+The class to be used to connect to the LDAP service
+\textbf{Followme::LDAP::Connection} is used for supporting filtering based on a shared value for the objects
-Anbefales å ikke endre denne.
-
-\subsubsection{use\_cache}
-En \textbf{SANN} verdi skrur på gjenbruk av LDAP-tilkoblinger
-En \textbf{USANN} verdi skrur dette av, som er forhåndsvalgt dersom annet ikke er angitt
-VÊr oppmerksom på at bruk av cache ikke fjerner tilkoblinger som er tatt ned, enten ved nettverksfeil eller eksplisitte nedkoblinger
+A \textbf{TRUE} value enables reuse of LDAP connections
+A \textbf{FALSE} values disables this option; this is the default if nothing else has been specified
+Please note that reuse of cache does nor remove terminated connections, by network errors or explicit disconnects
-
-\subsubsection{user\_filter - field}
- MÞre og Romsdals tilfelle er filteret satt i \textbf{description}-feltet til brukerne, som forteller hvilken skole ansatte og studenter hÞrer til
+n the MÞre and Romsdal installation, the filter has been set to the users' \textbf{description} field, displaying the school the student/staff member belongs to
-
-\subsubsection{user\_filter - filter}
-Filteret som automatisk legges på hvert sÞk
-byttes ut med verdien på feltet satt i \textbf{field} til brukeren som utfÞrer sÞket
-
- MÞre og Romsdals filfelle vil brukere uten description-felt blir inkludert i sÞk
-Þk utfÞrt av administrasjonsbrukere uten description-felt gjÞres blant alle brukere
+The filter automatically assigned to each search
+is replaced with the value of the field that was set in \textbf{field} of the user performing the search
+
+n the MÞre and Romsdal installation, users with no description will be included in searches
+earches performed by administrator users without description fields will include all users
-
-\subsubsection{models}
-\label{configuration-ldap-models}
-
-
+
+
+
-
-\begin{verbatim}
-Model::LDAP:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\subsubsection{initialQuota}
-sifiserer hvor mye kvote en bruker får i starten, når brukeren får utdelt et kort eller ved oppstart av semesteret
+cifies the initial size of a user quota, when the user is given a card, or at the beginning of term
-
-\subsubsection{incrementalQuota}
-
-
+
-
-\subsubsection{incrementSchedule}
-
-
+
-
-\begin{verbatim}
-Model::Quota:
-
-
-
-
-
-
+
+
+
+
+
-
-\subsubsection{code\_length}
-den av pinkoder som er tillatt
-
-Denne må settes til samme lengde som identitetstilbyderne (pinkodeleserne) er konfigurert til
+th of pin codes
+
+This must be set to the same length as the identity providers (pin code readers) are configured for
-
-\begin{quotation}
-
-
-
+
+
-\end{quotation}
-
-\begin{verbatim}
-Model::PinCodes:
-
-
-
-
-
-
+
+
+
+
+
-
-\subsubsection{auto\_sn\_prefix}
-sifiserer en streng (eller et tegn) som autogenererte ID-er for kort prefikses med
+cifies a string (or a character) to be used as prefix for auto-generated IDs
-
-\begin{verbatim}
-Model::Cards:
-  auto_sn_prefix:    
-
-
-
-Kort
-Konfigurasjon for status på kort
+Â  auto_sn_prefix: Â  Â 
+
+
+
+Card 
+Configuration of card status
-
-\subsubsection{entity\_class}
-sifiserer hvilken klasse som skal brukes som entitetsklasse for status-objektene
+cifies the class to be used as entity class for status objects
-
-\subsubsection{default}
-sifiserer hvilken status i listen over \textbf{available} som skal vÊre standard
-Denne blir også den eneste statusen som anses som aktiv, mens alle andre vil deaktivere kortet slik at det ikke kan brukes for utskrift
+cifies the default status in the list of \textbf{available} statuses
+This will be the only active status. All other statuses will disable the card as a means of printing
-
-\subsubsection{available}
-
-
-
-
-
+
+
+
-
-\begin{verbatim}
-Model::Cards::Status:
- 
-  default:      
- 
-    lost:        
-    active:      
-    locked:      
-
-
-
-Kortlesere
-Konfigurasjon for kortlesere
+Â 
+Â  default: Â  Â  Â 
+Â 
+Â  Â  lost: Â  Â  Â  Â 
+Â  Â  active: Â  Â  Â 
+Â  Â  locked: Â  Â  Â 
+
+
+
+Card readers
+Card reader configuration
-
-\subsubsection{ldap\_order\_by}
-Kortlesere sorteres etter dette feltet når de listes ut
+The list of card readers is sorted by this field
-
-\subsubsection{ldap\_rdn\_field}
-Feltet i kortleserobjekter som brukes i DN\footnote{Distinguished Name; unik adresse til et objekt i LDAP} for kortlesere
+The card reader object field that is used in DN\footnote{Distinguished Name; unique address for an LDAP object} for card readers
-
-\subsubsection{ldap\_model}
-Navnet på modellen som skal brukes for tilkobling til
-Dette navnet på vÊre konfigurert som modell under \textbf{Model::LDAP} (se seksj
+The name of the model used for connecting to
+This name should be configured as a model under \textbf{Model::LDAP} (see secti
-
-\subsubsection{ldap\_filters - find\_all}
--filter som brukes ved å liste ut alle kortlesere
+ filter used for listing all all card readers
-
-\subsubsection{ldap\_filters - find\_by\_field}
--filter som brukes ved å hente ut én kortles
+ filter used for extracting one card read
-
-\subsubsection{ldap\_filters - find\_by\_field}
--filter som brukes ved sÞk etter kortlesere basert på et attributt
+ filter used for attribute-based searches for card readers
-
-\begin{verbatim}
-Model::Cardreaders:
-  ldap_order_by:  
- 
-  ldap_model:    
- 
-    find_all:          
-    find_by_field:      
-    search_by_field:    
-
-
-
-Brukere
-Konfigurasjon for brukere av systemet
+Â  ldap_order_by: Â 
+Â 
+Â  ldap_model: Â  Â 
+Â 
+Â  Â  find_all: Â  Â  Â  Â  Â 
+Â  Â  find_by_field: Â  Â  Â 
+Â  Â  search_by_field: Â  Â 
+
+
+
+Users
+Configuration of system users
-
-\subsubsection{ldap - filter\_all}
--filter for å hente alle brukere
+ filter to extract all users
-
-\subsubsection{ldap - filter\_find}
--filter for å sÞke etter brukere
-Dette filteret er et stringformat og tar én variabel
+ filter to search for users
+This filter is a string format and takes one variable
-
-\subsubsection{ldap - filter\_find\_by\_uid}
--filter for å hente ut én bruker basert på brukernavnet
+ filter to find one user based on user name
-
-\subsubsection{ldap - scope\_find\_by\_uid}
-Skopet som brukes ved sÞk etter en bruker basert på brukernavnet
-
-Kan vÊre enten
+The scope used when searching for a user based on user name
+
+Can be one of the following
-\begin{itemize}
- 
- 
- 
+Â 
+Â 
+Â 
-\end{itemize}
-
-\subsubsection{ldap - username\_field}
-vnet på LDAP-attributtet som inneholder brukernavn til brukerne
+me of the LDAP attribute containing the users' user names
-
-\begin{verbatim}
-Model::Users:
- 
-    filter_all:        
-    filter_find:        
-   
-    scope_find_by_uid:  
-    username_field:    
-
-
-
-dss
-Konfigurasjon for tidssone for serveren og brukerne
+Â 
+Â  Â  filter_all: Â  Â  Â  Â 
+Â  Â  filter_find: Â  Â  Â  Â 
+Â  Â 
+Â  Â  scope_find_by_uid: Â 
+Â  Â  username_field: Â  Â 
+
+
+
+me z
+Configuration of time zone for server and users
-
-\begin{verbatim}
-Model::TimeZone:
-  name:  
-
-
-
-o- og tids
-Konfigurasjon for dato- og tids
-Denne konfigurasjonen brukes når kort leses inn for administrasjon
-For å endre andre konfigurasjoner enn formatet på dato og tid, som for eksempel lokalisering og tidssone, se Perl-modulen \textbf{DateTime::Format::Strptime}\footnote{http://search.cpan.org/perldoc?DateTime::Format::Strptime}
-e parametere som metoden ``new'' tar imot kan konfigureres her
+Â  name: Â 
+
+
+
+e and time 
+Configuration of date and time 
+This configuration is used for reading administrator cards
+To modify other configurations than date and time format, e.g. localization and time zone, see the \textbf{DateTime::Format::Strptime}\footnote{http://search.cpan.org/perldoc?DateTime::Format::Strptime} Perl module
+ parameters related to the ``new'' method are configured here
-
-\begin{verbatim}
-Model::Timestamp::Format:
-  pattern:    
-
-
-
-UtskriftskÞ
-Konfigurasjon for behandling av utskriftskÞ i bruker-webgrensesnitt
+Â  pattern: Â  Â 
+
+
+
+Print queue
+Configuration of print queue management in the users' web interface
-
-\subsubsection{queue}
-vnet på utskriftskÞen som skal brukes for å lete fram brukerens jobber
-Dette må vÊre samme navnet som på utskriftsklassen i CUPS som brukes for å holde jobber
+me of the print queue to be used for identifying the user's print jobs
+This must be identical to the CUPS print class used to hold/cache?? jobs
-
-\subsubsection{lp\_move}
-Full sti til programmet ``lpmove'', som brukes for å flytte jobber mellom utskriftskÞer
+Complete path to the ``lpmove'' application, used for moving jobs between print queues
-
-\subsubsection{datetime\_format}
-Formatet på dato og tid som vises i bruker-webgrensesnittet for når jobbene ble sendt til utskrift
+The date and time format displayed in the users' web interface for when print jobs are submitted
-
-\begin{verbatim}
-Model::Jobs:
-  queue:            
-  lp_move:          
-  datetime_format:  
-
-
-
-post
-Konfigurasjon for utsending av epost
-Her spesifiseres tegnsett og format på e-postene og adresse eller program for utsending
+Â  queue: Â  Â  Â  Â  Â  Â 
+Â  lp_move: Â  Â  Â  Â  Â 
+Â  datetime_format: Â 
+
+
+
+-mail
+Configuration of e-mail submission
+This is where you specify character set and format for e-mail messages and address or application for submission
-
-\subsubsection{sender - mailer}
-Denne kan settes til \textbf{SMTP} elle
-Ved å spesifisere Sendmail her, vil programmet \textbf{sendmail} benyttes
+This can be set to \textbf{SMTP} o
+If you specify Sendmail, the \textbf{sendmail} application will be used
-
-\subsubsection{sender - mailer\_args}
-Dersom SMTP benyttes må \textbf{Host} vÊre satt til adressen til SMTP-tjeneren
-Det er også mulig å sette brukernavn og passord for innlogging på SMTP-tjeneren med
+If using SMTP, you need to set \textbf{Host} to the SMTP server address
+It is also possible to set user name and password for log-in to the SMTP server with
-
-\begin{verbatim}
-View::Email:
-  default:
-    content_type:  
-    charset:        
- 
-    mailer:        
-   
-      host:          
-
-
-
-avbryt
+Â  Â  content_type: Â 
+Â  Â  charset: Â  Â  Â  Â 
+Â 
+Â  Â  mailer: Â  Â  Â  Â 
+Â  Â 
+Â  Â  Â  host: Â  Â  Â  Â  Â 
+
+
+
+ cancel
-\label{configuration-autocancel}
-Konfigurasjon for autoavbryt av gamle utskriftsjobber
+Configuration of automatic cancelling of old print jobs
-
-\subsubsection{expire\_time}
-
-
+
-
-\begin{verbatim}
-Controller::Backend::Autocancel:
-
-
-
+
+

trunk/doc/systemdoc/en/introduction.tex

@@ -1 @@
-Innledning
+About Bifrost
-
-er navnet på utskriftssystemet utviklet av
+is the name of the printing solution developed by
-
+\section{Introduction}
-
-
+
+
+
-
-
-
-
+
+
-
-
-
-
-
+
-
-
+
+
-
-
-
+
-
-
-
+
-
-
-
-
-
-
+
+

trunk/doc/systemdoc/en/solution.tex

@@ -1 @@
-LÞsningsbeskrivelse
+Solution description
-
-Overordnet arkitektur
+Architecture overview
-
-
-
-
-
-
-
-
+
+
+
+
+
+
-
-e skrivere har tilkoblet en identitetsenhet som er en liten embedded datamaskin, med en USB-kortleser som sender kortdata inn til Bifrost-tjeneren, eller et USB-nummertastatur som sender inn brukerens pink
+ printers are connected to an identity unit; a small embedded computer with a USB card reader, which submits card data to the Bifrost server, or a USB numeric keyboard used for entering the user's pin c
-
-Bifrost-tjeneren finner ut hvilken identitetsenhet som sendte inn brukeridentifiseringen og hvilken skriver denne er koblet til
-Videre leter tjeneren opp kortet eller pinkoden i LDAP-databasen og finner fram brukeren som eier enten kortet eller pinkoden som ble brukt
+The Bifrost server identifies the indentity unit that submitted the card data and which printer it is connected to
+The server also locates the card or pin code in the LDAP database, identifying the user associated with the card or pin code
-
-Dermed blir alle brukerens utskriftsjobber sendt til skriveren
+Next, all print jobs submitted by that user are sent to the printer
-
-
-LÞsningsskisse
+Solution model
-
- \ref{fig:solution-model} viser komponenter og forbindelser/dataflyt i systemet.
-Figuren viser klientmaskiner som både maskiner for administrasjon og studenter som benytter seg av lÞsninge
-De kommuniserer mot CUPS i backend for å skrive ut dokumenter, enten direkte over IPP elle
-Skriverne er skjult bak CUPS-systemet i backend
-holder telling på brukernes utskriftskvoter ved å telle antall sider i PostScript-dokumente
+e \ref{fig:solution-model} displays the system components and connections/dataflow. 
+The figure shows client computers, both administration computers and student computers using the solutio
+They communicate with backend CUPS to print documents, either directly using IPP o
+The printers are hidden behind the backend CUPS system
+keeps track of user print quotas by counting the number of pages in the PostScript documen
-
-Via et webgrensesnitt fra Apache kan brukere administrere egne jobber og få oversikt over sin utskriftskvote
-er kan merke kort som mistet/funnet, administrere pinkoder, administrere kvotepåfyll og administrere kortlesere
+Using an Apache web interface, users can control their own jobs and view their print quota status
+s can tag cards as lost/found, and manage pin codes, quota refills and card readers
-
-avbryt sÞrger for automatisk fjerning av gamle utskriftsjobber fra kÞen
+cancel automatically deletes old print jobs from the queue
-
-
-
-
-
+
+
-
-
-
-
+
-
-\begin{quotation}
-
-
-
+
+
+
+
+
-\end{quotation}
-
-
-\begin{figure}
- 
- 
- 
- \caption{LÞsningsskisse
- 
+Â 
+Â 
+Â 
+Â \caption{Solution model
+Â 
-\end{figure}

trunk/doc/systemdoc/en/systemdocumentation.tex

@@ -8 +8 @@
-
-% Title Page
-dokumentasj
+ documentati
-\author{Redpill Linpro AS}
-
@@ -15 +15 @@
-
-\begin{abstract}
-er et utskriftssystem utviklet av Linpro AS for MÞre og Romsdal Fylkeskommune og er utgitt under betingelsene til GNU GPL versj
-LÞsningen benytter magnetkort, kortlesere og utskriftskvoter
-Alternativt for magnetkort og kortlesere kan numpad og pinkoder benyttes istedet
-Brukere forholder seg til én skriver på datamaskinen sin og kan hente utskriften sin på hvilken som helst skriver tilknyttet lÞsningen
-LÞsningen fungerer med Linux, Windows og MAC OS X og benytter seg av
+is a printing solution developed by Linpro AS for the MÞre and Romsdal county council in Norway, licensed in accordance with GNU GPL versi
+The solution is based on magnetic cards, card readers and print quotas
+Numeric keypads and pin codes can be used instead of magnetic cards and card readers
+Users send their print jobs to one generic printer, and can print the document on any printer connected to the system
+The solution supports Linux, Windows and MAC OS X, and uses
-\end{abstract}
-

trunk/doc/systemdoc/en/technical.tex

@@ -1 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\subsection{SNMP}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\begin{quotation}
-
-
-
+
+
-\end{quotation}
-
-\section{OpenLDAP}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\section{CUPS}
-\label{cups}
-
-CUPS benyttes som utskriftslÞsning i Bifrost
-Den autentiserer brukere mot LDAP og benytter spesielle backends for å behandle utskriftsjobber for å stÞtte utskriftskvoter og kÞ
-
-entisering
-entiserer brukere mot LDAP med
-krever at brukerne er tilgjengelige i UNIX-miljÞet, så nsswitch.conf må også settes opp med LDAP-stÞtte
-
-UtskriftskÞer
-Det må opprettes en utskriftskÞ for å autentisere brukere og ta i mot utskriftsjobber
-Denne kaller vi for
-Denne kÞen sender utskriftene videre til en ny kÞ, en utskriftsklasse som må opprettes og gis navnet ``followme-queue''
-Denne klassen brukes for å holde igjen utskrifter sendt fra ``followme''-kÞen
-Denne klassen skal vÊre tom, altså en klasse uten assosierte skrivere
-
- seksjon om CUPS ``route''-backend (\ref{cups-backends}) om forholdet mellom ``followme''- og ``followme-queue''-kÞene
-
-Vi må ha minst én skriver og én klasse for at Bifrost skal fungere
- tillegg må alle fysiske skrivere legges til i CUPS, med ``followme''-back
-
-
+Bifrost uses CUPS as a print solution
+CUPS authenticates users against LDAP, and uses back-ends to manage print jobs to support print quotas and queu
+
+hentication
+henticates uses against LDAP with
+requires users to be available in the UNIX environment; as a consequence nsswitch.conf must be set up with LDAP support
+
+Print queues
+You need to create a print queue to authenticates users and receive print jobs
+This queue is called
+This queue forwards the print jobs to another queue, a print class you also need to create, to cache print jobs from the ``followme'' queue
+This class is used for holding print jobs submitted from the ``followme'' queue
+This class should be empty, in other words a class with no printers associated to it
+
+e the section about CUPS ``route'' backend (\ref{cups-backends}) for more information on the relationship between the ``followme'' and ``followme-queue'' queues
+
+Bifrost requires at least one printer and one class
+n addition, all physical drivers must be included in CUPS, with ``followme'' back-
+
+-
-\label{cups-backends}
-Det er utviklet et par CUPS backends
-Den ene håndterer brukernes kvoter ved utskrift og den andre er for å sende utskrifter til vente-kÞen
+A couple of CUPS back-ends have been developed
+One of them handles user print quotas, the other submits print jobs to the ??vente-kÞen??
-
-\subsubsection{followme}
-CUPS backend-driveren ``followme'' må knyttes til \textbf{alle} skrivere som Þnskes brukt i lÞsninge
-Denne brukes for å sjekke og oppdatere brukernes kvoter når dokumentene sendes til en skriver for utskrift
-
-En skriver kan legges til på samme måte i CUPS som tidligere, men man må gå inn og endre URI-en til skriveren
-Den nye URI-en til skriveren skal vÊre på formatet
+The ``followme'' CUPS back-end driver must be assigned to \textbf{all} printers that are used by the solutio
+This driver is used for checking and updating user print quotas when documents are submitted to a printer for printing
+
+A printer can be added in CUPS in the normal way, but you need to modify the printer's URI
+The format of the new printer URI
-\begin{verbatim}
- 
+Â 
-\end{verbatim}
-
-
-
-
+
+
-
-\begin{quotation}
-VIKTIG
-På systemer som kjÞrer CUPS som \textbf{root} (som Ubuntu Gutsy) er backend-driverne ``http'', ``ipp'' og ``lpd'' normalt eid av root med rettighetene ``700''
-Det betyr at kun root kan eksekvere disse
-vil kjÞre backends som en annen bruker med mindre rettigheter, for eksempel som \textbf{lp}, hvis dette er mulig
-Det er derfor viktig at rettighetene på ``followme''-backend settes til ``700'' og eies av root, fordi den må kunne sende utskriftsjobber til andre backends, som for eksempel
-
-har ikke det samme problemet med rettigheter på filene, og CUPS kjÞres under brukeren \textbf{cupsys}
+IMPORTANT
+On systems running CUPS as \textbf{root} (e.g. Ubuntu Gutsy), the back-end drivers ``http'', ``ipp'', and ``lpd'' are normally owned by root with ``700'' rights
+This means that they can only be executed by root
+will run back-ends as an ordinary user with fewer rights, for instance as \textbf{lp}, if possible
+As a consequence, it is important that the rights on the ``followme'' back-end is set to ``700'' and owned by root, since it must be able to submit print jobs to other back-ends, such as
+
+does not have the same problem with rights, and CUPS is run under the \textbf{cupsys} user
-\end{quotation}
-
-
-\subsubsection{route}
-
-
-
-
-
+
+
+
+
-\begin{verbatim}
- 
+Â 
-\end{verbatim}
-
- dette eksempelet blir ``followme-queue''-kÞen brukt for å holde igjen utskrifter
+n this example, the ``followme-queue'' queue is used for caching print jobs
-
-\begin{quotation}
-VIKTIG
-Pakken cupsys-bsd må vÊre installert for at route-backend skal fungere
-Den avhenger av kommandoen ``lpr''
+IMPORTANT
+The cupsys-bsd packet must be installed in order for the route-backend to work
+This depends on the ``lpr'' command
-\end{quotation}
-
-
-le followme-kÞer
-Dersom man har forskjellige skrivermodeller og Þnsker mulighet for å bruke spesielle funksjoner på disse, som for eksempel duplex og stifting, så kan man installere flere followme-kÞer i CUPS og bruke skriverens egen driver, istedenfor en generell PostScript-
-
-Anbefaler at navnene på kÞene begynner med
-Her er noen eksempler på kÞer
-
- \item ``followme'' (standardkÞen
- 
- 
- 
-
-
-Bruk gjerne driver fra CUPS som passer best til printeren, slik at dere kan sette standardinnstillinger på skriveren
-
-For at IPP-klienter skal kunne bruke de nye kÞene må det legges til tilgangskontroll på disse skriverne i
-Legg til denne blokken for hver nye followme-kÞ du setter opp
-Endre verdien i ``Location'' til navnet på den nye skriveren, for eksempel
+ followme queues
+If you have different printer models and wish to use some of their special functions, for instance duplex and stapling, you can install additional followme queues in CUPS and use the printer's own driver instead of a generic PostScript 
+
+We recommend that the names of these queues start with
+Examples
+
+Â \item ``followme'' (default queue
+Â 
+Â 
+Â 
+
+
+We suggest that you use the CUPS driver that is most suitable for the printer, so that you can define the printer defaults yourself
+
+In order for IPP clients to be able to use the  new queues, you need to assign access rights to these printers in
+Add this section for every new followme queue you define
+Change the ``Location'' value to the name of the new printer, for instance
-\begin{verbatim}
-<Location /printers/followme-duplex>
- 
- 
- 
- 
+Â 
+Â 
+Â 
+Â 
-</Location>
-\end{verbatim}
-
-
-
-
+
-
-\section{Samba}
-
-Som et alternativ til IPP, som benyttes av CUPS, kan man benytte Samba til utskrift
+You can also use Samba for printing, as an alternative to IPP, which is used by CUPS
-
-\subsection{printcap}
-
-
-
-
-
-
-
+
+
+
+
+
-
-
-\subsection{Windows Vista}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-\end{itemize}
-
-\begin{quotation}
-VIKTIG
-og \textbf{--quota} kan ikke brukes samtidig, fordi begge opsjonene brukes for å endre brukerens gjeldende kvote
+IMPORTANT
+and \textbf{--quota} cannot be used simultaneously, since both options are used for change the user's current quota
-\end{quotation}
-
-
-
-
-
-
+
+
+
+
-
-\subsection{Gettext}
-Oversettelsesfilene finnes under \texttt{src/Followme/lib/Followme/I18N/} og har filendelse
-De kompilerte filene har filendelse
-
-Redigeringsprogrammet poEdit\footnote{poEdit kan brukes for å endre oversettelsesfiler. http://poedit.sourceforge.net/} er godt egnet for å redigere disse filene. Denne vil oppdatere mo-filen når po-filen lagres
+The translation files are found under \texttt{src/Followme/lib/Followme/I18N/}, with file extension
+The compiled files have file extension
+
+The poEdit\footnote{poEdit can be used for editing translation files. http://poedit.sourceforge.net/} editor is suitable for translating these files. The editor will update the mo file when the po file is stored

trunk/doc/userdoc/en/error-situations.tex

@@ -1 @@
-Feilsituasjoner
+Error situations
-
-Utskriften min kommer ikke
+My document is not printed
-
-Det kan vÊre flere grunner til at utskriften din ikke kommer. Her beskrives de mest aktuelle. Dersom du fortsatt har problemer, vennligst ta kontakt med din system
+The most common causes for documents not being printed are described below. If you still have problems producing the printed document, please contact your system 
-
-
-Kortet ditt ble lest feil
+Your card was not read correctly
-
-PrÞv å dra kortet en gang til. Dersom lampa på kortleseren lyser rÞdt etter du har dratt kortet er kortet ditt blitt lest feil. PrÞv derfor å dra kortet saktere igjennom kortleseren og pass på at hele kortet blitt dratt igjennom leseren
+Try swiping the card again. The card reader light will be red if the card is not read correctly. Try swiping the card more slowly through the card reader, and make sure the whole card is read
-
-Kortleseren kan bare lese magnetstripe på den ene siden av kortet. PrÞv derfor å snu kortet, og dra det igjen
+The card reader can only read the magnetic field on one side of the card. Try swiping the card the other way.
-
-
-Ingen utskriftsjobber
+No print jobs
-
-Er du sikker på at du har skrevet ut noen dokumenter til ``followme''-kÞen? Utskriftsjobber som er eldre enn en viss tid vil bli fjernet. Denne tiden vil normalt vÊre satt til 7 timer. ForhÞr deg med administrasjonen om hvor lenge denne tiden er satt
+Are you sure you have submitted documents to the ``followme'' queue? Print jobs are automatically deleted by the system if they have remained in the followme queue for a while, e.g. 7 hours. Ask your system administrator about the time limit for print jobs
-
-
-kke nok kvote igjen
+nsufficient quota
-
-benytter et kvotesystem som gir brukerne en bestemt mengde utskriftskvote. Dersom du ikke har nok utskriftskvote igjen for dokumentet du har skrevet ut, vil ikke dokumentet bli skrevet ut. Du vil motta en e-post om dette
+uses a quota system to restrict the number of print jobs allowed for each user. If your remaining quota is insufficient for the document you wanted to print, it will not be printed. An e-mail message is submitted to users who run out of print quotas

trunk/doc/userdoc/en/introduction.tex

@@ -1 @@
-Innledning
+About Bifrost
-
-er navnet på utskriftssystemet utviklet av
+is the name of the printing solution developed by
-
+\section{Introduction}
-
-
+
+
+
-
-
-
-
+
+
-
-
-
-
-
+
-
-
+
+
-
-
-
+
-
-
-
+
-
-
-
-
-
-
+
+

trunk/doc/userdoc/en/printer-setup.tex

@@ -1 @@
-Skriveroppsett
-
-
-
-MÃ¥ten man legger til skriveren er forskjellig avhengig av ditt valg av operativsystem
-
-
-Adresse til utskriftskÞ
+Printer setup
+
+
+
+Your operating system will determine your method for adding a printer
+
+
+Print queue address
-\label{sec:address-followme-queue}
-
-
+
-
-\begin{verbatim}
- ipp://<brukernavn>:<pass
+Â ipp://<username>:<passw
-\end{verbatim}
-
-Bytt ut \textbf{<brukernavn>} og \textbf{<passord>} med ditt eget brukernavn og passord. Bytt så ut \textbf{<server>} med adressen til utskriftstjeneren. HÞr med din systemadministrator om korrekt adresse til denne tjeneren
-
-Adressen som benyttes på Windows-maskiner ser noe annerledes ut, da et annet portnummer enn 631 må benyttes for å tvinge fram bruk av SSL for kryptering
-
-
-Oppsett på Windows
-
-På Windows legger man til skriveren med IPP. Dette krever at man kobler til serveren med SSL/TLS-stÞtte aktive
-
-
-Konfigurasj
+Replace \textbf{<username>} and \textbf{<password>} with your own user name and password. Replace \textbf{<server>} with the print server address - your system administrator may be able to supply one
+
+The address used on Windows computers looks slightly different; a different port number must be used to enforce SSL for encryption
+
+
+Windows setup
+
+On Windows computers, you add the printer using IPP. This requires a connecting to the server with activated SSL/TLS suppo
+
+
+Configurati
-
-\begin{enumerate}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\end{enumerate}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
-
-\begin{quote}
- OBS: Mac OS X 10.5 skal tilsynelatende stÞtte IPP med vising av dialogboks for autentisering
+Â NOTE: Mac OS X 10.5 is reported to support IPP with an authentication dialog box
-\end{quote}
-
-
-Oppsett på Linux
-
-På Linux er det forskjellige måter å legge til skriveren på. Den stÞtter skrivere koblet til over både Samba og IPP, men vi velger å gå
-
-Verken Gnome og KDE vil vise en dialogboks hvor du kan skrive inn ditt brukernavn og passord, så i Linux må du fÞre inn brukernavnet og passordet ditt i adressen til skriveren. Både Gnome og KDE har grafiske veivisere for å legge til skrivere. (Noen distribusjoner vil kunne vise deg dialogboks for brukernavn og passord, men våre tester feilet på dette området
-
-a kommandolinj
-
-Dersom du er kjent med Linux kan du selv legge til skriveren fra terminalen med kommandoen lpadmin
+Linux setup
+
+On Linux, there are a number of ways of adding a printer. Both Samba and IPP connection is supported, but we have decided to go
+
+Neither Gnome nor KDE will display a dialog box to enter your user name and password; in Linux you need to include your user name and password in the printer address. Both Gnome and KDE offer a graphical interface for adding printers. (Some distributions may be able to show you a dialog box for user name and password, but our tests were unsuccessful
+
+om command lin
+
+If you are familiar with Linux, you will be able to add the printer from the terminal, using the lpadmin command
-
-\begin{verbatim}
-# lpadmin -p followme -E \
-brukernavn:pass
+username:passw
-\end{verbatim}
-
-
-
-
-
-
-
+
+
+
+
+
-
-\begin{enumerate}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-\end{enumerate}
-
-
-
-
-
-
+
+
+
+
-
-\begin{enumerate}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-\begin{quote}
- OBS: Det kan ta litt tid fÞr listen over drivere blir lastet ferdig
+Â NOTE: The listing of drivers may take a little time
-\end{quote}
-
-
-
-
-  Klikk neste til du kommer til et skjema for å skrive inn navn på skriveren. Klikk så neste. Klikk til slutt ``Ferdig''
+
+
+Â  Click Next until a form prompts you for the printer name. Click next. Finally, click ``Ferdig'' ??Done? Finished? Complete??
-
-\end{enumerate}
@@ -227 +206 @@
-
-
-e skriveroppsett
-
-Du kan teste skriveroppsettet ditt ved å skrive ut et dokument på den nyopprettede skriveren. Deretter går du til web-grensesnittet (se kapittel \ref{webinterface}) til Bifrost og logger inn med samme brukernavn og passord som du brukte da du la til skriveren
-
-Dersom utskriften var vellykket skal du se en utskrift i listen under informasjon om brukerkontoen din. Dersom du ikke Þnsker å skrive ut dette dokumentet kan du kansellere utskriften her
+ printer setup
+
+You can test your printer setup by printing a document on the printer you have created. Next, log on to the Bifrost web interface (see the \ref{webinterface} chapter) with the same user name and password you used for adding the printer
+
+If the printing is successful, a printout item will be displayed in your user account information list. If you do not wish to print the document, simply cancel the print job

trunk/doc/userdoc/en/userdocumentation.tex

@@ -8 +8 @@
-
-% Title Page
-Brukerdokumentasj
+User documentati
-\author{Redpill Linpro AS}
-
@@ -15 +15 @@
-
-\begin{abstract}
-er et utskriftssystem utviklet av Linpro AS for MÞre og Romsdal Fylkeskommune og er utgitt under betingelsene til GNU GPL versj
-LÞsningen benytter magnetkort, kortlesere og utskriftskvoter
-Alternativt for magnetkort og kortlesere kan numpad og pinkoder benyttes istedet
-Brukere forholder seg til én skriver på datamaskinen sin og kan hente utskriften sin på hvilken som helst skriver tilknyttet lÞsningen
-LÞsningen fungerer med Linux, Windows og MAC OS X og benytter seg av
+is a printing solution developed by Linpro AS for the MÞre and Romsdal county council in Norway, licensed in accordance with GNU GPL versi
+The solution is based on magnetic cards, card readers and print quotas
+Numeric keypads and pin codes can be used instead of magnetic cards and card readers
+Users send their print jobs to one generic printer, and can print the document on any printer connected to the system
+The solution supports Linux, Windows and MAC OS X, and uses
-\end{abstract}
-

trunk/doc/userdoc/en/webinterface.tex

@@ -1 @@
-grensesnitt
+ interface
-\label{webinterface}
-
-Det er et webgrensesnitt for administrasjonen og brukerne av Bifrost
+This is a web interface for Bifrost administrators and users
-
-Innlogging
+Log-in
-
-Fordi administratorbrukere og vanlige brukere er lagret i forskjellige grener i LDAP-databasen, og dette brukes for å skille deres roller, har administrasjonsbrukere en egen innloggingsside. Vanlige brukere logger inn på adressen \textbf{/login/}, mens administrasjonsbrukere logger inn på
-Det ligger også en link mellom disse to sidene under webskjemaet for innlogging
+Since administrator users and ordinary users are stored in separate branches of the LDAP database, in order to separate their roles, administrator users have their own log-in page. Ordinary users log on to \textbf{/login/}, whereas administrator users use
+There is a link between these pages in the log-in web form
-
-
-Brukere
+Users
-
-Under menyvalget ``Brukerstatus'' ser du informasjon om brukerkontoen din og hvor mye utskriftskvote du har igjen. I tillegg ser du en oversikt over utskriftsjobber som ligger i followme-kÞen, som venter på å bli skrevet ut
+The ``User status'' menu option displays information about your user account, including your remaining print quota. You'll also see an overview of print jobs in the followme queue, waiting to be printed
-
-
-Utskriftsjobber
+Print jobs
-
-Alle dokumenter du har skrevet ut på din datamaskin vises i en liste. Du har her mulighet til å kansellere de jobbene du ikke Þnsker skrevet ut
+Lists all documents you have sent to the print queue from your computer. You can cancel any jobs you do not wish to print after all
-
-
-
-sjon
+tors
-
-Brukere med administratorrettigheter har mulighet til å administrere kvoter, kort og kortlesere
+Users with administrator access rights can manage quotas, cards and card readers
-
-
-Kortlesere
+Card readers
-
-En kortleser identifiseres med sin MAC-adresse\footnote{En MAC-adresse er adressen til nettverkskortet som er unikt for alle nettverksenheter} som skal vÊre skrevet på undersiden av boksene. En kortleser kan enten vÊre tilknyttet en skriver eller vÊre frigjort slik at den kan brukes for administrasjon av kor
+A card reader is identified by its MAC address\footnote{A MAC address is the address of the network card that is unique for all network units}, which you find printed on the bottom of the boxes. A card reader can either be connected to a printer or be used independently for card managemen
-
-Man kan tildele kortlesere logiske navn som kan gjÞre det enklere å identifisere og gjenkjenne kortlesere, for eksempel \textbf{Brick 1} eller \textbf{Molde Datarom - Lexmark C510} for å vise at den er koblet til en gitt skriver på et gitt sted
+You can assign logical names to card readers, in order to make it easier to identify and recognize them , for instance \textbf{Brick 1} or \textbf{Server room - Lexmark C510}, to show that it is connected to a specific printer at a specific location
-
-
-Kort
+Cards
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-ection{Brukere
+ubsection{Administrator card readers
-
-
-
+
-
-
+
+
+
+
+
-
-Utskriftskvote
+Search for a card
-
-
-
-
+
-
-Pinkoder
+Create a card
-
-
-
+
-
-
+
+
+
-
-
-ection{Språk
+ubsection{Users
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+