Linux Server Configuration

This project requires a Linux server configured on Amazon Lightsail to serve an application built with Flask, a Python framework.

The web application has been built and can be found here: https://github.com/oluwaseye/catalog

You can visit 54.196.98.216 for the website deployed.

Setup LightSail Instance

1. Create an AWS Management Console account.
2. Create an Amazon Lightsail instance.

The instance needs at least two minutes to be created and booted up. I named my instance Udacity, you can decided whether or not to name your instance.

3. Navigate to the account page and download your SSH key

• Click the 'Networking' tab and add the required ports for the project. (This is an important due to the Lightsail only recognizing port 80 and 22 being set up in the account before applying Ubuntu UFW in the shell. If you skip this step, you will end up locking yourself out of the server)

• Launch your terminal, navigate to the location of the downloaded SSH key

• Rename the file sudo mv <filename>.pem udacity_key.pem

• Create a ssh directory to store your SSH keys. mkidir ~/.ssh and move the file to .ssh directory with sudo mv udacity_key.pem ~/.ssh

• Change file permissions with sudo chmod 600 ~/.ssh/udacity_key.pem (Important information: If you are on a Windows machine, sudo might not be required while running bash commands to navigate or carried out instruction for your machine. When you login to the remote machine (Linux), then sudo will be required in some cases.)

Configure your Lightsail Instance

Create New User Grader and Give Sudo Access

• Connect with SSH by entering sudo ssh -i ~/.ssh/udacity_key.pem ubunutu@54.196.98.216 The ip address is the Public IP of your Lightsail Instance.

• Type $ sudo su - to assume the root user role, then type $ sudo adduser grader to create another user 'grader' This is the account that will be used manage this instance.

• Create a new file under the sudoers directory: $ sudo nano /etc/sudoers.d/grader. Fill that file with grader ALL=(ALL:ALL) ALL, then save with (Control X, then type yes, then hit the return key on your keyboard)

• Switch to your newly created account sudo su grader

• Edit the hosts by $ sudo nano /etc/hosts, and then add 127.0.0.1 ip-172-26-3-75 under 127.0.0.1:localhost This will prevent you from encountering unable to resolve host error.

• Update all packages:

  $ sudo apt-get update $ sudo apt-get upgrade

• Open another Terminal window to generate an rsa key for the grader user $sudo ssh-keygen -f ~/.ssh/udacity_key.rsa

• Output the public key in the new terminal window, $ sudo cat ~/.ssh/udacity_key.rsa.pub , select and copy the key.

• Back to the previous terminal window where you are logged into Amazon Lightsail, navigate to grader's folder by $ cd /home/grader

• Create a .ssh directory: $ mkdir .ssh

• Create a file to store the public key: $ touch .ssh/authorized_keys

• Edit the authorized_keys file $ nano .ssh/authorized_keys and paste the public key copied from the other terminal into the new authorized_keys file, save and exit.

• Change the permission: $ sudo chmod 700 /home/grader/.ssh and $ sudo chmod 644 /home/grader/.ssh/authorized_keys

• Change the owner from root to grader: $ sudo chown -R grader:grader /home/grader/.ssh

• We now need to enforce the key-based authentication and change the SSH port from 22 to 220: $ sudo nano /etc/ssh/sshd_config. Update the Port to 2200 , also Locate PasswordAuthentication and change options to no if it says otherwise. I did not have to change this line since the file already had no. This might be different for you. Restart ssh : $ sudo service ssh restart

Disconnect the server by typing $ logout and log back in through port 2200: $ ssh -i ~/.ssh/udacity_key.rsa -p 2200 grader@54.196.98.216

Configure the Uncomplicated Firewall (UFW)

Configure the Uncomplicated Firewall (UFW) to only allow incoming connections for SSH (port 2200), HTTP (port 80), and NTP (port 123)

sudo ufw allow 2200/tcp
sudo ufw allow 80/tcp
sudo ufw allow 123/udp
sudo ufw enable 

To check the configuration, type sudo ufw status. The output must look like this:

To                         Action      From
--                         ------      ----
2200/tcp                   ALLOW       Anywhere
80/tcp                     ALLOW       Anywhere
123/udp                    ALLOW       Anywhere
2200/tcp (v6)              ALLOW       Anywhere (v6)
80/tcp (v6)                ALLOW       Anywhere (v6)
123/udp (v6)               ALLOW       Anywhere (v6)

Configure the local timezone to UTC

Configure the time zone sudo dpkg-reconfigure tzdata A set of instruction will appear for you to follow. Press the enter to select None of the above option and select the UTC option.

Install Apache, Python as a mod_wsgi application, and Git

• Install Apache sudo apt-get install apache2
• Install mod_wsgi and python sudo apt-get install libapache2-mod-wsgi python-dev
• Install Git sudo apt-get install git
• Restart apache sudo service apache2 restart

