\documentclass[11pt]{article}
\usepackage{graphicx,grffile}
\usepackage[a4paper, total={6.5in, 9.5in}, includeheadfoot, left=2cm,right=2cm,top=2cm,bottom=2cm]{geometry}
\usepackage{fontspec}
\setmainfont{DejaVuSerif}
\usepackage{setspace}
\setstretch{}
\usepackage{amssymb,amsmath}
\usepackage{ifxetex,ifluatex}
\usepackage{fixltx2e} % provides \textsubscript
% color section headers
\usepackage{xcolor}
\usepackage{sectsty}
\sectionfont{\LARGE \color{red}}
\subsectionfont{\Large \color{gray}}
\usepackage[hyphens]{url}

\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
  \usepackage[T1]{fontenc}
  \usepackage[utf8]{inputenc}
\fi
% use upquote if available, for straight quotes in verbatim environments
\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
% use microtype if available
\IfFileExists{microtype.sty}{%
\usepackage{microtype}
\UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
}{}
\ifxetex
  \usepackage[setpagesize=false, % page size defined by xetex
              unicode=false, % unicode breaks when used with xetex
              xetex]{hyperref}
\else
  \usepackage[unicode=true]{hyperref}
\fi
\hypersetup{breaklinks=true,
            bookmarks=true,
            pdfauthor={Anne-Gaëlle Bergé},
            pdftitle={Installation Manual},
            colorlinks=true,
            citecolor=blue,
            urlcolor=blue,
            linkcolor=magenta,
            pdfborder={0 0 0}}
