cPanel server administration woes

Error/Output (from tailing the Apache error log):


tail -f /usr/local/apache/logs/error_log
[Sat Aug 17 10:30:05.123456 2024] [core:alert] [pid 12345] [client 192.168.1.100:54321] /home/user/public_html/subdomain/.htaccess: Invalid command 'RewriteEngine', perhaps misspelled or defined by a module not included in the server configuration

The error message "Invalid command 'RewriteEngine', perhaps misspelled or defined by a module not included in the server configuration" is definitive. It indicates that the Apache `mod_rewrite` module is not loaded or enabled on your server, which is why your `.htaccess` rules are failing. This is a common issue in cPanel server administration if the Apache configuration isn't correctly provisioned. Here’s a breakdown of the steps to resolve this, given you have root access to WHM: 1. **Enable `mod_rewrite` via EasyApache 4:** * Log into your WHM panel. * Navigate to **Software** > **EasyApache 4**. * You will see your currently installed Apache (httpd) and PHP packages. Click the **Customize** button for your current profile. * Go to the **Apache Modules** section. * Search for `mod_rewrite`. Ensure the toggle switch next to `mod_rewrite` is set to **On**. * Go to the **Review** section and then click **Provision** to apply the changes. This will rebuild and restart Apache. 2. **Verify `AllowOverride` Directives:** * Even if `mod_rewrite` is enabled, Apache needs to be told to respect `.htaccess` files for the specific directory. You mentioned rebuilding `httpd.conf`, but it's crucial to confirm the `AllowOverride` directive. * While logged into WHM, go to **Service Configuration** > **Apache Configuration** > **Include Editor**. * Select "Pre VirtualHost Include" or "Post VirtualHost Include" for your Apache version (e.g., `2.4`). * You need to ensure that the `AllowOverride All` directive is set for the document root of your subdomain. The default cPanel setup usually sets `AllowOverride All` for `public_html`, which typically extends to subdomains, but it's worth verifying. * A typical entry for a subdomain's virtual host might look like this in the Apache configuration, which you can verify by checking the `/etc/apache2/conf.d/userdata/std/2_4/user/subdomain.conf` file (replace `user` and `subdomain` with actual values) or similar:

<Directory "/home/user/public_html/subdomain">
    AllowOverride All
</Directory>

* If `AllowOverride None` is explicitly set somewhere higher in the configuration, it will prevent your `.htaccess` from working. Ensure `AllowOverride All` is in effect for `/home/user/public_html/subdomain`. 3. **Check Virtual Host Configuration:** * While EasyApache 4 usually handles this correctly, ensure the subdomain's virtual host entry in Apache is configured correctly. You can inspect this via SSH in `/etc/apache2/conf.d/userdata/std/2_4/user/subdomain.conf` or by looking at the main `httpd.conf` if not split into individual files. * Ensure the `DocumentRoot` and `ServerName` directives match your subdomain path and name precisely. 4. **DNS Resolution Check:** * You've checked the DNS settings in cPanel Zone Editor. Confirm that the A record for your subdomain points to the correct server IP address. * From your local machine, use `dig yoursubdomain.yourdomain.com` or `nslookup yoursubdomain.yourdomain.com` to confirm it resolves externally to the correct IP. Sometimes local DNS caches or ISP caches can cause resolution issues even if the cPanel settings are correct. Once `mod_rewrite` is enabled and `AllowOverride All` is confirmed for the subdomain's directory, your `.htaccess` file should be processed correctly. After making any changes in WHM, always provision EasyApache 4 and restart Apache to ensure they take effect. Hope this helps your conversions!