Changes

== OBJECTIVE & PREPARATION==

In this This lab, we will look at several separate technologies that are used with 's primary focus is to set up a Samba server on a Linux server in order to allow MS Windows users to share common files from the Apache web Linux's Samba server to install, configure and run web applications.

The basic purpose of the Apache web server is to serve text pagesThis lab will first install, imagessetup, and other static enable a Samba server. Then users will access files. You can format those web-pages to appear nice, but they would lack dynamic functionality on the Linux Samba server from Linux and Windows client machines (i.e. the ability to change colors or font-size when the mouse moves over a link, button, etcboth graphically and command line). In other words using Apache web-server as a sole application would not make your web-pages more interesting.

If we want to add more features for our web-page (eg. dynamic functionality, security, e-commerce, etc), your webserver would need additional help. To provide additional help requires several resources - more than just the web server itself. ==INVESTIGATION 1: INSTALLING & CONFIGURING A popular acronym to represent these foundations and servers is referred to as '''LAMP'''. It stands for '''Linux''', '''Apache''', '''MySQL''', and '''PHP''' (or ''Python'').SAMBA SERVER==

In your previous OPS235 course, your second assignment may have required you setup a similar series of services in order to run a Wiki on one of your virtual machines. In this labinvestigation, we will set up another example of a '''"LAMP solution"Samba server''' on our ''' that VM2''' machine. We will allow first install, configure and enable the user samba server on our virtual machine, and then we will quickly test to run webmail in a web-browser to send and receive e-mail messagessee if the Samba server works.

# Create another virtual Make certain that both your '''VM1''' and '''VM2''' machines are running.#Switch to your '''VM2''' machine called as the '''vm4root''' from scratch (only a minimal setup is needed)user. If you forgot how #Issue the following Linux command to do this, refer to [httpinstall Samba server utlity://zenit.senecac.on.ca/wiki/index.php/OPS335_Installation_Lab#VM_Installation Lab1].<br>'''yum install samba samba-client'''<br>#Copy the file '''For Interest:/etc/samba/smb.conf''' As an optional exerciseto another filename by issuing the following command: configure all your network settings (except the firewall) using the installation wizard during installation static IP<br>(the address '''192cp /etc/samba/smb.168conf /etc/samba/smb.Xconf.5original'''#Clear the contents of the configuration file by running ''' should be available)cat /dev/null > /etc/samba/smb.<br><br>conf'''# Configure your Edit '''vm4/etc/samba/smb.conf''' virtual machine in so that the same way file that you've configured contains the other three main VMs. This should be a quick exercise for you by now, includingfollowing lines:::* The Linux installation [global] workgroup = WORKGROUP server string = "put your real name here without the quotes" encrypt passwords = yes security = user passdb backend = tdbsam [home] comment = "put your real name here without the quotes" path = /home/<yourSenecaID> public = no writable = yes printable = no create mask = 0765 [homes] comment = automatic home share public = no writable = yes printable = no create mask = 0765 browseable = no<ol><li value="3">Append (minimum installadd)::* If you didn't setup the network configuration during installation, make certain following parameter to connect the bottom of the '''[global] section''' that will limit access to the correct share so that only machines in your virtual network with a static IPwill be able to access it:</li><br/ol>(the address hosts allow = 192.168.Xx. 127.0.0.5 should be available),1::* Making sure you're using your internal DNS server <ol><li value="4">Append (make reference add) the following parameter to vm4's IPADDR for domain resolution)::* Configuring default rules for your iptables firewall (hint: use saved shell scripts)::* Allowing passwordless login from the host's root account (for future backups)::* Disabling ''[home] section'selinux''' since you don't know how to configure it properly.so that only your user account can access that share:</li><br/ol> valid users = <bryourSenecaID><ol><li value="35">Test your Create a Samba account and password for yourSenecaID by issuing the following command:<br>'''vm4smbpasswd -a <yourSenecaID>''' virtual machine to make certain that it functions correctly.</li></ol>

