github.com/Hnampk/fabric@v2.1.1+incompatible/docs/source/prereqs.rst (about)

     1  Prerequisites
     2  =============
     3  
     4  Before you begin, you should confirm that you have installed all the prerequisites below on the platform where you will be running Hyperledger Fabric.
     5  
     6  .. note:: These prerequisites are recommended for Fabric users. If you are a Fabric developer you should refer to the instructions for :doc:`dev-setup/devenv`.
     7  
     8  Install Git
     9  -----------
    10  Download the latest version of `git
    11  <https://git-scm.com/downloads>`_ if it is not already installed,
    12  or if you have problems running the curl commands.
    13  
    14  Install cURL
    15  ------------
    16  
    17  Download the latest version of the `cURL
    18  <https://curl.haxx.se/download.html>`__ tool if it is not already
    19  installed or if you get errors running the curl commands from the
    20  documentation.
    21  
    22  .. note:: If you're on Windows please see the specific note on `Windows
    23     extras`_ below.
    24  
    25  Docker and Docker Compose
    26  -------------------------
    27  
    28  You will need the following installed on the platform on which you will be
    29  operating, or developing on (or for), Hyperledger Fabric:
    30  
    31    - MacOSX, \*nix, or Windows 10: `Docker <https://www.docker.com/get-docker>`__
    32      Docker version 17.06.2-ce or greater is required.
    33    - Older versions of Windows: `Docker
    34      Toolbox <https://docs.docker.com/toolbox/toolbox_install_windows/>`__ -
    35      again, Docker version Docker 17.06.2-ce or greater is required.
    36  
    37  You can check the version of Docker you have installed with the following
    38  command from a terminal prompt:
    39  
    40  .. code:: bash
    41  
    42    docker --version
    43  
    44  .. note:: The following applies to linux systems running systemd.
    45  
    46  Make sure the docker daemon is running.
    47  
    48  .. code:: bash
    49  
    50    sudo systemctl start docker
    51  
    52  Optional: If you want the docker daemon to start when the system starts, use the following:
    53  
    54  .. code:: bash
    55  
    56    sudo systemctl enable docker
    57  
    58  Add your user to the docker group.
    59  
    60  .. code:: bash
    61  
    62    sudo usermod -a -G docker <username>
    63  
    64  .. note:: Installing Docker for Mac or Windows, or Docker Toolbox will also
    65            install Docker Compose. If you already had Docker installed, you
    66            should check that you have Docker Compose version 1.14.0 or greater
    67            installed. If not, we recommend that you install a more recent
    68            version of Docker.
    69  
    70  You can check the version of Docker Compose you have installed with the
    71  following command from a terminal prompt:
    72  
    73  .. code:: bash
    74  
    75    docker-compose --version
    76  
    77  .. _windows-extras:
    78  
    79  Windows extras
    80  --------------
    81  
    82  On Windows 10 you should use the native Docker distribution and you
    83  may use the Windows PowerShell. However, for the ``binaries``
    84  command to succeed you will still need to have the ``uname`` command
    85  available. You can get it as part of Git but beware that only the
    86  64bit version is supported.
    87  
    88  Before running any ``git clone`` commands, run the following commands:
    89  
    90  ::
    91  
    92      git config --global core.autocrlf false
    93      git config --global core.longpaths true
    94  
    95  You can check the setting of these parameters with the following commands:
    96  
    97  ::
    98  
    99      git config --get core.autocrlf
   100      git config --get core.longpaths
   101  
   102  These need to be ``false`` and ``true`` respectively.
   103  
   104  The ``curl`` command that comes with Git and Docker Toolbox is old and
   105  does not handle properly the redirect used in
   106  :doc:`getting_started`. Make sure you have and use a newer version
   107  which can be downloaded from the `cURL downloads page
   108  <https://curl.haxx.se/download.html>`__
   109  
   110  .. note:: If you have questions not addressed by this documentation, or run into
   111            issues with any of the tutorials, please visit the :doc:`questions`
   112            page for some tips on where to find additional help.
   113  
   114  .. Licensed under Creative Commons Attribution 4.0 International License
   115     https://creativecommons.org/licenses/by/4.0/