hans@926: \subsection{Artifact-Server} hans@926: The Artifact-Server contains the entire business logic of the system. hans@926: The server provides a RESTful interface with a XML-based protocol to the hans@926: webclient. Technically the server is a standalone java process serving the hans@926: REST interface. hans@926: hans@926: \subsubsection*{Installation} hans@926: \label{ref:artifact-server-install} hans@926: hans@926: Running the server with its own user\footnote{Remark: A group with the hans@926: same name is created automatically.}: hans@926: \begin{lstlisting} hans@926: adduser artifacts hans@926: \end{lstlisting} hans@926: hans@926: Setup and configuring logging: hans@926: \begin{lstlisting} hans@926: cd /var/log hans@926: mkdir artifacts hans@926: chmod 770 artifacts hans@926: chmod g+s artifacts hans@926: \end{lstlisting} hans@926: hans@926: The log level can be adjusted in the file \verb+ conf/log4j.properties+. hans@926: Further information can be found there. hans@926: hans@926: Integrate software of artifact-server into filesystem: hans@926: \begin{lstlisting} hans@926: cd /opt hans@926: tar xfvj /root/artifact-server-$VERSION.tar.bz2 hans@926: ln -s artifact-server-$VERSION artifact-server hans@926: cd artifact-server hans@926: \end{lstlisting} hans@926: hans@926: Setting the access rights: hans@926: \begin{lstlisting} hans@926: bin/setup.sh hans@926: \end{lstlisting} hans@926: hans@926: Configure connection to database: hans@926: \begin{lstlisting} hans@926: cd /opt/artifact-server hans@926: vim conf/arcsdeconnectionpool.properties hans@926: hans@926: # in conf/arcsdeconnectionpool.properties do: hans@926: server=xyz.server.com hans@926: username=guest hans@926: credentials=XYZ hans@926: port=5151 hans@926: database=esri_sde hans@926: \end{lstlisting} hans@926: hans@926: Configure address for finding the WMS-Server: hans@926: \begin{lstlisting} hans@926: cd /opt/artifact-server/ hans@926: vim conf/conf.xml hans@926: # adapt the address in the element hans@926: # artifact-database/gnv/mapserver/server. This is hans@926: # the string the server uses to provide an address of the mapserver to enduser. hans@928: e.g. http://SERVER/cgi-bin/gnv-wms hans@926: \end{lstlisting} hans@926: hans@926: The artifact server can export and import projects of the user's hans@926: parameterizations. In order to protect the server against invalid files, hans@926: configure a secret for signing artifacts. hans@926: hans@926: {\em Hint: If the secret is changed, all files that were created before hans@926: are not valid anymore.} hans@926: hans@926: \begin{lstlisting} hans@926: # generate a randomized string, e.g. hans@926: cd /opt/artifact-server/ hans@926: pwgen -s 30 hans@926: # populate the tag artifact-database/export-secret hans@926: \end{lstlisting} hans@926: hans@926: Adapt TCP-port of artifact-server, if the default has to be changed hans@926: (default:8181): hans@926: \begin{lstlisting} hans@926: cd /opt/artifact-server hans@926: vim conf/conf.xml hans@926: hans@926: # in conf/conf.xml edit the element artifact-database/rest-server/port hans@926: \end{lstlisting} hans@926: hans@926: Integrate artifact-server in startup-process of operating system: hans@926: \begin{lstlisting} hans@926: cp -i /opt/artifact-server/bin/debian/artifact-server /etc/init.d/ hans@926: chmod +x /etc/init.d/artifact-server hans@926: update-rc.d artifact-server defaults hans@926: \end{lstlisting} hans@926: hans@926: The server can be started and stopped via hans@926: \begin{lstlisting} hans@926: /etc/init.d/artifact-server {start | stop} hans@926: \end{lstlisting} hans@926: hans@926: The installation of the artifact-server is finished. It can be tested hans@926: now. hans@926: hans@926: \subsubsection*{Test of the Installation} hans@926: \label{ref:artifact-server-testing} hans@926: Start the server: hans@926: \begin{lstlisting} hans@926: /etc/init.d/artifact-server start hans@926: \end{lstlisting} hans@926: hans@926: 1. Operating System: Check if the process of the server called "App" hans@926: is running: hans@926: \begin{lstlisting} hans@926: jps hans@926: hans@926: # Example with list of java processes: hans@926: 19252 hans@926: 19509 Jps hans@926: 19441 App hans@926: hans@926: cat /var/run/artifact-server hans@926: \end{lstlisting} hans@926: hans@926: Task: Compare the running process numbers. hans@926: hans@926: 2. Network: Check if the artifact-server opens a TCP-port (default: 8181) hans@926: \begin{lstlisting} hans@926: netstat -nltp hans@926: hans@926: # Check for an entry like: hans@926: tcp 0 0 127.0.0.1:8181 0.0.0.0:* LISTEN 18648/java hans@926: \end{lstlisting} hans@926: hans@926: 3. Artifact-Server ready for communication with client? hans@926: \begin{lstlisting} hans@926: curl "http://localhost:8181/factories" | xmllint --format - hans@926: \end{lstlisting} hans@926: hans@926: Task: Check for a XML-document describing possible expert information hans@926: systems (FIS)