Description | This article describes workarounds and solutions to HTTP daemon not starting in FortiNAC. |
Scope | versions 8.8.x, 9.1.x, 9.2.x. |
Solution |
It is possible to find the error logs to match when dealing with the case and the workarounds to fix it:
Error logs are debugged via CLI :
1) tf output.processManager.
yams.CampusManager INFO :: 2022-05-10 12:34:30:425 :: #1 :: httpd is not running!
2) service httpd status -l.
> service httpd status -l May 10 12:31:27 forti.lab httpd[7981]: [Tue May 10 12:31:27.732954 2022] [core:warn] [pid 7981] AH00111: Config variable ${HTTPD_HOSTNAME} is not defined
Interesting log line :SSLCertificateFile: file '/bsc/siteConfiguration/apache_ssl/server.crt' does not exist or is empty
This directory /bsc/siteConfiguration/apache_ssl/ is the directory where the certificate files are stored and used to secure the Captive Portal. When the certificate files are not there, or they are not complete, this will cause the httpd to not start correctly.
Solutions to this issue:
1) If the GUI is available, disable SSL mode:
For versions 9.1.x and 9.2.x.
Go to Portal -> Portal SSL on the Secondary:
For version 8.8.x.
Go to System -> Settings:
2) If GUI is not available, fix should be performed via CLI and is different from the GUI workaround.
Generate New Self-Signed Certificate using the steps described in page 36 of the FortiNAC certificate SSL installation guide:
If following the steps from step before will not fix the issue, and there is keystore related error while trying to perform those steps, then it is possible to check the keystore directory.
If there is a recent backup of the keystore, it is possible to delete the original keystore and rename the backup keystore as the original one. This step should be considered as optional additional step to a) and not a separate method.
With this method, it is possible to see that the directory /bsc/siteConfiguration/apache_ssl/ is populated with the needed certificate files so no errors are faced when httpd will try to start.
3) If all other steps ar folloed and the selfsigned.crt and selfsigned.key files still do not populate to /bsc/siteConfiguration/apache_ssl/, follow these steps:
- Run the following to export the certificate:
keytool -export -alias server -keystore /bsc/campusMgr/.keystore -storepass ^8Bradford%23 -rfc -file selfsigned.crt
- Move it to the directory:
mv selfsigned.crt /bsc/siteConfiguration/apache_ssl/selfsigned.crt
- Run the following to export the keystore to PKCS12 format:
- Run the following to extract the key:
(password is fortinet - set in the previous command).
- Convert the key to RSA.:
openssl rsa -in selfsigned.key -out selfsigned.key
- Move the key to the appropriate folder:
mv selfsigned.key /bsc/siteConfiguration/apache_ssl/selfsigned.key
- Restart HTTPD and tomcat-admin:
service httpd restart service tomcat-admin restart
Related documents:
https://docs.fortinet.com/document/fortinac/8.8.0/administration-guide/333502/portal-ssl |
The Fortinet Security Fabric brings together the concepts of convergence and consolidation to provide comprehensive cybersecurity protection for all users, devices, and applications and across all network edges.
Copyright 2023 Fortinet, Inc. All Rights Reserved.