\urlstyle{same}  % don't use monospace font for urls
\usepackage{fancyhdr}
\pagenumbering{arabic}
\lhead{\itshape KER3-MAN-IHE-CA\_TESTBED-1\_04\\11/30/2018}
\chead{IHE-EUROPE}
\rhead{\itshape Installation Manual}
\lfoot{3 - Confidential (staff + partners)}
\cfoot{Approved}
\rfoot{\thepage}
\usepackage{listings}
\usepackage{longtable,booktabs}
\makeatletter
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
\def\maxheight{\ifdim\Gin@nat@height>\textheight\textheight\else\Gin@nat@height\fi}
\makeatother
% Scale images if necessary, so that they will not overflow the page
% margins by default, and it is still possible to overwrite the defaults
% using explicit options in \includegraphics[width, height, ...]{}
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setlength{\emergencystretch}{3em}  % prevent overfull lines
\providecommand{\tightlist}{%
  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
\setcounter{secnumdepth}{0}

\title {test pour le titre}

% Redefines (sub)paragraphs to behave more like sections
\ifx\paragraph\undefined\else
\let\oldparagraph\paragraph
\renewcommand{\paragraph}[1]{\oldparagraph{#1}\mbox{}}
\fi
\ifx\subparagraph\undefined\else
\let\oldsubparagraph\subparagraph
\renewcommand{\subparagraph}[1]{\oldsubparagraph{#1}\mbox{}}
\fi
% page break before new section
\let\oldsection\section
\renewcommand\section{\clearpage\oldsection}
\renewcommand{\headrulewidth}{1pt}
\renewcommand{\footrulewidth}{1pt}

\usepackage{fancyhdr}
\fancypagestyle{coverpage}{
  \lhead{}
  \chead{}
  \rhead{}
  \rfoot{}
  \cfoot{This document may not be duplicated without permission of KEREVAL}
  \lfoot{}
}

\lstset{
    basicstyle=\ttfamily,
    numbers=left,
    keywordstyle=\color[rgb]{0.13,0.29,0.53}\bfseries,
    stringstyle=\color[rgb]{0.31,0.60,0.02},
    commentstyle=\color[rgb]{0.56,0.35,0.01}\itshape,
    numberstyle=\footnotesize,
    stepnumber=1,
    numbersep=5pt,
    backgroundcolor=\color[RGB]{248,248,248},
    showspaces=false,
    showstringspaces=false,
    showtabs=false,
    tabsize=2,
    captionpos=b,
    breaklines=true,
    breakatwhitespace=true,
    breakautoindent=true,
    escapeinside={\%*}{*)},
    linewidth=\textwidth,
    basewidth=0.5em,
}


\begin{document}
%first page starts here
%\thispagestyle{coverpage}
\begin {figure}[tp]
\hbox{ %pour aligner plusieurs logos sur une même ligne
  \includegraphics[keepaspectratio, height=2cm]{../_templates/pandoc-templates/kereval-logo.png} %A REMPLACER PAR LE PATH DE TON LOGO, relative path from pandoc execution path
  \hspace*{4.8cm}  % pour mettre un espace (horizontal) de 2cm entre les deux images
  \hspace*{4.5cm}
}

\vspace{0.5cm}

KEREVAL\\
4, Rue H\'el\`ene Boucher \hfill Tel : +33 (0)2.23.20.36.64 \\
Z.A Bellevue \hfill RCS : B 442 789 210\\
35235, Thorign\'e-Fouillard \hfill APE : 722 C \\
FRANCE

\end {figure}


\title{ \begin{center} Installation Manual \\
\vspace{0.5em}
\end{center}
  \vspace{1cm}
  \hrule width 17.8cm
  \vspace{1em}
  \textit{Conformity Assessment Test environment - V2019-1}
  \vspace{1em}
  \hrule width 17.8cm
  \vspace{1em}
  IHE-EUROPE / KEREVAL IHE Dev team \\
  \vspace{1cm}
}

\author{ Version : 1.04 on 11/30/2018  \\ Written by : Anne-Gaëlle Bergé \\ \newline
    Function : Engineer \\
   Reference : KER3-MAN-IHE-CA\_TESTBED-1\_04 \\ Status : Approved
   \vspace{5cm}
   \\ \newline This document is the property of KEREVAL.
 \\ It can neither be communicated, neither copied nor distributed without authorization}


\date{\vspace{1cm}}

\maketitle

%first page ends
\pagestyle{fancy}

{
\hypersetup{linkcolor=black}
\setcounter{tocdepth}{3}
\tableofcontents
}
\subsection{Changes}\label{changes}

\begin{itemize}
\item
  \textbf{hra}: 2018-11-30 update CA VM 2019 installation manual
\item
  \textbf{aberge}: 2018-02-23 review and approved documents
\item
  \textbf{aberge}: 2017-02-23 Update CA VM release note and installation
  manual with new versions of the tools
\item
  \textbf{aberge}: 2017-02-15 fix installation and release note for CA
  VM
\item
  \textbf{aberge}: 2017-02-15 Add documentation for CA Test environment
\end{itemize}

\section{Introduction}\label{introduction}

\subsection{Purpose}\label{purpose}

The purpose of this document is to explain how to install, configure and
check the installation of the virtual machine provided by IHE Europe for
running IHE Conformity Assessment test sessions.

\subsection{Scope}\label{scope}

This document and associated Gazelle Virtual Machine are relevant to the
IHE International Conformity Assessment Scheme CAS-2.2017. It is
intended to authorized laboratories that will run a Conformity
Assessment Session.

\subsection{Virtual Machine
characteristics}\label{virtual-machine-characteristics}

\begin{longtable}[]{@{}ll@{}}
\toprule
\begin{minipage}[b]{0.16\columnwidth}\raggedright\strut
\textbf{Linux kernel}\strut
\end{minipage} & \begin{minipage}[b]{0.78\columnwidth}\raggedright\strut
3.16.0-4-amd64\strut
\end{minipage}\tabularnewline
\midrule
\endhead
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Operating System}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
Debian GNU/Linux 8.7 (jessie)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Allocated Base memory}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
22 GB (10GB are used by the JBoss servers), 8 CPUs\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Virtual machine host name}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
gazelle-cats\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Networking}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
How the virtual machine accesses the network must be configured
according to your needs and requirements. However, we recommend using a
bridge adapter.\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Main user}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
gazelle (password~: gazelle) is administrator/sudoer\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\textbf{Installed applications}\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
Oracle Java 6 (/usr/lib/jvm/java-6-oracle), Oracle Java 7
(/usr/lib/jvm/java-7-oracle), Java 8 (/usr/local/jdk1.8.0\_121),
java-1.7.0-openjdk-amd64\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
Jboss server AS 7.2.0 ~(2 instances - locations~: /usr/local/jboss7 and
/usr/local/jboss7-2)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
postgreSQL 9.6 (user~: gazelle)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
Apache 2\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
exim 4 (SMTP server)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.16\columnwidth}\raggedright\strut
\strut
\end{minipage} & \begin{minipage}[t]{0.78\columnwidth}\raggedright\strut
Tomcat8, Tomcat 7, Tomcat6\strut
\end{minipage}\tabularnewline
\bottomrule
\end{longtable}

