Difference between revisions of "Metro server installation"

From MeLibraries Wiki
Jump to: navigation, search
(Unix variants)
(Installation)
Line 21: Line 21:
 
=== Installation ===
 
=== Installation ===
 
Read the [https://commons.apache.org/proper/commons-daemon/jsvc.html jsvc] page to install on Unix. Once done the daemon can be started:
 
Read the [https://commons.apache.org/proper/commons-daemon/jsvc.html jsvc] page to install on Unix. Once done the daemon can be started:
  jsvc.exec -home /usr/lib/jvm/default-java -cp /home/its/metro/dist/lib/commons-daemon-1.0.15.jar:/home/its/metro/dist/MeCard.jar -user its -outfile /home/its/metro/logs/metro.out -errfile /home/its/metro/logs/metro.err -pidfile /home/its/metro/logs/metro.pid mecard.MetroService -c /home/its/metro/config
+
  jsvc.exec -home /usr/lib/jvm/default-java -cp /home/its/metro/dist/lib/commons-daemon-1.0.15.jar:/home/its/metro/dist/MeCard.jar  
 +
-user its -outfile /home/its/metro/logs/metro.out -errfile /home/its/metro/logs/metro.err  
 +
-pidfile /home/its/metro/logs/metro.pid mecard.MetroService -c /home/its/metro/config

Revision as of 10:48, 11 April 2019

The Metro service and be installed on hardware, a VM, or even a Docker instance, though to date, no one has done that. The server is dependent on Java in all cases. Specific dependencies are discussed in the Windows or Unix section. Because MeCard.jar is a Java application and so will work on both 32 and 64 bit OSes without change, but the supporting daemon/service support application needs to match the OS.

General notes

The Metro server is a Java application, or appliance that manages the communication between [https://melibraries.ca] and your library's ILS. There are a number of supporting libraries that are shipped with the MeCard.jar file that manage command line arguments, JDBC connections, the Daemon service etc. Some are not required for all sites but all are shipped for simplicity.

  • commons-cli-1.2.jar - included for reading and interpreted to
  • gson-2.2.4.jar - included for possible web services use.
  • commons-codec-1.8.jar - included for possible web services use.
  • fluent-hc-4.3.4.jar - included for possible web services use.
  • httpcore-4.3.2.jar - included for possible web services use.
  • sqljdbc42.jar - included for Horizon and Polaris sites.
  • commons-daemon-1.1.0.jar - used for running the MeCard.jar as a daemon on Unix or a service on Windows.

Windows

There are several batch files used to install the Metro service. They are simple and use Apache's prunsrv.exe, 32 or 64 bit depending on whether you are using a 32 or 64 bit version of Windows. For more information see here for examples.

Installation

There is an installation exe that does install the Metro server (MeCard.jar) on Windows. It was created by Inno Setup compiler.

Unix variants

On Unix, the daemon is jsvc, which should be installed on the host metro server machine.

Installation

Read the jsvc page to install on Unix. Once done the daemon can be started:

jsvc.exec -home /usr/lib/jvm/default-java -cp /home/its/metro/dist/lib/commons-daemon-1.0.15.jar:/home/its/metro/dist/MeCard.jar 
-user its -outfile /home/its/metro/logs/metro.out -errfile /home/its/metro/logs/metro.err 
-pidfile /home/its/metro/logs/metro.pid mecard.MetroService -c /home/its/metro/config