Archives/algo
2
0
Fork 0
mirror of https://github.com/trailofbits/algo synced 2024-11-18 09:25:38 +00:00
Code Issues Projects Releases Wiki Activity
6f58093a06
algo/docs/deploy-from-redhat-centos6.md

87 lines
2.8 KiB
Markdown
Raw Normal View History

Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
# RedHat/CentOS 6.x pre-installation requirements
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Tidy this up
2016-12-21 01:41:03 +00:00
Many people prefer RedHat or CentOS 6 (or similar variants like Amazon Linux) for to their stability and lack of systemd. Unfortunately, there are a number of dated libraries, notably Python 2.6, that prevent Algo from running without errors. This script will prepare a RedHat, CentOS, or similar VM to deploy to Algo cloud instances.
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
## Step 1: Prep for RH/CentOS 6.8/Amazon
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
yum -y -q update
yum -y -q install epel-release
```
Enable any kernel updates:
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
reboot
```
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
## Step 2: Install Ansible and launch Algo
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Tidy this up
2016-12-21 01:41:03 +00:00
Fix GPG key warnings during Ansible rpm install:
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
rpm --import https://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6
```
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Spelling fixes (#342) * spelling: algorithm * spelling: bertrand * spelling: between * spelling: checking * spelling: conjunction * spelling: contributor * spelling: delimited * spelling: fashion * spelling: droplet * spelling: javascript * spelling: nameserver * spelling: obligatory * spelling: official * spelling: overridden * spelling: overwrite * spelling: parameter * spelling: suppressing
2017-04-02 23:14:38 +00:00
Fix GPG key warning during official Software Collections (SCL) package install:
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
rpm --import https://raw.githubusercontent.com/sclorg/centos-release-scl/master/centos-release-scl/RPM-GPG-KEY-CentOS-SIG-SCLo
```
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Tidy this up
2016-12-21 01:41:03 +00:00
RedHat/CentOS 6.x uses Python 2.6 by default, which is explicitly deprecated and produces many warnings and errors, so we must install a safe, non-invasive 2.7 tool set which has to be expressly enabled (and will not survive login sessions and reboots):
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
Tidy this up
2016-12-21 01:41:03 +00:00
# Install the Software Collections Library (to enable Python 2.7)
yum -y -q install centos-release-SCL
# 2.7 will not be used until explicitly enabled, per login session
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
yum -y -q install python27-python-devel python27-python-setuptools python27-python-pip
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
yum -y -q install openssl-devel libffi-devel automake gcc gcc-c++ kernel-devel wget unzip ansible nano
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Spelling fixes (#342) * spelling: algorithm * spelling: bertrand * spelling: between * spelling: checking * spelling: conjunction * spelling: contributor * spelling: delimited * spelling: fashion * spelling: droplet * spelling: javascript * spelling: nameserver * spelling: obligatory * spelling: official * spelling: overridden * spelling: overwrite * spelling: parameter * spelling: suppressing
2017-04-02 23:14:38 +00:00
# Enable 2.7 default for this session (needs re-run between logins & reboots)
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
# shellcheck disable=SC1091
source /opt/rh/python27/enable
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
# We're now defaulted to 2.7
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Tidy this up
2016-12-21 01:41:03 +00:00
# Upgrade pip itself
pip -q install --upgrade pip
add virtualenv to CentOS instructions
2017-04-09 14:11:26 +00:00
# python-devel needed to prevent setup.py crash
Tidy this up
2016-12-21 01:41:03 +00:00
pip -q install pycrypto
add virtualenv to CentOS instructions
2017-04-09 14:11:26 +00:00
# pycrypto 2.7.1 needed for latest security patch
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
pip -q install setuptools --upgrade
add virtualenv to CentOS instructions
2017-04-09 14:11:26 +00:00
# virtualenv to make installing dependencies easier
pip -q install virtualenv
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
wget -q https://github.com/trailofbits/algo/archive/master.zip
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
unzip master.zip
Update pre-install_redhat_centos_6.x.md
2016-12-19 21:22:27 +00:00
cd algo-master || echo "No Algo directory found"
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
add virtualenv to CentOS instructions
2017-04-09 14:11:26 +00:00
# Set up a virtualenv and install the local Algo dependencies (must be run from algo-master)
virtualenv env && source env/bin/activate
Tidy this up
2016-12-21 01:41:03 +00:00
pip -q install -r requirements.txt
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Tidy this up
2016-12-21 01:41:03 +00:00
# Edit the userlist and any other settings you desire
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
nano config.cfg
Tidy this up
2016-12-21 01:41:03 +00:00
# Now you can run the Algo installer!
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
./algo
```
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
## Post-install macOS
1. Copy `./configs/*mobileconfig` to your local Mac
2. Install the VPN profile on your Mac (10.10+ required)
```shell
/usr/bin/profiles -I -F ./x.x.x.x_NAME.mobileconfig
```
3. To remove:
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
Reorganize documentation for GitHub pages (#378) Reorganize documentation for clarity and use with GitHub pages static site generator. This closes #371.
2017-04-13 00:25:31 +00:00
```shell
/usr/bin/profiles -D -F ./x.x.x.x_NAME.mobileconfig
```
Notes & recipe to install from RH/Cent 6.8 VMs It was very difficult to satisfy all the library dependencies, particularly for Digital Ocean ("dopy") and pycrypto ("cryptography") on RPM-based distros, particularly with the default version of Python that ships with the 6.x line. These steps allow an end-to-end install (verified on Digital Ocean and EC2) with zero warnings or errors.
2016-12-19 21:08:41 +00:00
The VPN connection will now appear under Networks (which can be pinned to the top menu bar if preferred)
Reference in New Issue Copy Permalink