You can obtain the iota source code using one of these methods:

Git Fork

If you intend to make changes to the iota source tree, then install the source tree from GitHub.

Install Git Tools

If you haven’t done so already, install the Git Tools:

 

Download iota Source Tree

You download the iota source tree once the git tools have been installed.

Fork iota Repository

You create a private fork of iota on https://github.com/apache/incubator-iota. Use the fork button top-right on the page to create your fork, which will be named <your-github-id>_fork.

The following examples use iotadeveloper to represent <your-github-id>.

 

Clone iota Repository

Use the git shell to perform this task.


Clone iota Repository
# Move to the directory where you want to install the iota source code.
cd mysource

# Clone the iota source code
git clone git://git.apache.org/incubator-iota.git
 
# Change to the iota source-tree directory
cd incubator-iota

# Register your fork as a remote branch
git remote add iotadeveloper_fork git@github.com:iotadeveloper/incubator-iota

 

Create Task Branch

You create a task branch to make changes to the iota source tree. Typically, we name the branches after the Jira we are working on. In this example, the Jira is: iota-1507.

Create Task Branch
# Ensure that you have the latest changes
git fetch --all

# Checkout source
git checkout -b iota-42 origin/master

tar/zip Download

Typically, you download the iota source tree as a tar/zip file if you don’t intend the change the source code. For example, when you want to build the iota binaries only.

 

tar file


Download Location: https://dist.apache.org/repos/dist/release/incubator/iota

  1. Open the iota folder.

    PGP Key

    The source tar file has been signed with one of the pgp keys, which is included in the download location’s KEYS file.

  2. Open the folder containing the version you want to download. For example: apache-iota-0.1.0-incubating

  3. Download the -src file that fits your security needs. For example: apache-iota-0.1.0-incubating-src.tar.gz

  4. Unpack the tar file:

    mkdir <target-directory>
tar -xzf <tar file> -C <target-directory>
# Change direcotry name to match GitHub download name; makes this guide simpler to write.
mv <target-directory>/apache-iota-<version>-incubating <target-directory>/incubator-iota

    Example

    $ mkdir ~/mysource
$ tar -xzf apache-iota-0.1.0-incubating-src.tar.gz -C ~/mysource
$ ls mysource
apache-iota-0.1.0-incubating
$ ls mysource/apache-iota-0.1.0-incubating
<TBD>
$ # Change directory name to match GitHub download name; makes this guide simpler to write.
$ mv mysource/apache-iota-0.1.0-incubating mysource/incubator-iota
$ ls mysource
incubator-iota


zip File

Click on Download ZIP at https://github.com/apache/incubator-iota. The zip file will be named incubator-iota-master.zip.

  1. If necessary, FTP the zip file to your Linux development environment using WinSCP or a similar tool.

  2. Unzip to the target directory.

    Unzip Trafodion Source
    unzip -q incubator-iota-master.zip -d mysource

    Example

     

    Unzip Example
    $ unzip -q incubator-iota-master.zip -d mysource
$ ls mysource
incubator-iota-master
$ ls mysource/incubator-iota-master
<TBD>
$ # Change directory name to match GitHub download name; makes this guide simpler to write.
$ mv mysource/incubator-iota-master mysource/incubator-iota
$ ls mysource
incubator-iota
 
  • No labels