Previous versions of BlueCat Gateway let users directly edit Apache configuration files for Gateway's Apache host servers. As of version 21.11.2, Gateway will override those settings on startup. If you customized Apache server settings on your system, you must move those customized settings to either a Global Apache configuration file, and/or the HTTP/HTTPS configuration files.
You might also need to move SSL certification files to a new location. For more details, see Updating certificates and custom Apache configurations on legacy systems.
BlueCat Gateway makes use of two Apache virtual hosts, one for HTTP access and one for HTTPS access. Gateway automatically reconfigures Apache during startup; any settings made within the Apache server itself might be overridden.
You can't configure these Apache servers directly. Instead, you can configure settings used by these Apache hosts in the following locations:
| Order | File/folder name1 | Description | |
|---|---|---|---|
| 1 | Gateway UI |
config.json |
Within the BlueCat Gateway UI itself, using
Gateway settings. Changes made in Gateway automatically update the
standard JSON configuration file, config.json
(where applicable). Important: Do not configure Apache
settings within config.json. Instead, either
edit configurations within Gateway or use one of the provided
Apache settings files, global.conf,
http.conf, and
https.conf.
|
| 2 | Global Apache configuration file | apache/global.conf | Within a Global Apache Configuration file (global.conf). Settings in this file will be applied to both Apache hosts, overriding any applicable setting made in the Gateway UI. |
| 3 | Server-specific configuration files |
apache/http.conf apache/https.conf |
Within the two HTTP/HTTPS Apache Configuration files (http.conf and https.conf). These settings will be applied to only the specific Apache host responsible for HTTP or HTTPS communications, respectively. They will override applicable settings made in the Gateway UI or in global.conf. |
The global.conf, http.conf, and https.conf files are useful to configure settings not available within the Gateway UI, such as ServerName and ServerAdmin.
- Gateway's HTTPS Apache server will use alice@yourdomain.com, inherited from the Global Apache Configuration file.
- Gateway's HTTP Apache server will use bob@yourdomain.com.