Install and configure PostgreSQL

• Install PostgreSQL sudo apt-get install postgresql

• Login as user "postgres" sudo su - postgres and get into the postgreSQL shell psql

• Create a new database catalog with user catalog and password catalog , and grant all permission to the user

  postgres=# CREATE DATABASE catalog;
  postgres=# CREATE USER catalog;
  postgres=# ALTER ROLE catalog WITH PASSWORD 'catalog';
  postgres=# GRANT ALL PRIVILEGES ON DATABASE catalog TO catalog;
  

• Quit and exit postgreSQL with \q and exit

Clone and setup your Catalog App project.

• Use cd /var/www to move to the /var/www directory

• Create the application directory sudo mkdir catalog

• Move inside this directory using cd catalog

• Clone the Catalog App to the virtual machine git clone https://github.com/oluwaseye/catalog.git

• Move to the newly cloned catalog directory using cd catalog. Now you have a directory as such /var/www/catalog/catalog/

• Rename application.py to __init__.py using sudo mv application.py __init__.py

• Edit database_dump.py, database_setup.py and __init__.py , updating the database engine from a sql lite to postgresql engine = create_engine('sqlite:///itemcatalog.db') to engine = create_engine('postgresql://catalog:catalog@localhost/catalog')

• Change ownership of the directory sudo chown -R grader:grader /var/www/catalog

• Install pip sudo apt-get install python-pip

• Install virtual environment sudo apt-get install python-virtualenv

• Install psycopg2 sudo apt-get -qqy install postgresql python-psycopg2

• Create database schema sudo python database_setup.py

Virtual environment

Activate the virtual environment venv/bin/activate. and install the following dependencies: pip install httplib2 pip install requests pip install --upgrade oauth2client
pip install sqlalchemy pip install flask sudo apt-get install libpq-dev pip install psycopg2 pip install sqlalchemy_utils pip install requests pip install render_template pip install redirect

Configure and Enable a New Virtual Host

• Create catalog.conf to edit: sudo nano /etc/apache2/sites-available/catalog.conf

• Add the following lines of code to the file to configure the virtual host. Please note, i used xip.io which is a wildcard DNS to bypass Google OAuth's restrictions of just using an IP address as Authorized JavaScript origins and Authorized redirect URIs I also swapped the ServerName for the Server Alias so we can get a nice redirect when the points to browses 54.196.98.216 in the browser since xip will resolve to your ip address.

  <VirtualHost *:80>
      ServerName 54.196.98.216.xip.io
      ServerAlias 54.196.98.216
      ServerAdmin grader@54.196.98.216
      WSGIScriptAlias / /var/www/catalog/catalog.wsgi
  <Directory /var/www/catalog/catalog/>
      Order allow,deny
      Allow from all
  </Directory>
      Alias /static /var/www/catalog/catalog/static
  <Directory /var/www/catalog/catalog/static/>
  		Order allow,deny
  		Allow from all
  	</Directory>
  	ErrorLog ${APACHE_LOG_DIR}/error.log
  	LogLevel warn
  	CustomLog ${APACHE_LOG_DIR}/access.log combined
  </VirtualHost>
  
  

• Enable the virtual host with the following command: sudo a2ensite catalog

More Info Here is xip.io

Google Authentication

1. Visit your Google Developers Consolea and follow the steps in the screenshot below to update the existing Oauth or create a new one. To achieve a verified url for Google OAuth. You have to verify the Domain with Google. Please see the screenshot below for steps.

Important information: You'll have to verify the url with the Google Webmaster Central by using the meta tag option, copying the provided meta tag and adding it with the head tag of the /var/www/catalog/catalog/templates/base.html file.

Move the client_secrets.json sudo mv /var/www/catalog/catalog /var/www/catalog Update the redirect_uris and javascript_origins values with your new address

Create the .wsgi File

• Create the .wsgi File under /var/www/catalog:

  cd /var/www/catalog
  sudo nano catalog.wsgi 
  

• Add the following lines of code to the catalog.wsgi file:

    activate_this = '/var/www/catalog/catalog/venv/bin/activate_this.py'
    execfile(activate_this, dict(__file__=activate_this))
    
    #!/usr/bin/python
    
    import sys
    import logging
    logging.basicConfig(stream=sys.stderr)
    sys.path.insert(0, "/var/www/catalog/")
        
    from catalog import app as application
    application.secret_key = 'super_secret_key' 
   ``` 
  
  
  
  

Restart Apache and Point to the site

Restart Apache sudo service apache2 restart

Resources

https://realpython.com/flask-by-example-part-2-postgres-sqlalchemy-and-alembic/ https://www.digitalocean.com/community/tutorials/how-to-configure-the-apache-web-server-on-an-ubuntu-or-debian-vps https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-16-04