View source for FAQ - Mod 2

Welcome to the frequently asked questions page for Module 2. As many common questions can come up on Piazza, some of those questions are consolidated here.

== Permissions ==

=== Help: I need to edit a readonly file! ===

When attempting to edit a readonly file, the terminal will throw the following warning message.
<source lang="bash>
W10: Warning: Changing a readonly file
</source>
This error often surfaces for the first time when attempting to edit UserDir for the first time, as is instructed for setting up Apache. If you have set the correct permissions (as designated by the wiki) and are still running into an error, you likely need to edit the file with the "sudo" command, as shown below.

<source lang="bash>
$ sudo vi <filename>
</source>

as opposed to

<source lang="bash>
$ vi <filename>
</source>

Placing sudo before a command allows you to run the command with the permissions of the root user. The root user is able to access any file, so running as sudo should allow you to write to a readonly file. '''Before using sudo to run a command, always check that you have set the correct permissions as stated by the wiki. If you do not, using sudo once will not fix permissions issues down the line.''' We see plenty of permissions questions on piazza every year; 90% of the time these are due to students not reading the wiki in full when configuring Apache, SFTP, etc.

=== What is the password to login to the root user on my EC2 instance? ===

When attempting to login to the root user using "su," you might find yourself prompted to enter a password. Similarly to the previous issue, this can be solved by running the following command

<source lang="bash>
$ sudo su
</source>

Using sudo allows you to access the permissions of the root user without using the password.

=== I'm trying to push files using SFTP but it isn't working ===

You may run into an error when trying to push files via SFTP, where you see the following message followed by several lines of error tracing.

<source lang="bash>
Error: Permissions Denied
</source>

If you run into this, it's likely the case that the permissions were set incorrectly for either your private key or public_html. If you make sure that you have set permissions correctly for '''both''' of these, you likely will not have an error.

== One vs Multiple HTML Files ==

=== Should I include both parts of the assignment in the same HTML file? ===

Students often wonder whether they should include both the birthday card and search engine in the same HTML file or separate them into different files. While there is no grading requirement for this and they can be included in the same file, we recommend putting them in different files to get you more comfortable with the process of creating HTML files from scratch. In the end, though, this is up to you.

== Instance Storage Space ==

=== What do I do if I run out of space on my EC2 instance? ===

While this may seem like a big deal, this is often simply due to an issue in a PHP file that causes errors to pile up in the Apache log folder. Follow the following steps to fix this. First, check to make sure this is the issue. Run the following command. If any of the file systems show 100% for use, you may be out of space.

<source lang="bash>
$ df -h
</source>

If this is the case, log into the root user.

<source lang="bash>
$ sudo su
</source>

Direct yourself to the Apache log folder.

<source lang="bash>
$ cd /var/log/httpd
</source>

Run the following command to see the files in this directory. If you see an abundance of error_log files, or error_log files with large sizes, a PHP file is likely the source of the problem.

<source lang="bash>
$ ls -l
</source>

Use the next command to find the PHP file that was the source of the errors. You will need to fix whatever errors you have in your PHP file so that your instance does not fill up again.

<source lang="bash>
$ tail
</source>

Finally, use the following command to remove the error_log files that are taking up all of the space.

<source lang="bash>
$ rm
</source>

Restart Apache after having completed this process and you should have regained space on your instance!

== SFTP Errors/Trouble Connecting to Apache via VSCode ==

=== Why won't my SFTP work from vscode? ===

This is often due to an incorrect private key path, which will result in the following error.

<source lang="bash>
ENOENT: No such file or directory, open '<file path>'
</source>

This nearly always means that your privateKeyPath field in your sftp.json file is incorrect. Double check this path; it should be the file path to your id-rsa file on your local machine.

[[Category:Module 2]]