Configure Virtual Hosts for Portal and/or Data Collection SSL
Refer to the following sections that are relevant for your environment. These instructions are referenced in
Step 6 of
Update the Web Server Configuration to Enable SSL.
If implementing SSL for the Portal Only
1. Verify that there is a VirtualHost section with the IP address assigned to the Portal host. This section starts with the following lines. These lines must be present and enabled.
<VirtualHost IP_ADDRESS_PORTAL:443>
ServerName aptareportal.domainname:443
Document Root /opt/aptare/portal
2. In the VirtualHost declaration, replace IP_ADDRESS_PORTAL with the IP address assigned to the Portal server.
3. If the Portal VirtualHost section is not found, the configuration for the Portal VirtualHost must be added.
4. If there is a configuration section for the Data Collection virtual host, ensure that this section is disabled by adding a # to the beginning of each line in the section, as shown below.
#<VirtualHost aptareagent.domainname:443>
5. Set the Document Root path to a valid path for the Web Server’s OS.
Linux | Windows |
/opt/aptare/portal | C:\opt\aptare\portal |
If implementing SSL for Data Collection Only
1. Verify that there is a VirtualHost section for the data collection with the IP address of the Data Receiver. This section starts with the following lines. These lines must be present and enabled.
<VirtualHost IP_ADDRESS_DATARCVR:443>
ServerName aptareagent.domainname:443
DocumentRoot /opt/aptare/datarcvr
2. Replace IP_ADDRESS_DATARCVR in the VirtualHost declaration with the IP address assigned to the Data Receiver.
3. If the data collection VirtualHost section is not found, the configuration for the data collection VirtualHost must be added.
4. If there is a configuration section for the Portal virtual host, ensure that this section is disabled by added a
# to the beginning of each line in the section, as shown below.
#<VirtualHost aptareportal.domainname:443>
5. Set the Document Root path to a valid path for the Web Server’s OS.
Linux | Windows |
/opt/aptare/datarcvr | C:\opt\aptare\datarcvr |
If implementing SSL for Both the Portal and Data Collection
To implement SSL for both the Portal and Data Collection, the Portal server must be configured with two IP addresses, one for the Portal and one for Data Collection. The two required IP addresses may be implemented using two NICs. If only a single NIC is available, a virtual interface may be added for the second IP address. See
Add a Virtual Interface to a Linux Server and
Add a Virtual/Secondary IP Address on Windows.
1. Verify there is a VirtualHost section with the IP address assigned to the Portal host. This section starts with the following lines. These lines must be present and enabled.
<VirtualHost IP_ADDRESS_PORTAL:443>
ServerName aptareportal.domainname:443
Document Root /opt/aptare/portal
2. Replace IP_ADDRESS_PORTAL in the VirtualHost declaration with the IP address assigned to the Portal server.
3. Verify there is a VirtualHost section with the Data Receiver IP address. This section starts with the following lines. These lines must be present and enabled.
<VirtualHost IP_ADDRESS_DATARCVR:443>
ServerName aptareagent.domainname:443
DocumentRoot /opt/aptare/datarcvr
4. Replace IP_ADDRESS_DATARCVR in the VirtualHost declaration with the IP address assigned to the Data Receiver.
5. Set the Document Root paths to valid paths for the Web Server’s OS.
Linux | Windows |
/opt/aptare/portal /opt/aptare/datarcvr | C:\opt\aptare\portal C:\opt\aptare\datarcvr |