<commit_before>Getting Started
===============

.. note:: These instructions have been verified to work against the "alpha" tagged docker
          images and the pre-compiled binaries within the supplied tarball file.
          If you run these commands with images or tools from the current master
          branch, you will see configuration and panic errors.

The getting started scenario provisions a sample Fabric network consisting of
two organizations, each maintaining two peers, and a "solo" ordering service.

Prior to launching the network, we will demonstrate the usage of two fundamental tools:

- cryptogen - generates the x509 certificates used to identify and authenticate
  the various components in the network.
- configtxgen - generates the requisite configuration artifacts for orderer
  bootstrap and channel creation.

In no time we'll have a fully-functioning transactional network with a shared
ledger and digital signature verification.  Let's get going...

Prerequisites and setup
-----------------------

- `Docker <https://www.docker.com/products/overview>`__ - v1.12 or higher
- `Docker Compose <https://docs.docker.com/compose/overview/>`__ - v1.8 or higher
- `Docker Toolbox <https://docs.docker.com/toolbox/toolbox_install_windows/>`__ - Windows users only
- `Go <https://golang.org/>`__ - 1.7 or higher
- `Git Bash <https://git-scm.com/downloads>`__ - Windows users only; provides a better alternative to the Windows command prompt

Curl the artifacts and binaries
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. note:: If you are running on Windows you will want to make use of your Git
          Bash shell for the upcoming terminal commands.

- Download the `cURL <https://curl.haxx.se/download.html>`__ tool if not already installed.
- Determine a location on your machine where you want to place the artifacts and binaries.

.. code:: bash

  mkdir fabric-sample
  cd fabric-sample

Next, execute the following command:

.. code:: bash

  curl -L https://logs.hyperledger.org/sandbox/vex-yul-hyp-jenkins-2/fabric-binaries/release.tar.gz -o release.tar.gz 2> /dev/null;  tar -xvf release.tar.gz

This command pulls and extracts all of the necessary artifacts to set up your
network and places them into a folder titled ``release``.  It also retrieves the
two binaries - cryptogen and configtxgen - which are briefly described at the top
of this page.

Pulling the docker images
^^^^^^^^^^^^^^^^^^^^^^^^^<commit_msg>FAB-3689 update README with nexus fabric binaries link<commit_after>Getting Started
===============

.. note:: These instructions have been verified to work against the "alpha" tagged docker
          images and the pre-compiled binaries within the supplied tarball file.
          If you run these commands with images or tools from the current master
          branch, you will see configuration and panic errors.

The getting started scenario provisions a sample Fabric network consisting of
two organizations, each maintaining two peers, and a "solo" ordering service.

Prior to launching the network, we will demonstrate the usage of two fundamental tools:

- cryptogen - generates the x509 certificates used to identify and authenticate
  the various components in the network.
- configtxgen - generates the requisite configuration artifacts for orderer
  bootstrap and channel creation.

In no time we'll have a fully-functioning transactional network with a shared
ledger and digital signature verification.  Let's get going...

Prerequisites and setup
-----------------------

- `Docker <https://www.docker.com/products/overview>`__ - v1.12 or higher
- `Docker Compose <https://docs.docker.com/compose/overview/>`__ - v1.8 or higher
- `Docker Toolbox <https://docs.docker.com/toolbox/toolbox_install_windows/>`__ - Windows users only
- `Go <https://golang.org/>`__ - 1.7 or higher
- `Git Bash <https://git-scm.com/downloads>`__ - Windows users only; provides a better alternative to the Windows command prompt

Curl the artifacts and binaries
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. note:: If you are running on Windows you will want to make use of your Git
          Bash shell for the upcoming terminal commands.

- Download the `cURL <https://curl.haxx.se/download.html>`__ tool if not already installed.
- Determine a location on your machine where you want to place the artifacts and binaries.

.. code:: bash

  mkdir fabric-sample
  cd fabric-sample

Next, execute the following command:

.. code:: bash

  curl -L https://nexus.hyperledger.org/content/repositories/snapshots/sandbox/vex-yul-hyp-jenkins-2/fabric-binaries/release.tar.gz -o release.tar.gz 2> /dev/null;  tar -xvf release.tar.gz

This command pulls and extracts all of the necessary artifacts to set up your
network and places them into a folder titled ``release``.  It also retrieves the
two binaries - cryptogen and configtxgen - which are briefly described at the top
of this page.

Pulling the docker images
^^^^^^^^^^^^^^^^^^^^^^^^^
{'fraction_non_alphanumeric': 0.10655903128153381, 'fraction_numerical': 0.0056508577194752775, 'mean_word_length': 3.7562380038387717, 'pattern_counts': {'":': 0, '<': 15, '<?xml version=': 0, '>': 17, 'https://': 14, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5605763', 'n_tokens_mistral': 1380, 'n_tokens_neox': 1266, 'n_words': 589}