View source for OPS335 - Assignment 1 (Part 1)

== Purpose ==

For this portion of assignment 1, you will set up the basic functionality for a virtual machine to act as a '''cloning-source''' to make it easier for the student to create other servers (VMs) in later assignments. Whenever you clone another server (in later assignments), you MUST make certain to configure the cloned server in order to make it function in the network correctly and meet the requirements of future assignments. All of the assignments for this course are '''<u>interdependent</u>''' of each other and belong to the same Virtual Private Network called '''335assign'''.

== General Requirements ==

'''Weight''': '''3%''' of the overall grade

'''Due Date''': During '''Week 5''' (in class)

== Detailed Requirements ==

=== Set-up a Virtual Network (335assign) ===

Create a new virtual network on your Host Machine.

* Assign a newly-created virtual network the name: '''335assign''', and set '''forwarding to any physical device'''<br>(refer to [http://zenit.senecac.on.ca/wiki/index.php/OPS335_Installation_Lab#INVESTIGATION_2:_VIRTUAL_MACHINE_INSTALLATION lab setup]. You can have have 2 different network names: "335assign"  and "ops335" without causing any problems).
* Addresses in this network will start with '''172.17.40'''. The subnet mask must be '''255.255.255.0'''
* There must '''<u>NOT</u>''' be a DHCP server running for this network!
* All the machines for this assignment will be connected to your newly-created virtual network called: '''335assign'''

=== Create a "Cloning-Source" VM (335assign Virtual Network) ===

Create a virtual machine that you will use as a cloning-source.

Details for the cloning-source

#The name of this cloning-source VM will be called: '''minnow'''.
#You should use the options that you used in your lab1 to setup the static network, plus you should use the DOMAIN parameter to set the '''species.lake.ops''' domain for your cloning-source.
#The VM should have a command-line interface only.
#Configure it to be a good cloning-source, '''making certain that the cloning-source has all the following elements prior to cloning:'''
::*Don't make the virtual drive too big: you will need space for it as well as space for the clones you from your cloning-source<br>('''5 GB''' should be enough for any cloning-source and clone VM that you create for this assignment).
::*The hostname for this server will be called: '''minnow'''
::*Make certain that you can login to your cloning-source.
::*Configure your network interface for this cloning-source with a '''static''' configuration and is connected to the '''335assign''' network. Refer to the table below for IP address and hostname.<br>

{| class="wikitable" | style="margin-left:50px; style="border: 2px solid black;" | "
|- style="font-weight:bold; text-align:center;"
| style="border: 2px solid black;" |  Hostname / Domain
| style="border: 2px solid black;" |  Address 
| style="border: 2px solid black;" |  Purpose
|-
| style="background-color:#66cccc; border: 2px solid black;" |  (your existing host / source) 
| style="background-color:#66cccc; border: 2px solid black;" |   External Facing Address:''' DHCP assigned'''<br>Internal Virtual Bridge (virbr1):''' 172.17.40.1''' 
| style="background-color:#66cccc; border: 2px solid black;" |  Your '''host''' machine

|-
| style="background-color:#66cccc; border: 2px solid black;" |  '''minnow.species.lake.ops''' 
| style="background-color:#66cccc; border: 2px solid black;" |  '''172.17.40.100'''  
| style="background-color:#66cccc; border: 2px solid black;" |  '''Cloning-source''' used to create other servers for other assignments.
|}



<ol><li value="5">Make certain your cloning-source can connect to the Internet using the newer static configuration.</li><li>Run a '''yum update''' for this cloning-source.</li><li>Make certain that SELinux is set to '''enforcing'''.</li><li>Set up an SSH server on this "cloning-source".</li><li> Make sure that '''PermitRootLogin''' is set to '''yes''' for this server.</li><li>Make certain that only the root account is permitted to login using key authentication. If other users are required to be created in a later assignment, they should be permitted to log in with their username and password.</li><li>Copy the same public key (already generated for your '''Host Machine''' for your '''root''' account in lab1) to the '''root''' account on your cloning-source.</li><li>Test to make certain that you can login from root on your host machine to your root account on the cloning-course ("minnow") without being prompted for a pass-phrase.</li><li>If you have created a '''regular user''' when you installed this machine, '''delete that regular user''' (make certain to '''remove the regular user's home directory!''').</li></ol>

=== Set-up Firewall Rules for your Cloning-Source===

Perform the following steps for this section:

# Make certain that you have '''iptables''' services enabled and running instead of ''Firewalld''. 
# Modify the '''iptables''' to meet the following conditions:
::<ul>
:::<li>All outgoing traffic is allowed.</li>
:::<li>Responses to any traffic the machine sends out are allowed.</li>
:::<li>Traffic on the loopback interface is allowed.</li>
:::<li>The host machine (and <b>only</b> the host machine) must be able to ssh to that cloning-source VM.</li>
:::<li>ICMP traffic is allowed if it originated with the <b>local network only</b>.</li>
:::<li>As this is acting as the secure basis for later machines, no other traffic should be allowed.</li>
::</ul>

=== Create Full and Incremental Backups of cloning-source VM===

Perform the following steps for this section:

# This task is to be performed in your '''host''' machine.
# Issue the command '''su -'''
# Create a Bash shell script called '''/root/bin/assnBackup.bash''' to perform a '''full backup''' using the '''gzip''' command to backup the entire file system of your cloning-source VM to save the compressed copy to the directory path: '''/backup/full/'''). 
# This shell script should store each of any number of VM image files in the '''/var/lib/libvirt/images''' directory that has the extension ".qcow2". In this way, this shell script will safely backup any new VMs that are created later in this course, yet backup the existing labs and assignment VMs.
# Perform a Net-search to use the '''pv''' (''pipe-viewer'') command to show a text-based indicator of backup for EACH VM image file. You need to add the '''EPEL repository''' to install the pv command.
# Set execute permissions for this script, and '''run this Bash shell script prior to exiting your assignment work session to properly backup your cloning source'''. You should also make a copy of the backup on an external device (such as a USB key).
# Set-up via a crontab entry, an '''incremental backup''' of the '''/etc/''' directory of your cloning-source to be performed every hour to the '''/backup/incremental/cloning-source''' directory.

== Assignment Submission ==

The student is required to prove to their professor that their set-up works correctly during the regularly-scheduled lab period. 

===Assignment Evaluation Details===

*'''Demonstrate working assignment to your instructor in class:'''<ol type="a"><li>Students need to demonstrate their assignment functionality to their professor during a lab period (like you would for any lab for "sign-off").</li><li>Students are required to prepare everything ahead of time so that you can quickly demonstrate to your instructor that all required parts of your assignment are working.</li><li>'''Do not proceed to the next step''' until you have demonstrated your assignment to your instructor to check for errors that may cause problems when running the checking script.<br><br></li></ol>

*Download and run a shell script to check your work (Depending on your OPS335 Instructor):


::'''Peter Callaghan's Classes''' (Section '''D'''):<ul><li>Refer to instruction on blackboard for instructions on how to submit this assignment.</li></ul>


::'''Murray Saul and Colin Yips Classes''' (Sections '''A''' , '''B''' &amp; '''C'''):<ol><li>Login as '''root''' on your '''host''' machine.</li><li>Change to the '''/root/bin''' directory.</li><li>Make certain that your '''cloning-source, primary DNS and secondary VMs are running'''.</li><li>Make certain that the mailx command has been installed. If not, issue the following command to install e-mail on your '''host''' machine:<source>yum install mailx </source><li>Issue the command to download a checking script for your assignment to your '''host''' machine:<br><br>'''Murray Saul's classes (section A): &nbps; &nbsp; ''' <span style="font-family:courier;font-size:1.5em;color:black">wget https://matrix.senecacollege.ca/~murray.saul/ops335/check-assn1-p1-murray.bash</span>'''<br><br>'''Colin Yip's classes (Section B &amp; C):''' '''TBA'''<br><br>Set execute permissions and run the shell script.<br>(Your shell script contents will be mailed to your Seneca email and to your OPS335 instructor's Seneca email.<br><br>If you do '''NOT''' receive an e-mail message in your Seneca email account, then there is a problem, and you '''MUST''' rerun or contact your OPS335 instructor immediately.

==Evaluation Rubric==

Here is an evaluation rubric (in table form) showing you how you will be evaluated for this assignment.
Part of the rubric is marked from professor observation from student demonstration of assignment in class, and the other part is based on output from the results of an assignment checking script that the student will download and run.

{| class="wikitable" width=50%
|-
| colspan=2 style="text-align:center;background-color:#cccccc;" |'''Student Demonstration (in class)'''
|-
| style="font-weight:bold" | Evaluation Item 
| width=10% style="text-align:right;font-weight:bold" | Mark
|-
| Created Virtual Network: '''335assign'''<br>(correct settings)  
| style="text-align:right" | /1
|-
| Can '''ping cloning-source from host machine''' with '''correct IPADDR'''
| style="text-align:right" | /1
|-
| root account on host machine can '''connect to cloning-source VM''' via ssh application '''without''' password
| style="text-align:right" | /1
|-
| cloning-source VM can connect to the Internet<br>(i.e. '''ping 8.8.8.8''')
| style="text-align:right" | /1
|-
| cloning-source can SSH to student's '''Matrix''' account
| style="text-align:right" | /1
|-
| colspan=2 style="text-align:center;background-color:#cccccc;" |'''Configuration (Checking Script Output)'''
|-
| style="font-weight:bold;" | Evaluation Item 
| width=10% style="text-align:right;font-weight:bold" | Mark
|-
| Hostname set to: '''minnow''' only, domain name '''species.lake.ops''' set as a network parameter  
| style="text-align:right" | /1
|-
| '''yum update performed'''  
| style="text-align:right" | /1
|-
| '''No regular users on cloning source''' (just root)  
| style="text-align:right" | /1
|-
| SELinux status set to: '''enforcing'''  
| style="text-align:right" | /1
|-
| firewalld '''stopped''' and '''inactive'''
| style="text-align:right" | /1
|-
| iptables '''active''' and '''enabled'''
| style="text-align:right" | /1
|-
| iptables - '''All outgoing traffic is allowed'''
| style="text-align:right" | /1
|-
| iptables - The '''host machine''' (and only the host machine) must be '''able to ssh to the cloning-source'''
| style="text-align:right" | /1
|-
| iptables - '''ICMP traffic is allowed''' if it originated with the '''local network only'''
| style="text-align:right" | /1
|-
| iptables - Other unexpected '''INPUT''' traffic is blocked
| style="text-align:right" | /1
|-
| iptables - all '''FORWARD''' traffic is blocked
| style="text-align:right" | /1
|-
| '''correct static network configuration for cloning-source VM'''<br>(half mark for each network config item)
| style="text-align:right" | /5
|-
| permitRootLogin set to '''yes''' for cloning-source VM
| style="text-align:right" | /1
|-
| Backup script '''assnBackup.bash''' structure
| style="text-align:right" | /2
|-
| Proof that '''VM full backup''' was run
| style="text-align:right" | /2
|-
| '''Crontab entries executed properly'''
| style="text-align:right" | /2
|-
| '''Incremental Backup''' of '''/etc/''' directory of cloning-source to '''/backup/incremental/cloning-source''' directory
| style="text-align:right" | /2
|-
| '''TOTAL''' 
| style="text-align:right" | '''/30'''
|}

[[OPS335 - Assignment 1 (Part 1)]]