\section{Virtual Machine installation
process}\label{virtual-machine-installation-process}

\subsection{Installation}\label{installation}

You have been providing with a link to a qcow2 (ProxMox) file to be
download and deployed in a virtualizer. If you need assistance to deploy
the testing environment in another virtualizer than ProxMox, contact the
virtual machine's provider.

\subsection{Check installation of the Virtual
machine}\label{check-installation-of-the-virtual-machine}

Once the machine is up and running, you should be able to access it in
SSH~(access with public key only):

\begin{lstlisting}[language=bash]
\#ssh gazelle@box\_ip
\end{lstlisting}

You must also be able to access the index from your favorite browser at
\textbf{http://box\_ip}.

Note that:

\begin{itemize}
\tightlist
\item
  Postgresql server is launched at startup.
\item
  Jboss servers are launched at startup (it may take a while).
\item
  Tomcat server is launched at startup
\item
  Syslog collector is launched at startup
\end{itemize}

Check the servers are correctly started by taking a look at the logs
located at /var/log/jboss7/standalone.log and
/var/log/jboss7-2/standalone.log. Accessing the home page and checking
that the version number of the tools are displayed will also tell you
that the applications are up and running.

The owner of the Jboss processes is jboss user, please do not change it
in order to allow the Jboss servers to access the directories they need.

\section{Configuration}\label{configuration}

\subsection{Applications' URLs and
OIDs}\label{applications-urls-and-oids}

The testing environment provided to you as been set up for the URL you
provided to the development team. An OID was also assigned to this
instance of the CAS testing environment. If, for any reason, you need to
update these values, a script is available and will update the URLs
and/or OIDs defined in the database to meet the new URL and/or OID
rootTo do so, follow the steps below:

\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\item
  SSH on the virtual machine
\item
  Check you are in the following directory: /home/gazelle
\item
  Edit file update\_urls.sh (vim is installed)
\item
  Update the value of BOX\_NEW\_URL, it shall match the URL your users
  will use to access the testing environment
\item
  If desired, update the value of BOX\_NEW\_OID
\item
  Save your changes
\item
  Run ./update\_urls.sh
\end{enumerate}

The script will restart the Jboss servers so that the tools will take
the changes into account.

\subsection{Port forwarding}\label{port-forwarding}

We recommend that you use a bridge to connect the virtual machine to
your LAN. However, if you rather need to perform a network address
translation (NAT), below is the list of ports which MUST be forwarded:

\begin{itemize}
\tightlist
\item
  For Gazelle Security Suite: 20007, 20009, 20011, 20070
\item
  For Patient Manager: 20055, 20056, 20057, 20058, 20059
\item
  For Syslog Collector: 10101, 10103 \# WARNING: this second port use
  UDP
\item
  For XDS Tools 2: 8443
\item
  For PCD Nist tool: 13080
\item
  For Order Manager: 20301, 20302
\item
  Apache server: 80 / (443 if you use HTTPS)
\end{itemize}

Note that those ports are displayed to the user to facilitate the
configuration of his/her system; then, it is a good practice to map the
ports with the same number.

If you use Vagrant to start the virtual machine, below is an extract of
the configuration file (as example only)

\subsection{Installation of the machine
certificate}\label{installation-of-the-machine-certificate}

In order to use HTTPS you need to install a certificate to the machine.
A certificate for a web server needs to be requested to one PKI
(letsencrypt offers free certificates).

The certificate needs to be installed and configured in apache2

The truststore of the jboss and tomcat servers need to access the
truststore containing the certificate chain to the certificate used. The
application servers installed on the machine are already configured to
access the truststore.jks file located in the directory
/opt/gazelle/cert. So updating that file with the correct chain of
certificate is enough. The password of the truststore shall be
«~password~». If you'd like to change it you will need to update the
configuration of the jboss, jboss7 and tomcat application servers
accordingly.

\section{Check access to the tools}\label{check-access-to-the-tools}

From http://your\_box\_url, you should access the following page (Apache
front-end) which lists the available applications, their links, and the
links to their user manual.

