Featured resource
2025 Tech Upskilling Playbook
Tech Upskilling Playbook

Build future-ready tech teams and hit key business milestones with seven proven plays from industry leaders.

Check it out
  • Lab
    • Libraries: If you want this lab, consider one of these libraries.
    • Cloud
Google Cloud Platform icon
Labs

Troubleshooting an Apache Installation

Understanding a service well enough to troubleshoot it is an important skill as a System Administrator. In this lab, we'll go over troubleshooting an Apache installation.

Google Cloud Platform icon
Lab platform
Lab Info
Level
Intermediate
Last updated
Aug 27, 2025
Duration
30m

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.
Table of Contents
  1. Challenge

    Ensure Apache starts correctly.

    The first thing to check is why Apache isn't starting in the first place.

    Run:

    systemctl start httpd
    

    It returns:

    Failed to start httpd.service: Unit not found.
    

    It looks like the junior admin didn't think to install Apache. Let's install it:

    yum install httpd -y
    systemctl start httpd
    

    It returns:

    Job for httpd.service failed because the control process exited with error code. See "systemctl status httpd.service" and "journalctl -xe" for details.
    

    Looking at systemctl status httpd -l, we see errors like:

    Apr 20 16:20:10 server1 httpd[1451]: (98)Address already in use: AH00072: make_sock: could not bind to address [::]:80
    

    So something is already running on port 80. Running ss -lp shows us that nginx is running and listening on port 80 and port 443. We need to stop nginx and start httpd:

    systemctl stop nginx
    systemctl start httpd
    

    Finally, Apache is running.

  2. Challenge

    Ensure files are being served correctly.

    If everything is configured properly, simply running curl localhost should get our webpage.

    It doesn't, unfortunately. Now we need to configure Apache to use the different DocumentRoot we're using here. We need to edit /etc/httpd/conf/httpd.conf and replace all instances of /var/www/html and /var/www/ with /opt/website/. We also need to make sure SSL is enabled. First, we need to install the mod_ssl package:

    yum install mod_ssl -y
    

    Fortunately, there's a sample configuration file in the /root directory. Copy that to /etc/httpd/conf.d/, and we should be good to go after restarting Apache:

    systemctl restart httpd
    curl https://localhost -k
    

    (The -k is used to ignore alerts due to a self-signed certificate)

    The result doesn't look like our index.html (you can cat /opt/website/index.html to verify).

    Looking at /var/log/httpd/error_log, it looks like a permission issue. Using just ls -l /opt/website, everything looks fine - but maybe it's SELinux. Check with:

    # ls -lZ /opt/website/
    -rw-r--r--. root root system_u:object_r:admin_home_t:s0 index.html
    drwxr-xr-x. root root system_u:object_r:admin_home_t:s0 storage
    

    That's it. admin_home_t is for admin home files (like root's home directory) Compare that to the default /var/www directory:

    # ls -lZ /var/www
    drwxr-xr-x. root root system_u:object_r:httpd_sys_script_exec_t:s0 cgi-bin
    drwxr-xr-x. root root system_u:object_r:httpd_sys_content_t:s0 html
    

    So all we need to do is:

    chcon -R system_u:object_r:httpd_sys_content_t:s0 /opt/website/*
    

    And our curl should work fine. Good job!

About the author

Pluralsight Skills gives leaders confidence they have the skills needed to execute technology strategy. Technology teams can benchmark expertise across roles, speed up release cycles and build reliable, secure products. By leveraging our expert content, skill assessments and one-of-a-kind analytics, keep up with the pace of change, put the right people on the right projects and boost productivity. It's the most effective path to developing tech skills at scale.

Real skill practice before real-world application

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Learn by doing

Engage hands-on with the tools and technologies you’re learning. You pick the skill, we provide the credentials and environment.

Follow your guide

All labs have detailed instructions and objectives, guiding you through the learning process and ensuring you understand every step.

Turn time into mastery

On average, you retain 75% more of your learning if you take time to practice. Hands-on labs set you up for success to make those skills stick.

Get started with Pluralsight