Skip to content

Latest commit

 

History

History
42 lines (26 loc) · 2.2 KB

BUILD.md

File metadata and controls

42 lines (26 loc) · 2.2 KB
Raw

Building X-Road

Running the X-Road software requires Linux (Ubuntu or RHEL). As a development environment, only Ubuntu (>=14.04, 16.04 recommended) is currently supported. It should be possible to use some other Linux distribution for development, but the instructions and helper scripts assume Ubuntu. If you are using some other operating system (e.g. Windows or macOS), the easiest option is to first install Ubuntu 16.04 into a virtual machine (e.g. by using the provided Vagrantfile).

Tools

Required for building

  • OpenJDK / JDK version 8
  • Gradle
  • JRuby and rvm (ruby version manager)
  • GCC

Recommended for development environment

  • Docker (for deb/rpm packaging)
  • LXD (https://linuxcontainers.org/lxd/)
    • for setting up a local X-Road instance
  • Ansible
    • for automating the X-Road instance installation

The development environment should have at least 8GB of memory and 20GB of free disk space (applies to a virtual machine as well), especially if you set up a local X-Road instance.

Dependency installation and building instructions

  • Requires Ubuntu >=14.04, 16.04 is recommended.

  • Execute the following command once to install the required dependencies on a clean building host. The script is supposed to be run as the user who will build the source. The script will ask for user password (using sudo) for installing some new packages as well.

    ./prepare_buildhost.sh

    Note. On Ubuntu 16.04 or newer the script installs Docker (docker.io) for building .deb and .rpm packages. On Ubuntu 14.04 or if you want to use Docker CE, install Docker manually (https://docs.docker.com/install/linux/docker-ce/ubuntu/) before running this script.

  • Update/install Ruby dependencies. It's needed only on first build or in case the change log states so.

    ./update_ruby_dependencies.sh

  • Build the software and installation packages:

    ./build_packages.sh

    If Docker is installed, the script will build the .deb and .rpm packages in a Docker container. If Docker is not installed, only .deb packages will be built.

Once you have successfully built the software, please see ansible/README.md for local installation instructions.