\begin{figure}
\centering
\includegraphics{./media/home_page.png}
\caption{Test environment home page}
\end{figure}

Check you have access to all the tools. When you access the tool for the
first time, the loading of the page could appear to be quite long
because Jboss is initializing the tool.

\subsection{Login}\label{login}

A CAS service has been set up and a default login has been created:

\textbf{Username}: admin

\textbf{Password}: azerty

\textbf{Role}: admin\_role

Use this user to create your own accounts (with admin\_role role at
least) and make sure you disable the admin account or change its
password.

\subsection{Jboss management}\label{jboss-management}

\emph{jboss7} can be replaced by jboss7-2 or jboss7-sts depending on the
Jboss server you need to start/stop/restart.

\begin{longtable}[]{@{}ll@{}}
\toprule
\begin{minipage}[b]{0.33\columnwidth}\raggedright\strut
\textbf{Command}\strut
\end{minipage} & \begin{minipage}[b]{0.61\columnwidth}\raggedright\strut
\textbf{Description}\strut
\end{minipage}\tabularnewline
\midrule
\endhead
\begin{minipage}[t]{0.33\columnwidth}\raggedright\strut
sudo service jboss7 start\strut
\end{minipage} & \begin{minipage}[t]{0.61\columnwidth}\raggedright\strut
Starts the Jboss7 default server (requires gazelle's password)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.33\columnwidth}\raggedright\strut
sudo service jboss7 stop\strut
\end{minipage} & \begin{minipage}[t]{0.61\columnwidth}\raggedright\strut
Kills the Jboss7 process (requires gazelle's password)\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.33\columnwidth}\raggedright\strut
sudo service jboss7 restart\strut
\end{minipage} & \begin{minipage}[t]{0.61\columnwidth}\raggedright\strut
Kills the Jboss7 server and after a while starts it again (requires
gazelle's password)\strut
\end{minipage}\tabularnewline
\bottomrule
\end{longtable}

\section{Gazelle tools}\label{gazelle-tools}

\subsection{User guides}\label{user-guides}

Documentation for the tools that are installed on the virtual machine
can be found at YOUR\_SERVER\_URL/gazelle-documentation. On the home
page, a direct link to each page of the manual is available (PDF icon).

\subsection{Included tools}\label{included-tools}

The following tools are installed on the virtual machine:

\begin{itemize}
\tightlist
\item
  \textbf{Test Management (configured to work as Test Management and
  Gazelle Master Model)} is the tool used during the connectathons. It
  embeds the test cases and the IHE concepts. Test Management also
  offers a feature to manage samples.
\item
  \textbf{Patient Manager} is a simulator which integrates the IHE
  profiles which deals with patient and encounter management (PAM,
  PDQV3, PIXV3, PIX and PDQ actors are configured)
\item
  \textbf{SVS Simulator} is a simulator for the Sharing Value Set
  profiles. It is used by the other applications of the Gazelle test bed
  as a value set repository.
\item
  \textbf{Gazelle HL7 Validator} is a validation tool for HL7v2.x
  messages (uses HL7 message profiles) and HL7v3 messages
\item
  \textbf{Assertion manager Gui} gathers the assertions extracted from
  the IHE Technical Framework
\item
  \textbf{XDSTools4} is aimed to test the systems implementing the
  XDS.b, XCA, XDS-I.b and XCA-I integration profiles
\item
  \textbf{Gazelle Security Suite} gathers features to test the ATNA
  integration profile
\item
  \textbf{Gazelle STS} is the assertion provider
\item
  \textbf{Demographic Data Server} is used to generate fake demographics
  for testing purposes
\item
  \textbf{Order Manager} offers simulators for the LAW profile
\item
  \textbf{NIST PCD tools} are dedicated to the testing of the DEC and
  PIV actors
\item
  \textbf{EVS Client} is the graphical interface to Gazelle validation
  services. It is here configured to validate the XUA assertions.
\item
  \textbf{Gazelle Webservice Tester} is used as a linker between Gazelle
  Test Management and XDSTools to manage testing sessions in XDS Tools
  and thus guarantee results privacy and multi user functioning.
\item
  \textbf{CAS} service for singe-sign-on login
\item
  \textbf{Nagios} is a service monitoring configured to check the
  availability of the tools installed in the virtual machine
\end{itemize}

The following binaries are deployed in the gazelle server of Jboss7-2:
/usr/local/jboss7-2/standalone/deployments directory.

\begin{longtable}[]{@{}llll@{}}
\toprule
\begin{minipage}[b]{0.24\columnwidth}\raggedright\strut
\textbf{Application}\strut
\end{minipage} & \begin{minipage}[b]{0.26\columnwidth}\raggedright\strut
\textbf{Binary name}\strut
\end{minipage} & \begin{minipage}[b]{0.13\columnwidth}\raggedright\strut
\textbf{version}\strut
\end{minipage} & \begin{minipage}[b]{0.24\columnwidth}\raggedright\strut
\textbf{Database}\strut
\end{minipage}\tabularnewline
\midrule
\endhead
\begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
Demographic Data Server\strut
\end{minipage} & \begin{minipage}[t]{0.26\columnwidth}\raggedright\strut
DemographicDataServer.ear\strut
\end{minipage} & \begin{minipage}[t]{0.13\columnwidth}\raggedright\strut
4.1.1\strut
\end{minipage} & \begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
demographic-data-server\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
Order Manager\strut
\end{minipage} & \begin{minipage}[t]{0.26\columnwidth}\raggedright\strut
OrderManager.ear\strut
\end{minipage} & \begin{minipage}[t]{0.13\columnwidth}\raggedright\strut
5.0.1\strut
\end{minipage} & \begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
order-manager\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
EVS Client\strut
\end{minipage} & \begin{minipage}[t]{0.26\columnwidth}\raggedright\strut
EVSClient.ear\strut
\end{minipage} & \begin{minipage}[t]{0.13\columnwidth}\raggedright\strut
5.1.2\strut
\end{minipage} & \begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
evs-client-prod\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
Gazelle STS\strut
\end{minipage} & \begin{minipage}[t]{0.26\columnwidth}\raggedright\strut
gazelle-sts-service.ear\strut
\end{minipage} & \begin{minipage}[t]{0.13\columnwidth}\raggedright\strut
1.1.2\strut
\end{minipage} & \begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
picketlink-sts\strut
\end{minipage}\tabularnewline
\begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
Gazelle Webservice Tester\strut
\end{minipage} & \begin{minipage}[t]{0.26\columnwidth}\raggedright\strut
gazelle-websesrvice-tester\strut
\end{minipage} & \begin{minipage}[t]{0.13\columnwidth}\raggedright\strut
1.4.0\strut
\end{minipage} & \begin{minipage}[t]{0.24\columnwidth}\raggedright\strut
gazelle-webservice-tester\strut
\end{minipage}\tabularnewline
\bottomrule
\end{longtable}

The following binaries are deployed in Jboss 7 server:
/usr/local/jboss7/standalone/deployment/.

\begin{longtable}[]{@{}llll@{}}
\toprule
\textbf{Application} & \textbf{Binary name} & \textbf{version} &
\textbf{Database}\tabularnewline
\midrule
\endhead
Assertion manager Gui & AssertionManagerGui.ear & 4.1.0 &
assertion-manager\tabularnewline
Test Management & gazelle-tm.ear & 5.9.3 & gazelle\tabularnewline
Patient Manager & PAMSimulator.ear & 9.10.9 &
pam-simulator\tabularnewline
SVS Simulator & SVSSimulator.ear & 2.1.4 & svs-simulator\tabularnewline
Gazelle HL7 Validator & GazelleHL7v2Validator.ear & 3.2.6 &
gazelle-hl7-validator\tabularnewline
Gazelle Security Suite & gazelle-gss.ear & 6.0.0 & gss\tabularnewline
\bottomrule
\end{longtable}

The following binarie is deployed in tomcat 7 server:
/usr/local/tomcat7/webapps/

\begin{longtable}[]{@{}llll@{}}
\toprule
\textbf{Application} & \textbf{Binary name} & \textbf{version} &
\textbf{Database}\tabularnewline
\midrule
\endhead
NIST PCD Tool & PCD-HL7WebPreCon.war & 1.6.2 &
pcdtoolcasc\tabularnewline
\bottomrule
\end{longtable}

The following binarie is deployed in tomcat 7 server:
/var/lib/tomcat8/webapps/

\begin{longtable}[]{@{}llll@{}}
\toprule
\textbf{Application} & \textbf{Binary name} & \textbf{version} &
\textbf{Database}\tabularnewline
\midrule
\endhead
XDSTools6 & xdstools6.war & 6.5.0 & NO DB\tabularnewline
\bottomrule
\end{longtable}

All the web services required by the applications are on the virtual
machine. No access will be done to Gazelle's servers.

\subsection{Monitoring of services}\label{monitoring-of-services}

The test environment is delivered with Nagios3 tool configured to check
the availability of the services available in the testbed. You will
access it from the \textbf{Nagios Monitoring} link of the home page.
Default username and password have been set to nagiosadmin/gazelle.

\subsection{Calibration}\label{calibration}

For some applications, calibration scripts have been set up. To check
the proper configuration of your environment or to check the environment
is calibrated, you can access the administration page at
YOUR\_SERVER\_URL/admin.php. Details on how it works are given at
YOUR\_SERVER\_URL/gazelle-documentation/Gazelle-Calibration/user.html.

\section{Reporting a problem}\label{reporting-a-problem}

A helpdesk is dedicated to IHE authorized laboratories. Report any issue
you might encountered in
\href{https://gazelle.ihe.net/jira/servicedesk/customer/portal/22}{Jira}.

\section{Backups}\label{backups}

The backup of the databases (and ONLY the databases) is performed
automatically. In the home directory of gazelle (/home/gazelle) there is
a folder called backup. In that folder there is a script called
backup.sh which is executed once a day thanks to a cron

\begin{lstlisting}
@daily /home/gazelle/backup/backup.sh
\end{lstlisting}

We use then logrotate in order to keep:

\begin{itemize}
\tightlist
\item
  a back up for the last 7 days
\item
  a back up for the last 4 weeks
\item
  a back up for the last 12 months
\end{itemize}

For each database we create

\begin{itemize}
\tightlist
\item
  a dump,
\item
  a SQL dump of the definition,
\item
  a SQL dump of the data
\end{itemize}

\section{Running a conformity assessment testing
session}\label{running-a-conformity-assessment-testing-session}

A number of pre-requisites are given below which will help the testing
session manager to conduct correctly a conformity assessment testing
session.

\subsection{Testing session
definition}\label{testing-session-definition}

The virtual machine is provided with a testing session entitled ``Defaut
CA Testing Session''; this includes all you need to run a session. If
you need to create a new testing session, make sure that, when you
define this new testing session, you include the list of integration
profile to be tested. You shall also select ``certification'' as testing
session type; this will allow the participants to see the tests defined
for conformity assessment.

\subsection{Testing tools}\label{testing-tools}

Conformity assessment testing is run against tools, some of them have to
be declared as such in Gazelle Test Management.

The ``Defaut CA Testing Session'' session includes those tools. To
import them into a newly created testing session, you need to

\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
  Go to Administration \textgreater{} Manage \textgreater{} Systems
  \textgreater{} System Management
\item
  Click on ``Import systems from a previous testing session''
\item
  Select company with keyword = IHE
\item
  Select the tools to import
\item
  Click on Import
\end{enumerate}

\subsection{System acceptance}\label{system-acceptance}

To allow the SUT operator to see the tests to be performed for his/her
system, you need to accept it in the testing session. To do so, go to
Administration \textgreater{} Manage \textgreater{} Systems
\textgreater{} System acceptance and hit the checkbox for the systems to
be included in this testing session.

\end{document}
