diff --git a/data/surf-display.tex b/data/surf-display.tex new file mode 100644 index 0000000..781e9fc --- /dev/null +++ b/data/surf-display.tex @@ -0,0 +1,227 @@ +\documentclass[english,smaller,t]{beamer} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage[right]{eurosym} +\usepackage{lmodern} + +\newcommand{\noun}[1]{\textsc{#1}} + +\usepackage[english]{babel} +\usepackage[babel]{csquotes} +\MakeAutoQuote{»}{«} + +\pdfimageresolution150 +\def\EUR{\,\euro} + +%\usepackage{beamerthemesplit} +%\usetheme{Warsaw} +%\usetheme{Berkeley} +%\usetheme{Marburg} +%\usetheme{Goettingen} +%\usetheme{AnnArbor} +\usetheme{PaloAlto} +%\usecolortheme{beaver} +%\usecolortheme{dolphin} +\usecolortheme{wolverine} +\beamertemplatenumberedsquaresectiontoc +\beamertemplatetransparentcovered + +\title[Surf Kiosk Display]{Surf Kiosk Display HowTo (v0.0.2)} +\institute[Debian Edu]{Debian Edu Dev Team} +\author[Debian Edu \\ Dev Team]{Mike Gabriel \\ Daniel Teichmann \\ Benjamin Schlüter \\ and others} +\date{Mar 2017} + +\begin{document} + +\frame{\titlepage} +%\frame{\tableofcontents} + +\section[About]{About Surf Kiosk Display} + +\frame[label=about] +{ + \frametitle{About Surf Kiosk Display} + \framesubtitle{What can I use Surf Kiosk Display for?} + + \begin{beamerboxesrounded}[shadow=true]{Setup WWW Presentation Screens or Info Terminals} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemA \textbf{Surf Kiosk Display} can be used to \textbf{provide controlled public internet access} while running in KIOSK mode \textbf{for passerbys and visitors} + \itemAt schools for example, it can be used to enable \textbf{students and visitors} to search the school homepage or research something for \textbf{classes} + \itemAt theaters or other venues, you can provide access to \textbf{a pre-configured set of websites} to e.g. make the \textbf{schedule for the next show} available + \itemSurf Kiosk Display has been \textbf{designed for easy and secure access} to websites and web based information + \end{itemize} + } + \end{beamerboxesrounded} +} + +\frame[label=extend] +{ + \frametitle{About Surf Kiosk Display} + \framesubtitle{How can I extend Surf Kiosk Display?} + + \begin{beamerboxesrounded}[shadow=true]{Combine Surf Kiosk Display with other FLOSS Components} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemCombine Surf Kiosk Display \textbf{with a display manager} (such as NoDM or LightDM) \textbf{that allows passwordless user login} + \itemCombine it with a \textbf{PXE booted diskless system} such as LTSP for \textbf{deploying a farm of info displays} at your location + \itemCombine with Xephyr (a \textbf{nested Xserver}) \textbf{while testing / preparing your setup} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\frame[label=howitworks] +{ + \frametitle{About Surf Kiosk Display} + \framesubtitle{How does it work?} + + \begin{beamerboxesrounded}[shadow=true]{Surf Kiosk Display runs as an X11 session manager} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \item\textbf{Surf Kiosk Display} registers itself as an available \textbf{X session manager}. Make it the default (or the only session manager installed) + \itemFeed it with an \textbf{entry WWW\_URI}. \textbf{Configure URL\_BLOCKLIST} to prevent the user from browsing unwanted sites. + \itemSurf Kiosk Display supports \textbf{host-specific configuration parameters}; you can run \textbf{various displays} presenting different WWW content \textbf{based on the same configuration} set + \end{itemize} + } + \end{beamerboxesrounded} +} + + +\section[Installation]{Installation} + +\frame[label=debinstall] +{ + \frametitle{Installation\,\ldots} + \framesubtitle{\ldots\,on a standalone Debian-like system.} + + \begin{beamerboxesrounded}[shadow=true]{Installation: Debian GNU/Linux (and alike)} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \item\textbf{Install a minimal} Debian (or derivative) \textbf{system without X11} / Graphical Login Manager + \itemInstall Surf Kiosk Display and NoDM: \\ \small \texttt{apt-get install surf-display nodm} + \item\textbf{Edit \texttt{/etc/default/nodm}}, set \texttt{NODM\_ENABLED=true} and \texttt{NODM\_USER=surf-display}. Create this user as a system user. + \item\textbf{Check that \texttt{surf-display} is the default X session manager}: \\ \small \texttt{update-alternatives \hbox{-}\hbox{-}config x-session-manager} + \item\textbf{Start NoDM}: \small \texttt{sudo invoke-rc.d nodm start} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\frame[label=rpminstall] +{ + \frametitle{Installation\,\ldots} + \framesubtitle{\ldots\,on a standalone RPM-based system.} + + \begin{beamerboxesrounded}[shadow=true]{Installation on Fedora, openSUSE or similar} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemThe \textbf{Surf Kiosk Display} tool \textbf{has not been packaged for the RPM world} + \item\textbf{Please} contact distribution maintainers and \textbf{request packaging} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\frame[label=ltspchroot] +{ + \frametitle{Installation\,\ldots} + \framesubtitle{\ldots\,in an LTSP chroot.} + + \begin{beamerboxesrounded}[shadow=true]{Install LTSP based info screen farm running Surf Kiosk Display} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemCreate a \textbf{minimal LTSP chroot}, uninstall or \textbf{disable the LTSP Display Manager} (aka LDM) + \item\textbf{Make} the LTSP \textbf{chroot bootable over PXE}: the system should boot into a text-based logon screen + \itemAll LTSP \textbf{client systems must have a dedicated hostnames} after PXE boot + \itemApply \textbf{installation steps for standalone hosts to} the LTSP \textbf{chroot} + \item\textbf{Set host-specific parameters} like standard WWW URI, display resolution, etc. via the \texttt{\$\{DISPLAYS[@]\}} associative array, \textbf{for examples see:} \\ \small \texttt{/etc/default/surf-display} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\section[Configuration]{Configuration} + +\frame[label=systemconfig] +{ + \frametitle{Configuration\,\ldots} + \framesubtitle{\ldots system-wide} + + \begin{beamerboxesrounded}[shadow=true]{Configure Surf Kiosk Display -- system-wide} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemThe \textbf{system-wide configuration} of Surf Kiosk Display is done \textbf{in \texttt{/etc/default/surf-display}} + \itemYou can \textbf{adapt various parameters}: + \begin{itemize} + \item\textbf{Basic options}:Pulseaudio support, uncluttering of the pointer device, screensaver options, slide transition options, etc. + \item\textbf{Default parameters}: Specific WWW URI, Blocklist with forbidden WWW URIs, display resolution + \end{itemize} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\frame[label=userconfig] +{ + \frametitle{Configuration\,\ldots} + \framesubtitle{\ldots on a per-user basis} + + \begin{beamerboxesrounded}[shadow=true]{Configure Surf Kiosk Display -- on a per-user basis} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemThe \textbf{per-user configuration} of Surf Kiosk Display is done \textbf{in \texttt{\$HOME/.surf-display/config}} + \itemAll \textbf{system-wide parameters can be overriden by the user} + \end{itemize} + } + \end{beamerboxesrounded} +} +\section[Testing]{Testing your Setup} + +\frame[label=testing] +{ + \frametitle{Testing Surf Kiosk Display\,\ldots} + \framesubtitle{\ldots using a nested Xserver} + + \begin{beamerboxesrounded}[shadow=true]{Testing your Setup} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \item\textbf{Install Surf Kiosk Display} locally \textbf{on your PC or notebook}; you can launch Surf Kiosk Display under your normal user account + \item\textbf{Use FAKE\_HOSTNAME variable to simulate a specifc display host} when testing infoscreen farm setups + \itemDo a \textbf{graphical login with your normal user} account; when logged in, open two Terminal windows + \itemTerminal 1: \textbf{Launch} a nested Xserver (like \textbf{Xephyr}): \\ \small \texttt{Xephyr -screen 1024x768 -ac :1} + \itemTerminal 2, also under your normal user account: \\ \small \texttt{export DISPLAY=:1 \\ FAKE\_HOSTNAME= surf-display} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\section[Authors]{Authors and Contributors} + +\frame[label=label] +{ + \frametitle{Authors, Contributors \& Sponsors} + + \begin{beamerboxesrounded}[shadow=true]{Authors \& Contributors} + + \parbox[t][2.4in][t]{3.5in}{ + \begin{itemize} + \itemAuthors (and copyright holders): \\ \ \ \ \ Mike Gabriel \\ \ \ \ \ Daniel Teichmann \\ \ \ \ \ Benjamin Schlüter +% \itemOther contributors: \\ none, so far\,\ldots + \itemDevelopment sponsored by: \\ \ \ \ \ Katharineum zu Lübeck (Germany) \\ \ \ \ \ Fritz-Reuter-Schule Eckernförde (Germany) \\ \ \ \ \ Ernst-Barlach-Gymnasium Kiel (Germany) + \itemUpstream code: \\ \ \ \ \ \scriptsize \url{https://code.it-zukunft-schule.de/cgit/surf-display/} + \end{itemize} + } + \end{beamerboxesrounded} +} + +\end{document}