= THIS PAGE IS A DRAFT, NOT A REAL COURSE PAGE = ''' The current schedule for OPS345 is here: [[OPS335_Weekly_Schedule]] In the last lab we created the '''ww''' instance:* With a static private IP (10.3.45.11)* We set up port forwarding for the SSH protocol so that incoming TCP packets to port 2211 on router are forwarded to TCP port 22 on ww. Before you get started with the storage configuration, install '''httpd''' using yum on ww. You don't need to start the service at this point. Just install it. = Storage for the web server = In this lab we'll configure ww to function as a web server. The most important piece of learning in this lab is managing one type of storage available on AWS: '''Elastic Block Storage (EBS)'''.  An EBS volume looks like any other block storage device (e.g. a harddrive partition) to an operating system in an AWS instance. But of course it's not a partition or a harddrive or an LVM logical volume, its actual implementation details are internal to AWS and of no concern to us, the users. The concept should be familiar to you because it's so similar to how in OPS245 you've created a virtual harddrive in VMware and attached it to an existing VM. == Create and attach EBS device == * First go to Volumes under Elastic Block Store. Notice that some volumes are already there. These are the virtual harddrives which your existing VMs have been installed on, where they store all the operating system files, the contents of the home directories, and anything else "on the harddrive".* Click "Create volume". [[File:AWSCreateVolume.png|800px|border|center]] * Don't neglect to click the "Info" link on each option. Remember that even though it may sound incomprehensible at first: you will pick up some knowledge every time you read this stuff, and eventually this will become easier to understand.* Set the size to '''1GB'''. This is the minimum allowed and is more than enough for what you need.* Set its Name to '''www-data'''.* Now you need to attach it to the ww VM.  [[File:AWSAttachVolume.png|800px|border|center]] The name of the device doesn't really matter. Mine turned out to be /dev/sdf. Note that you don't need to shut down your VM nor even reboot it. The action you performed is the equivalent of plugging in a hot-pluggable storage device into a Linux desktop or laptop. * In your ww terminal check that the new device showed up and is the correct size: [[File:AWSVolumeAttached.png|800px|border|center]] At this point you have a new block storage device of 1GB plugged into your box, but it is not currenty being used. Hopefully you paid attention in the OPS245 LVM labs because this is the same stuff, just in the cloud instead of a local hypervisor. == Use your new EBS device as a LV == It should not be difficult to imagine that your web server might run out of storage space if it only has 1GB available. How much work would it be to recreate the entire machine, reconfigure it, move all the files over, and do that without too much downtime? In order to avoid all those problems you use LVM. The storage for your web server will be on a Logical Volume, on a separate EBS device than the operating system. If you run out of space: all you have to do is add another EBS device, and extend the logical volume to use the space on that new device as well. Exactly like you did in OPS245. * Create a volume group '''vg_www''', and add /dev/xvdf to it as a physical volume.* Then create a logical volume '''lv_www''' and allocate all the space from /dev/xvdf to lv_www.* Double-check with blkid and ls that your new logical volume has been created.* Format that logical volume as ext4. [[File:AWSCreateLV.png|800px|border|center]] == Mount your new LV on /var/www == * Mount your new filesystem on /var/www. You should not get any errors or surprises: [[File:AWSTestMountingLV.png|border|center]] * That looks good in the screenshot. We don't need any of the contents that were originally in /var/www, so we'll set up the /dev/mapper/vg_www-lv_www device to mount automatically onto the /var/www directory every time the machine boots up. Add this to the end of '''/etc/fstab''': <source>/dev/mapper/vg_www-lv_www /var/www ext4 defaults 0 0</source> * And test to make sure that it worked: [[File:AWSMountLVPermanently.png|border|center]] Don't reboot the machine if the following testing fails. You might end up with an unbootable VM, and you'll have to restart from the end of the previous lab. * Once you're comfortable that your fstab isn't broken and your logical volume mounts properly: reboot ww and confirm that everything still works. = Set up access to the web server = Now that you have a web server set up with proper storage, it's almost time to test it using a web browser. == Make a simple PHP webpage == First create a simple php webpage. * Look for the '''DocumentRoot''' setting in /etc/httpd/conf/httpd.conf. Note that it's set to '''/var/www/html'''* Create this directory.* Then create a plain-text file '''/var/www/html/index.php''' with the following contents:<source>Hello. My web server still works.<br />If this shows the current date and time, PHP works too:<br /><?php system("date"); ?></source>* As a general security practice you should not work on web pages as root. Change the ownership of the html directory and its contents so that your user can have full control of the website stuff.* Then start Apache and test your webpage by connecting to your server from your server using '''links''' as a client: [[File:AWSTestApacheLoopback.png|800px|border|center]] Note that this is a webpage, and it's loaded from localhost which means the web server works, but it's not the webpage you created (you can quit links with the 'q' key): [[File:AWSPHPMissing.png|800px|border|center]] The problem is that we created an index.php file which will load by default if your web server has the PHP module installed, but we didn't install that. * You can view your PHP page by specifying the path to it explicitly in the address:<source>[asmith15@ip-10-3-45-64 ~]$ links http://localhost/index.php</source> [[File:AWSPHPMissing2.png|border|center]] * That's better but still not quite right. Install the missing package ('''php''') and restart Apache. It should finally work: [[File:AWSPHPWorks.png|border|center]] == Port forwarding for HTTP == The links application is useful for basic testing but it's not how you want people to access your websites. You want them to use a proper web browser like Firefox. But in order for that to work: your web server needs to be accessible from the internet, so let's make it accessible via your router's IP address, using port forwarding (same idea as your SSH setup, but for port 80). * On the router VM add a new iptables rule to forward incomping TCP packets for port 80 to www:<source>iptables -t nat -I PREROUTING -p tcp --dport 80 -j DNAT --to 10.3.45.11:80</source>* Don't forget to save the new set of iptables rules.Remember that there are also security groups with rules that block access to ports. * Add a rule to ops345routersg to allow incoming access to port 80 from anywhere.* Add a rule to ops345wwsg to allow incoming access to port 80 from ops345routersg only.* Test your setup by connecting to your router's public IP address using Firefox on your workstation:[[File:AWSHTTPForwardingWorks.png|800px|border|center]] == Make a proper PHP webpage == OPS345 is not a web development course, but you should learn a couple of basic things about websites. # An HTML page (which is what your php file generates) really should follow a basic set of rules, even though technically it doesn't have to. The example below is a correctly structured HTML file.# While PHP is primarily used by programmers, you can make good use of it too. In the example below it's used to query your instance's metadata that AWS has but the instance itself does not. * Replace your current contents of /var/www/html/index.php with this:<source><html><head><style>body {background-color: powderblue;}table {border-spacing: 1cm 0cm;}h2 {color: blue;}th {text-align: left;}p {color: red; font-weight: bold;}</style></head><body>Hello. My web server still works.<br />If this shows the current date and time, PHP works too:<br /><br /><?php system("date"); ?><h2>Instance Info</h2><table><tr><th>Configuration</th><th>Value</th></tr><tr> <td><p>Private IP</p></td> <td><?php system("curl http://169.254.169.254/latest/meta-data/local-ipv4"); ?></td></tr><tr> <td><p>Public IP</p></td> <td><?php system("curl http://169.254.169.254/latest/meta-data/public-ipv4"); ?></td></tr></table></body></html></source>* No need to restart anything after you modify a webpage. Just reload it in Firefox. It should look like this: [[File:AWSMetadataViaPHP.png|border|center]] * Try to see if you can find the public IP address you see in the webpage in the ww terminal. The '''ip address''' command won't help.* If you feel curious you can see what other metadata you can get via http://169.254.169.254 [https://docswiki.awslittlesvr.amazon.comca/AWSEC2wiki/latest/UserGuide/instancedata-data-retrieval.html here] = Remove public IP from the web server = Since your web server is accessible from anywhere on the internet - there's really no reason why it should have a public IP at all. OPS345_Lab_3 This will be an opportunity for you to learn to plan in advance as much as you can. * In the AWS EC2 web console navigate to the configuration for ww's network interface ww-nic.* Do click on every option you can find, look for a way to remove ww's public IP address: [[File:AWSCantRemovePublicIP.png|800px|border|center]] Strangely the option to remove a public IP from an instance which was intitially configured to have a public IP assigned automatically doesn't exist. Perhaps it will be added in the future (AWS does add features all the time), but at this time you just can't do it. That means we'll have to rebuild the ww VM. That's why we called it ww instead of www. Don't get annoyed, keep these two things in mind: # They say practice makes perfect. Perfection is not expected from you, but practice will make you more comfortable and more able to take on more complex problems. Yes, you'll have to redo some of the work. That's a good thing. It means more practice and you will benefit from it.# You won't need to redo ''everything''. You'll find that you can keep much of the work you completed because your website was stored on a logical volume on an extra EBS device, separate from the main ww storage device. == Rebuild ww into www == ** Terminate www, rename it to www-deleted.** Modify subnet to not auto-assign public IPs.** Recreate the www instance with the same steps, except specify a primary ip.** Install httpd, php** To get yum install to work, allocate a new elastic ip "temporary" and associate with www == Reconnect www-data == ** Note that www-data was not deleted when the original www was terminated. Attach it to www now.** All the data on the logical volume is still there, but fstab is gone, add lv-www back into there.** Start httpd, everything should be back to as it was. == Disasociate the public ip from www == ** Disasociate the public ip. Everything should keep working.** Release the elastic ip.* Add a 404 check for missing ip:<source><?php system("curl http://169.254.169.254/latest/meta-data/public-ipv4 2>&1| grep -q '404 - Not Found'", $rc); if ($rc == 0) echo "None found";else system("curl http://169.254.169.254/latest/meta-data/public-ipv4");?></source>* Move www to ops345sgprivate, and add port 80 from ops345sg as a second inbound rule there. = Submit evidence of your work = For this lab, please submit screenshots that show you've completed the work, unless your professor page has given you different instructionsmoved. As a minimum that's: *  [[Category:OPS345]]