From 8d5f5341e1ddb08924c5496fd2f26d38b47a9876 Mon Sep 17 00:00:00 2001 From: Hristo Gatsinski Date: Thu, 27 Sep 2018 14:05:44 +0300 Subject: [PATCH] Docs: Add instructions for Fedora (#3986) * Add setup instructions for `Fedora` * Update `CONTRIBUTORS.md` --- CONTRIBUTORS.md | 1 + docs/source/getting-set-up.rst | 40 +++++++++++++++++++++++++++++----- 2 files changed, 36 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md index 7d348956f3..31cdf7d71c 100644 --- a/CONTRIBUTORS.md +++ b/CONTRIBUTORS.md @@ -84,6 +84,7 @@ see changes to this list. * Giulio Katis (Westpac) * Giuseppe Cardone (Intesa Sanpaolo) * Guy Hochstetler (R3) +* Hristo Gatsinski (Industria) * Ian Cusden (UBS) * Ian Grigg (R3) * Igor Nitto (R3) diff --git a/docs/source/getting-set-up.rst b/docs/source/getting-set-up.rst index 1ad1a71465..fe0f0f62e8 100644 --- a/docs/source/getting-set-up.rst +++ b/docs/source/getting-set-up.rst @@ -9,7 +9,7 @@ Corda uses industry-standard tools: * **IntelliJ IDEA** - supported versions **2017.x** and **2018.x** (with Kotlin plugin version |kotlin_version|) * **Git** -We also use Gradle and Kotlin, but you do not need to install them. A standalone Gradle wrapper is provided, and it +We also use Gradle and Kotlin, but you do not need to install them. A standalone Gradle wrapper is provided, and it will download the correct version of Kotlin. Please note: @@ -33,7 +33,7 @@ others to provide support. However, if you do use other tools, we'd be intereste Set-up instructions ------------------- -The instructions below will allow you to set up your development environment for running Corda and writing CorDapps. If +The instructions below will allow you to set up your development environment for running Corda and writing CorDapps. If you have any issues, please reach out on `Stack Overflow `_ or via `our Slack channels `_. @@ -45,12 +45,14 @@ The set-up instructions are available for the following platforms: * :ref:`deb-ubuntu-label` +* :ref:`fedora-label` + .. _windows-label: Windows ------- -.. warning:: If you are using a Mac or a Debian/Ubuntu machine, please follow the :ref:`mac-label` or :ref:`deb-ubuntu-label` instructions instead. +.. warning:: If you are using a Mac, Debian/Ubuntu or Fedora machine, please follow the :ref:`mac-label`, :ref:`deb-ubuntu-label` or :ref:`fedora-label` instructions instead. Java ^^^^ @@ -80,7 +82,7 @@ IntelliJ Mac --- -.. warning:: If you are using a Windows or a Debian/Ubuntu machine, please follow the :ref:`windows-label` or :ref:`deb-ubuntu-label` instructions instead. +.. warning:: If you are using a Windows, Debian/Ubuntu or Fedora machine, please follow the :ref:`windows-label`, :ref:`deb-ubuntu-label` or :ref:`fedora-label` instructions instead. Java ^^^^ @@ -102,7 +104,7 @@ IntelliJ Debian/Ubuntu ------------- -.. warning:: If you are using a Mac or a Windows machine, please follow the :ref:`mac-label` or :ref:`windows-label` instructions instead. +.. warning:: If you are using a Mac, Windows or Fedora machine, please follow the :ref:`mac-label`, :ref:`windows-label` or :ref:`fedora-label` instructions instead. These instructions were tested on Ubuntu Desktop 18.04 LTS. @@ -126,6 +128,34 @@ Jetbrains offers a pre-built snap package that allows for easy, one-step install 2. Click ``Install``, then ``View in Desktop Store``. Choose ``Ubuntu Software`` in the Launch Application window. 3. Ensure the Kotlin plugin in Intellij is updated to version |kotlin_version| +.. _fedora-label: + +Fedora +------------- + +.. warning:: If you are using a Mac, Windows or Debian/Ubuntu machine, please follow the :ref:`mac-label`, :ref:`windows-label` or :ref:`deb-ubuntu-label` instructions instead. + +These instructions were tested on Fedora 28. + +Java +^^^^ +1. Download the RPM installation file of Oracle JDK from https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html. +2. Install the package with ``rpm -ivh jdk--linux-.rpm`` or use the default software manager. +3. Choose java version by using the following command ``alternatives --config java`` +4. Verify that the JDK was installed correctly by running ``java -version`` + +Git +^^^^ +1. From the terminal, Git can be installed using dnf with the command ``sudo dnf install git`` +2. Verify that git was installed correctly by typing ``git --version`` + +IntelliJ +^^^^^^^^ +1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?platform=linux&code=IIC +2. Unpack the ``tar.gz`` file using the following command ``tar xfz ideaIC-.tar.gz -C /opt`` +3. Run IntelliJ with ``/opt/ideaIC-/bin/idea.sh`` +4. Ensure the Kotlin plugin in IntelliJ is updated to version |kotlin_version| + Next steps ----------