Difference between revisions of "Metro server installation"

From MeLibraries Wiki
Jump to: navigation, search
(Unix variants)
Line 1: Line 1:
 +
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 <code>MeCard.jar</code> 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 ==
 
== General notes ==
 
The Metro server is a Java application, or appliance that manages the communication between [[https://melibraries.ca https://melibraries.ca]] and your library's ILS. There are a number of supporting libraries that are shipped with the <code>MeCard.jar</code> 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.  
 
The Metro server is a Java application, or appliance that manages the communication between [[https://melibraries.ca https://melibraries.ca]] and your library's ILS. There are a number of supporting libraries that are shipped with the <code>MeCard.jar</code> 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.  
Line 10: Line 12:
  
 
== Windows ==
 
== Windows ==
There are several batch files used to install the Metro service. They are simple and use [https://commons.apache.org/proper/commons-daemon/procrun.html Apache's <code>prunsrv.exe</code>], 32 or 64 bit depending on whether you are using a 32 or 64 bit version of Windows. For more information [https://support.google.com/gsa/answer/6316721?hl=en see here for examples].
+
There are several batch files used to install the Metro service. They are simple and use [https://commons.apache.org/proper/commons-daemon/procrun.html Apache's <code>prunsrv.exe</code>], 32 or 64 bit depending on whether you are using a 32 or 64 bit version of Windows. For more information [https://support.google.com/gsa/answer/6316721?hl=en see here for examples].  
  
 
== Unix variants ==
 
== Unix variants ==
 
On Unix, the daemon is [https://commons.apache.org/proper/commons-daemon/jsvc.html jsvc], which should be installed on the host metro server machine.
 
On Unix, the daemon is [https://commons.apache.org/proper/commons-daemon/jsvc.html jsvc], which should be installed on the host metro server machine.

Revision as of 10:26, 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.

Unix variants

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