Downloads & Data

Download tools and source code; access data sources and services

Jars

Download Now

Licensed under the Apache License, Version 2.0.

GitHub

Download Now

Licensed under the Apache License, Version 2.0.

GS1 Server Tools and Code

By Connecting for Health | 6 March 2013

Using the apt repository

This is the preferred way, as it minimises the effort to use any of the other HDN provided code libraries. There are two steps:

  • Configure your system to use the apt repository
  • Make sure your system is up-to-date (Optional)
  • Install the packages

Configuring your system to use our apt repository

If you’ve configured your system to use the apt repository before you can skip this step.

  1. Open a terminal console (command prompt or command line) or ssh onto your chosen computer.
  2. Type curl -fsSkL http://services.developer-test.nhs.uk/repositories/hdn/hdn.sh | bash and press enter.
  3. Follow the prompts; where a password is requested, it is for the current user (you).
  4. Type apt-get update and press enter to update the system’s list of available packages.

Note: The repository is currently served over HTTP. It could be served over HTTPS, but there is not currently a certificate available for the server.

If you want to, you can as an alternative to the steps above you can download the entire repository using wget, and then set up it up locally by running hdn.sh file. Be aware that this will mean that you will not receive updates.

Make sure your system is up-to-date (Optional)

You can skip this if your system is up-to-date or you’re familiar with using apt and its finer points.

  1. Open a terminal console (command prompt or command line) or ssh onto your chosen computer.
  2. Type apt-get update and press enter to update the system’s list of available packages. (You can skip this step if you’re installing the apt repository for the first time using the instructions above).
  3. Make sure your distribution is current. Type apt-get –auto-remove –no-install-recommends –purge –yes dist-upgrade and press enter. You may receive prompts if your system is in an unstable state.

Installing the deb packages

  1. Open a terminal console (command prompt or command line) or ssh onto your chosen computer.
  2. Install the GS1 client. Type apt-get –auto-remove –no-install-recommends –purge –yes install hdn-gs1-server and press enter.

These steps will install the latest versions of these packages. If you need to install an older version, browse to http://services.developer-test.nhs.uk/repositories/hdn/precise/main/, find the version you want and then use apt-get pinning features to constrain the version. (For details, see the apt-get man pages).

Using the standalone jars

The jars are listed under a version number (VERSION below). You’ll need to know the version number of the jar you wish to download. Browse to http://services.developer-test.nhs.uk/repositories/hdn/jars/ to see the possibilities. The jar you’ll need is called hdn-gs1-server.jar.

This jar is standalone. This means that it:

  • has a manifest so you can run as just java -jar FILE_NAME.jar
  • includes all dependent jars, including third party dependencies.

Once you have downloaded the standalone jar file you want, you can run it:

java -jar hdn-gs1-server.jar

Forking and Hacking on GitHub

We’d encourage you to fork from github. The repository is at https://github.com/health-and-care-developer-network/health-and-care-developer-network. Take a look at Building to see how to get using it.