=== Install{{Admon/tip|Changing Existing Samba Account Passwords|If you need to change a user's existing Samba account password, Configure & Run a Webserver (Apache) ===you can issue the following command as root: '''smbpasswd username'''.}}

Next<ol><li value="6">Confirm the user you created has been added using the following command:<br>'''pdbedit -L -v'''</li><li>Test and review your configuration with the command:<br>'''testparm'''</li><li>Use the '''systemctl''' command to start the smb.service and enable the service to run on boot-up</li><li>If you have SELinux set to enforcing, since we you'll will be need to tell it to allow samba access to home directories by running: <br> '''setsebool -P samba_enable_home_dirs 1'''</li><li>Use the '''ss -nautp''' command to see with port Samba is running a webmail applicationon.</li><li>Use the information in the previous step to modify the firewall on VM2 machine to allow samba traffic.</li><li>Test to see that you can connect to your Samba server (locally) by issuing the following command:<br>'''smbclient -U <yourSenecaID> -L 127.0.0.1'''</li><li>When prompted, enter your Samba account password.</li><li>The output from that issued command show appear similar to example displayed below:</li></ol> Sharename Type Comment --------- ---- ------- home Disk Your Name IPC$ IPC IPC Service ("Your Name") Domain=[WORKGROUP] OS=[Windows 6.1] Server=[Samba 4.2.3] Server Comment ------ ------- WorkGroup Master --------- ------ <ol><li value="13">To access the Samba client shell on your local Samba share, we need issue the following command:<br>'''smbclient '\\127.0.0.1\home' -U <yourSenecaID>'''</li><li>Enter your Samba account password.</li><li>Issue the help command to installnote common commands (''dir'', ''cd'', ''ls'', ''put'', configure and run a webserver on our Linux VM''get''). Note how similar they are to ''sftp'' commands.</li><li>Enter '''exit''' to terminal your local Samba session.</li></ol>

{{Admon/tip |Apache Webserver Resources|Apache web-server configuration You can be use smbclient to access, browse and share files within other Linux and Windows servers using a very complex topic (covering an entire course!). Although this lab focuses only on one small application variety of a web-server, you can refer to the following link to refer to additional configuration help: [http://www.hitmill.com/computers/apache.htm Apache Resources]tools which will be demonstrated in Investigations 2 and 3.}}

'''Perform the following Record steps:''' #Make certain you are in your '''VM4''' machine.#Install the Apache package (the name of the package is: '''httpd''').#Start the httpd service, commands, and enable this service to start automatically upon system startup.#Make certain to configure your firewall to allow access to the httpd service (i.e. the Apache serves HTTP traffic which goes over TCP port '''80''').#Open a web-browser in your '''host''' machine and enter the following URL: '''vm4.youruserid.org'''.<br>If you setup your Apache webserver correctly, you should be able to view the Apache Test page.#Delete the file '''/etc/httpd/conf.d/welcome.conf''' to remove the default webpage.#Although we will not be exploring webservers observations in depth, we will have you create a simple webpage for testing purposes, then later setup a web resource for webmail.#The term'''DocumentRoot''' specifies where the Apache webserver will search for documents to serve. Create the file '''index.html''' INVESTIGATION 1 in your OPS335 lab log-book'''DocumentRoot''' directory with the following contents (replace the date with the current one):

<pre>Hello, this is a web page on vm4.yourid.org and the current time is Mar 28 22==INVESTIGATION 2:16:27 EDT 2016!</pre>CONNECTING TO A LINUX SMB SERVER FROM A LINUX CLIENT==

<ol><li value="9">If In this investigation you refresh your web-browser page in Firefox, you should see the contents will explore some of your ''index.html'' document. If you wish, you can specify the filename index.html in the address, but it is not necessary, since the file index.html is automatically loaded by default when the URL refers different ways to that access a shared directory containing that filefrom a Linux client machine (VM1).</li></ol>

<ol><li value="10">Refresh your web#Install the '''samba-page by issuing the keycombination: client''' and '''ctrlcifs-rutils'''packages. Notice that #Use the time doesn"smbclient" command in a terminal window.<source> smbclient 't change as \\vm2\home' -U <yourSenecaID></source>#After entering your password you should get a prompt similar to:<source> smb: \></source>#Enter the ls command to see a list of the files in your home directory:<source> smb: \> ls</source>#Once you refresh have access to the page. This indicates that directory use the page is static get and put commands (not dynamicsimilar to ftp) indicating that to move files.#When you are finished close the page does not change (i.e. boring!)connection.# Try again using '''[homes]''' share instead<source> smbclient '\\vm2\homes' -U </liyourSenecaID></olsource>

=== Creating Note that this tool only gave temporary access with a PHP Script ===limited set of commands.

In order to allow us to run a webserver application in a web=== Using 'mount -browser, we need a scripting language that will allow the web-browser to function dynamically (i.e. being able to change frequently, as opposed to being "static" or unchanging). In this section, we will demonstrate how a scripting language (PHP) can be used for the web-browser to react in a more dynamic fashion.t cifs' ===

{{Admon/tip |PHP Scripting Language|PHP code is considered Instead of always having to be a language that runs on use the web-server (i.e. "server-side programming"). PHP code smbclient command to connect to your network share, you can be embedded in an HTML document (HTML code), and use the resources on have the "share automatically mounted upon your file serverboot-side" to make the web document or resource more dynamic (eg. database access, etc). Although it is not the purpose of this course to learn about and create PHP documents, here is a quick resource on PHP: [http://www.w3schools.com/php/defaultup.asp PHP Tutorial]}}

#Replace our '''index.html''' file with an 'Perform the following steps on your VM1''index.php''' with the following contents:

#Issue the following commands to create a mount-point and to mount your home directory from your vm2 machine:<presource>Hello, this is a web page on vm4.yourid.org and the current time is mkdir /tmp/vm2-home mount -t cifs //vm2/home /tmp/vm2-home -o username=<?php system("date"); ?yourSenecaID>! ls /tmp/vm2-home</presource>#Create a file in that directory, then switch to '''vm2''' to confirm that it was created.#Use umount on '''vm1''' to unmount that directory.

=== InstallNote that this tool would leave the directory mounted until the machine rebooted or it was manually unmounted. It would also allow other users access to the directory, Configure and Run MySQL Database Server ===as it effectively became part of the local filesystem. It could even be added to fstab to be mounted on boot (though this would require another configuration file we don't cover).

MySQL is used This investigation will configure your VM2 machine to allow storage and retrieval of structured data. SQL is act as a command language (used by scripting languages such as PHP) Samba File server to allow programmers to Windows OS Users access databases contained within a server (or other servers via a network) to be used within web-based applications via the web-browserLinux Samba server files.

We won't spend much time learning the details of MySQL configuration but you need ===Accessing Files on a basic server set up. You may remember when setting up MySQL from OPS235 - it is basically the same concept.Linux Samba Server via Windows Explorer ===

{{Admon/tip |MySQL / SQL Language Resources|AgainWith some additional "tweaking" to your Linux Samba server configuration file, MySQL can you should be able to access files on that file from a complex topic: Seneca has an entire course that concentrates Windows machine on using SQL commands! Here is the same network. You will be creating a link to MySQL / SQL Language resources: [http://www.w3schools.com/sql/ MySQL / SQL Language Resources]Samba share for your home directory of your regular user account.}}

'''Perform the following stepstasks:'''

#Install '''MySQL''' (you may notice Make certain that ityour 's actually called ''VM2'MariaDB''' now).<br><br> The MySQL and MariaDB are actually two <u>separate</u> projects run by different groupsmachine is running, yet they are compatible; thereforeis still allowing samba traffic through the firewall, you can use documentation from one to configure and is still running the othersamba service. <br><br>#'''NOTE:''' When installing mysqlUse the Windows machine you are already running Vmware on. If you have a Linux host - good for you, make certain that you have not just the '''client''' but also the '''server software'''can either use a Windows VM or skip this part.#When you start Add the MySQL service, you will receive get some instructions contained in the log file regarding how prerouting and forwarding rules to set the root password. Even though we will not configure our MySQL service your host's iptables necessary to be accessible over the redirect samba traffic from outside your networkto your VM2, it is accepted as a "best practice" configuring for making sure to replace the X with your own network access for each MySQL installationaddress.#Note that the MySQL service has two root passwords::<ulcode>iptables -I FORWARD -p tcp --dport 139 -d 192.168.X.3 -j ACCEPT<li/code>For the localhost::<code>iptables -I FORWARD -p tcp --dport 445 -d 192.168.X.3 -j ACCEPT</licode>::<licode>For external requestsiptables -t nat -A PREROUTING -p tcp --dport 139 -j DNAT --to-destination 192.168.X.3</licode>::<code>iptables -t nat -A PREROUTING -p tcp --dport 445 -j DNAT --to-destination 192.168.X.3</ulcode>#Refer to OR with specifing the log file interface (whichever works):::<code>iptables -t nat -A PREROUTING -i *externalinterface* -p tcp --dport 139 -j DNAT --to learn how -destination 192.168.X.3</code>::<code>iptables -t nat -A PREROUTING -i *externalinterface* -p tcp --dport 445 -j DNAT --to run the two commands in order to generate the appropriate passwords-destination 192.168.X.3<br/code>where *externalinterface* is an interface name (e.g. ens33)<br>'''NOTE: Use a password ''' when you make up yourselfrestart libvirtd, but do <u>not</u> generate a secret passwordit will move your FORWARD rules to the end of the chain, since you will be storing that password in a plain text file for later referenceinvalidating them.#If you have performed Modify the steps in INVESTIGATION 1 correctly, then we can proceed '''hosts allow''' setting on your '''vm2''' to also accept connections from the windows machine you are using.# Open the next investigation to install, configure and test-out accessing encrypted email messages (performed in labs 4b, 4c, and 4d), but use a convenient webmail Windows File Explorer application via any web-browser.# At the top of the application, enter the following:<br>'''\\EXTERNAL_IPADDR_OF_HOST\home'''

 '''Record steps, commands, and your observations in INVESTIGATION 1 in your OPS335 lab log-book'''  == INVESTIGATION 2: INSTALL, CONFIGURE &amp; RUN WEBMAIL APPLICATION (Roundcube Mail) =={|cellpadding="15" width="40%" align="right" cellpadding="10"

||width="10%" | [[Image:Roundcubesamba-login.png|thumb|right|200px300px|You will be prompted (once only) for the Samba user-name and password for your '''RoundcubeVM2''' webmail application Logo<br>GPL,<br> https://commonsmachine).wikimedia.org/w/index.php?curid=1772791]]||width="10%" |[[Image:roundcubesamba3-picmap-drive.png|thumb|right|300px|Screencapture of You can create a '''roundcubemapped network drive (z:)''' webmail application running in order to send and receive mail messages via a web-browserfor your Linux Samba server network share).]]  

In <ol><li value="5"> You will be prompted to enter your samba username and password (one time only). Refer to screenshot on right.<br><br>'''NOTE:''' It may take approximately 30 seconds to display the file contents.<br><br></li><li>Were you successful? You should have received an error stating the your credentials are incorrect. You will notice that it adds SENEDS to the beginning of your user name, as the Seneca machine is pre-configured to be part of that workgroup.</li><li>Change the investigationworkgroup parameter in smb.conf on VM2 to match the seneca domain SENEDS, we will simply installand try to connect again.</li><li>Were you successful? If not, try to troubleshoot the problem first, then ask your lab assistant or instructor for assistance.</li><li>Close the Windows File Explorer application window.</li><li>Click on the '''START''' menu, configure and run click on '''This PC'''.</li><li>Click on the Map Network Drive button, and create a '''mapped network drive'''roundcube(called it drive ''' webmail applicationZ:''') which is a Samba share of your VM2 machine for the home directory.</li><li>When finished, click on '''Network''' in Windows file manager to confirm that the network share is present.</li><li>Try to create a file on Windows on your Linux Samba machine. Were you able to create a save a file?</li><li>Switch to your VM2 machine and check to see if that file was created in your home directory.</li></ol>

{{Admon/important |Backup your VMs!|You MUST perform a '''Perform the following steps:full backup''' of ALL of your VMs whenever you complete your '''OPS335 labs''' or when working on your '''OPS335 assignments'''. You should be using the dump or rsync command VMs.}}

#Perform a search on the roundcube application in order to access the website.#Either Download the "zipped tarball" from their website from a direct link or use the wget command to download directly from a download link (This part may take some effort depending on the Sourceforge website).#Extract the "zipped tarball" and rename the generated directory that contains download source code to: '''webmail'''.#In the directory now named "webmail"Record steps, commands, there will be a file named '''INSTALLand your observations from this INVESTIGATION in your OPS335 lab log-book''' which will walk you through the rest of the Roundcube installation.<br><br>Some installation tips to consider:

::* Be careful about copying &amp; pasting the MySQL setup part: take time and pay attention to detail: do not try ==COMPLETING THE LAB==In completing this lab you have gained experience using a service that allows remote access to "rush it"files stored on a Linux server.::* You will need have also learned how to install use several additional Apache modules including: '''php-xml''', '''php-pdo'''different tools to access those files, both from a Linux and '''php-mysql'''Windows client.::* Don't forget to set the password in the roundcube configuration.

<ol><li value="3">Note that both of your IMAP and SMTP servers are ==Online Submission===Follow the instructions for lab 5 on different machines (iblackboard.e. not on vm4). Therefore, you will need to set the following options for Roundcube:</li></ol>!--===Andrew's sections===

You may choose to::* '''$config['smtp_server']'''::* Submit screenshots of your work on Blackboard, in which case you don'''$config['default_host']'''::* '''$config['default_port']''' :::'''NOTE:''' The last <u>two</u> entries above refer t need to your IMAP server <ol><li value="4">You should be able come to test the configuration in your Roundcube installer after completing Step 3lab.</li><li>Try * Or come to test if the roundcube webmail application is working by sending and receiving e-mail messages.</li></ol> '''Record stepslab, commandsshow me your work, and your observations in INVESTIGATION 2 in your OPS335 lab log-book''' == COMPLETING THE LAB == '''Depending on your professor you will either be asked talk to submit the lab in class, or online. Follow the appropriate set of instructions belowme about it.I want to hear what you''' ===Online Submission===Follow the instructions for lab 3 on moodleve learned and answer any questions you have.

===In Class Submission===Students should be prepared with You'''all required commands (system information) displayed in a terminal (or multiple terminals) prior ll get the same grade regardless of how you choose to calling the instructor for signoff'''submit your work.

::<span style="color:green;font-size:1.5em;">&#x2713;</span> Proof of network share of VM2 machine from Windows VM via Windows Explorer application::<span style="color:green;font-size:1.5em;">&#x2713;</span> Firewall settings on your Windows VM to allow Linux Samba network share::<span style="color:green;font-size:1.5em;">&#x2713;</span> Display contents of '''Arrange evidence /etc/samba/smb.conf''' file on VM2 machine::<span style="color:green;font-size:1.5em;">&#x2713;</span> Firewall exceptions (command outputboth machines) for each of these items on your screen, then ask your instructor to review them allow Samba traffic::<span style="color:green;font-size:1.5em;">&#x2713;</span>Download and sign off on the labrun '''s completionhttps://ict.senecacollege.ca/~andrew.smith/ops335/labcheck5.bash'''::<span style="color:green;font-size:1.5em;">&#x2713;</span>Completed Lab5 log-book notes.-->

::<span style="color:green;font-size:1.5em;">&#x2713;</span>Your webmail showing your inbox::<span style="color:green;font-size:1.5em;">&#x2713;</span>Your webmail sending an email out::<span styleEXPLORATION QUESTIONS=="color:green;font-size:1.5em;">&#x2713;</span>You receiving that mail on an exernal account

# What does the term LAMP SMB stand for? Briefly describe the purpose of each of the following items in LAMP.# How What does a webmail application differ from using another MUA like ThunderbirdCIFS stand for?# What is the major difference between a static web document and a dynamic documentpurpose of the '''testparm''' command?# What does the term "server-side programming" mean?# What is text inside square brackets in the purpose of creating and using an index'''smb.html conf''' filemean?(e.g., "[home]").# What is Explain the purpose meaning of creating and using an indexthe line "create mask = 0765" in the smb.php conf file?# List the additional Apache modules that are required in order to run What does the Roundcube web application'''smbpasswd''' command do?