diff --git a/docs/source/_static/aws/1.png b/docs/source/_static/aws/1.png new file mode 100644 index 0000000..39c1b5c Binary files /dev/null and b/docs/source/_static/aws/1.png differ diff --git a/docs/source/_static/aws/10.png b/docs/source/_static/aws/10.png new file mode 100644 index 0000000..5d8bc89 Binary files /dev/null and b/docs/source/_static/aws/10.png differ diff --git a/docs/source/_static/aws/11.png b/docs/source/_static/aws/11.png new file mode 100644 index 0000000..231f261 Binary files /dev/null and b/docs/source/_static/aws/11.png differ diff --git a/docs/source/_static/aws/12.png b/docs/source/_static/aws/12.png new file mode 100644 index 0000000..ea15fd2 Binary files /dev/null and b/docs/source/_static/aws/12.png differ diff --git a/docs/source/_static/aws/13.png b/docs/source/_static/aws/13.png new file mode 100644 index 0000000..5421f69 Binary files /dev/null and b/docs/source/_static/aws/13.png differ diff --git a/docs/source/_static/aws/14.png b/docs/source/_static/aws/14.png new file mode 100644 index 0000000..b4be7a2 Binary files /dev/null and b/docs/source/_static/aws/14.png differ diff --git a/docs/source/_static/aws/15.png b/docs/source/_static/aws/15.png new file mode 100644 index 0000000..17666ce Binary files /dev/null and b/docs/source/_static/aws/15.png differ diff --git a/docs/source/_static/aws/16.png b/docs/source/_static/aws/16.png new file mode 100644 index 0000000..0eebaa9 Binary files /dev/null and b/docs/source/_static/aws/16.png differ diff --git a/docs/source/_static/aws/17.png b/docs/source/_static/aws/17.png new file mode 100644 index 0000000..459fa35 Binary files /dev/null and b/docs/source/_static/aws/17.png differ diff --git a/docs/source/_static/aws/18.png b/docs/source/_static/aws/18.png new file mode 100644 index 0000000..c70cf86 Binary files /dev/null and b/docs/source/_static/aws/18.png differ diff --git a/docs/source/_static/aws/19.png b/docs/source/_static/aws/19.png new file mode 100644 index 0000000..34cbb00 Binary files /dev/null and b/docs/source/_static/aws/19.png differ diff --git a/docs/source/_static/aws/2.png b/docs/source/_static/aws/2.png new file mode 100644 index 0000000..bc85a42 Binary files /dev/null and b/docs/source/_static/aws/2.png differ diff --git a/docs/source/_static/aws/20.png b/docs/source/_static/aws/20.png new file mode 100644 index 0000000..56b3761 Binary files /dev/null and b/docs/source/_static/aws/20.png differ diff --git a/docs/source/_static/aws/21.png b/docs/source/_static/aws/21.png new file mode 100644 index 0000000..11d6dcb Binary files /dev/null and b/docs/source/_static/aws/21.png differ diff --git a/docs/source/_static/aws/22.png b/docs/source/_static/aws/22.png new file mode 100644 index 0000000..f6de6d4 Binary files /dev/null and b/docs/source/_static/aws/22.png differ diff --git a/docs/source/_static/aws/23.png b/docs/source/_static/aws/23.png new file mode 100644 index 0000000..845f2e5 Binary files /dev/null and b/docs/source/_static/aws/23.png differ diff --git a/docs/source/_static/aws/24.png b/docs/source/_static/aws/24.png new file mode 100644 index 0000000..a9817f0 Binary files /dev/null and b/docs/source/_static/aws/24.png differ diff --git a/docs/source/_static/aws/25.png b/docs/source/_static/aws/25.png new file mode 100644 index 0000000..ee49747 Binary files /dev/null and b/docs/source/_static/aws/25.png differ diff --git a/docs/source/_static/aws/26.png b/docs/source/_static/aws/26.png new file mode 100644 index 0000000..eab2a27 Binary files /dev/null and b/docs/source/_static/aws/26.png differ diff --git a/docs/source/_static/aws/27.png b/docs/source/_static/aws/27.png new file mode 100644 index 0000000..8762f38 Binary files /dev/null and b/docs/source/_static/aws/27.png differ diff --git a/docs/source/_static/aws/28.png b/docs/source/_static/aws/28.png new file mode 100644 index 0000000..3935eb9 Binary files /dev/null and b/docs/source/_static/aws/28.png differ diff --git a/docs/source/_static/aws/29.png b/docs/source/_static/aws/29.png new file mode 100644 index 0000000..c1bb669 Binary files /dev/null and b/docs/source/_static/aws/29.png differ diff --git a/docs/source/_static/aws/3.png b/docs/source/_static/aws/3.png new file mode 100644 index 0000000..1860394 Binary files /dev/null and b/docs/source/_static/aws/3.png differ diff --git a/docs/source/_static/aws/30.png b/docs/source/_static/aws/30.png new file mode 100644 index 0000000..16629ea Binary files /dev/null and b/docs/source/_static/aws/30.png differ diff --git a/docs/source/_static/aws/31.png b/docs/source/_static/aws/31.png new file mode 100644 index 0000000..05ffbd2 Binary files /dev/null and b/docs/source/_static/aws/31.png differ diff --git a/docs/source/_static/aws/32.png b/docs/source/_static/aws/32.png new file mode 100644 index 0000000..e702a72 Binary files /dev/null and b/docs/source/_static/aws/32.png differ diff --git a/docs/source/_static/aws/4.png b/docs/source/_static/aws/4.png new file mode 100644 index 0000000..4270685 Binary files /dev/null and b/docs/source/_static/aws/4.png differ diff --git a/docs/source/_static/aws/5.png b/docs/source/_static/aws/5.png new file mode 100644 index 0000000..03343f0 Binary files /dev/null and b/docs/source/_static/aws/5.png differ diff --git a/docs/source/_static/aws/6.png b/docs/source/_static/aws/6.png new file mode 100644 index 0000000..7d9b7e0 Binary files /dev/null and b/docs/source/_static/aws/6.png differ diff --git a/docs/source/_static/aws/7.png b/docs/source/_static/aws/7.png new file mode 100644 index 0000000..fd4cd50 Binary files /dev/null and b/docs/source/_static/aws/7.png differ diff --git a/docs/source/_static/aws/8.png b/docs/source/_static/aws/8.png new file mode 100644 index 0000000..c3c1345 Binary files /dev/null and b/docs/source/_static/aws/8.png differ diff --git a/docs/source/_static/aws/9.png b/docs/source/_static/aws/9.png new file mode 100644 index 0000000..de8f7c5 Binary files /dev/null and b/docs/source/_static/aws/9.png differ diff --git a/docs/source/aws.rst b/docs/source/aws.rst index 8d5b022..af2c909 100644 --- a/docs/source/aws.rst +++ b/docs/source/aws.rst @@ -1,6 +1,192 @@ AWS machine instance -~~~~~~~~~~~~~~~~~~~~ +-------------------- As well as our monthly license model you can setup an Amazon Web Service machine instance and pay by the hour. -* `Install instructions `_ +Go to the URL https://aws.amazon.com/marketplace/pp/B0862DRQGT +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Click the subscribe button (highlighted with red rectangle). + +.. image:: _static/aws/1.png + +Continue to configuration +~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/2.png + +Choose your region +~~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/3.png + +Continue to Launch +~~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/4.png + +Change instance type +~~~~~~~~~~~~~~~~~~~~ +Change the EC2 instance type. If you have a new account, you will be limited to the smallest machine: c5.2xlarge. + +.. image:: _static/aws/5.png + +Choose default security group +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Select default as the security group. + +.. image:: _static/aws/6.png + +Choose or setup a key pair +~~~~~~~~~~~~~~~~~~~~~~~~~~ +If you already have a key pair choose it and skip to page :ref:`Launch the new instance`. +Otherwise click the link. This will open a new tab where you can create a key pair. + +.. image:: _static/aws/7.png + +Create the new key pair +~~~~~~~~~~~~~~~~~~~~~~~ +Click the button shown. + +.. image:: _static/aws/8.png + +Name and download the pem key pair +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Then click the create button. + +.. image:: _static/aws/9.png + +Save the key pair +~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/10.png + +Your new keypair will be shown in the list +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Click the previous tab to continue configuration. + +.. image:: _static/aws/11.png + +Refresh the key pairs +~~~~~~~~~~~~~~~~~~~~~ +Click the refresh button to load your new key. + +.. image:: _static/aws/12.png + +Choose the new key +~~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/13.png + +Launch the new instance +~~~~~~~~~~~~~~~~~~~~~~~ + +.. image:: _static/aws/14.png + +Go to the EC2 console +~~~~~~~~~~~~~~~~~~~~~ +Click the link shown. + +.. image:: _static/aws/15.png + +Go to the default security group configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Click the link. + +.. image:: _static/aws/16.png + +Choose the default group +~~~~~~~~~~~~~~~~~~~~~~~~ +Click the link. + +.. image:: _static/aws/17.png + +Add a new inbound rule +~~~~~~~~~~~~~~~~~~~~~~ +Click the button to edit inbound rules. + +.. image:: _static/aws/18.png + +Add a new rule +~~~~~~~~~~~~~~ +Click the button. + +.. image:: _static/aws/19.png + +Change inbound type to SSH +~~~~~~~~~~~~~~~~~~~~~~~~~~ +Click the dropdown and choose SSH. + +.. image:: _static/aws/20.png + +Setup source IP +~~~~~~~~~~~~~~~ +In the source dropdown, choose ‘My IP’. + +.. image:: _static/aws/21.png + +Save the new rule +~~~~~~~~~~~~~~~~~ +Click the button. + +.. image:: _static/aws/22.png + +View the instances +~~~~~~~~~~~~~~~~~~ +Click the instances link. + +.. image:: _static/aws/23.png + +Connect to the instances +~~~~~~~~~~~~~~~~~~~~~~~~ +Click the button. + +.. image:: _static/aws/24.png + +Copy the chmod text +~~~~~~~~~~~~~~~~~~~ +Select and copy the text shown. + +.. image:: _static/aws/25.png + +Run the command on your downloaded key +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +In a terminal, go to where you downloaded the key from step Save the key pair. Then paste in the copied text from step Copy the chmod text. + +.. image:: _static/aws/26.png + +Copy the ssh text +~~~~~~~~~~~~~~~~~ +Select and copy the text shown. + +.. image:: _static/aws/27.png + +Run the ssh command +~~~~~~~~~~~~~~~~~~~ +Paste the command copied from step Copy the ssh text. + +.. image:: _static/aws/28.png + +Confirm connection +~~~~~~~~~~~~~~~~~~ + Type yes and then enter to connect. + +.. image:: _static/aws/29.png + +Start yosys to test the tools +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Type yosys and press enter. You will see the license verified. Type exit to quit. + +.. image:: _static/aws/30.png + +Terminate instance when finished +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Click the actions button, then choose instance state and terminate. + +.. image:: _static/aws/31.png + +Confirm termination +~~~~~~~~~~~~~~~~~~~ +Click the button to confirm termination of the instance. + +.. image:: _static/aws/32.png diff --git a/docs/source/conf.py b/docs/source/conf.py index 4680943..e06574f 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -30,7 +30,7 @@ # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. -extensions = [] +extensions = ['sphinx.ext.autosectionlabel'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates']