Metro server installation

From MeLibraries Wiki
Revision as of 09:29, 11 April 2019 by Eplils (Talk | contribs) (Windows)

Jump to: navigation, search

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 [] 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.


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.


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.