Configuring Apache HTTP Server

Adobe Media Server includes Apache HTTP Server. If you install and enable the web server, you can deliver client SWF files, container HTML pages, and media assets from Adobe Media Server. You can serve content over HTTP, as well as RTMP. In addition, you can serve video over HTTP progressive download as a fallback solution for web proxies that break RTMP or RTMPT.

The Adobe Media Server installation of Apache is like the standard installation. You can use Apache documentation for most configuration tasks. The Apache root installation folder is rootinstall/Apache2.4. The web root is rootinstall/webroot.

Installation locations

The Apache server that installs with Adobe Media Server differs from a standard Apache installation in the following ways:

• The apachectl files are in the rootinstall/Apache2.4/manual/programs folder.

• The httpd.conf file and the standard secondary configuration files are in the rootinstall/Apache2.4/conf folder.

• The log files are in the rootinstall/Apache2.4/logs folder. For more information, see Monitoring and Managing Log Files.

Alternate configurations

To do any of the following, edit the rootinstall/Apache2.4/conf/httpd.conf file:

• Handle multiple adaptors or virtual hosts

• Block sensitive file types, such as ASC

• Handle any non-standard MIME types required for progressive download

• Serve the default server-status and server-info pages

• Modify source directories

Specify the maximum HTTP header line length

In the Adobe Media Server Adaptor.xml file, the MaxHeaderLineLength element determines the size of the HTTP header the server can handle. The default value for MaxHeaderLineLength is 1024 bytes. Some browsers send a header larger than 1024 bytes. In this scenario, Apache sends back an empty response. To fix this issue, configure MaxHeaderLineLength to 8192.

Enable and disable Apache and HTTP proxying

When you install Adobe Media Server and choose to install Apache, it is enabled by default. Adobe Media Server listens on port 80 and proxies HTTP requests to Apache over port 8134.

Setting the parameter to no value disables HTTP proxying:

To proxy to a remote server, set the parameter to the remote server you want to use:

Enable Apache and HTTP proxying

Disable Apache and HTTP proxying

Deliver SWF files and HTML files over HTTP

Apache can deliver SWF files, HTML files, JPG files, and many other standard file types over HTTP. Place files that you want to deliver over HTTP in the correct folders. By default, Apache is configured to use following paths:

These folders are global, not application-specific. Any SWF files and HTML files you want to serve over HTTP must be in these folders or in application-specific folders. To create aliases for application-specific folders, edit the httpd.conf file.

Create web directories for applications

To have Apache serve content over HTTP, either use one of the predefined web directories or create a web directory for that application. To create a web directory for an application, add an alias to the rootinstall/Apache2.4/conf/httpd.conf file. For example, the following lines create an alias that points to the streams directory of an application called “hd”:

Copy media files to the rootinstall/applications/hd/streams/_definst_/ folder to serve them over HTTP. For example, if a client requests http://ams.example.com/hd/someVideo.flv, Apache serves it the someVideo.flv file from the rootinstall/applications/hd/streams/_definst_/ folder.

For more information about editing the configuration file, see the Apache documentation at www.apache.org.

Using Apache as a WebDAV host

You can configure the web server to act as a WebDAV host. For information, see the Apache HTTP Server version 2.4 documentation at www.apache.org.

The following keywords are reserved words: open, close, send, idle, fcs, ams, crossdomain.xml, fpad. Reserved words cannot be used for directory names under the webroot directory or for anything else. If you have applications with these names, use custom aliases to give the HTTP virtual directories slightly different names from the RTMP applications, such as “open_”.

Running Apache for Windows as a service

To install Apache to run as a service on Windows:

To start and stop the Windows services on Windows XP:

1. Right click My Computer and select Manage. The Computer Management dialog box displays.

2. Select Services and Applications.

3. Double-click Services. The list of available services displays.

4. To start a service, select the service from the list and click the Start Service button. To stop a service, select the service from the list and click the Stop Service button.

Upgrading Apache HTTP server

At some time after installing Adobe Media Server, you might be required to update the included Apache web server. Most commonly, this would be due to Apache HTTP server security patches or functionality upgrades.

The recommended approach to upgrading the Apache web server is to install or build the Apache server in a directory that is separate from the existing server. Then copy the contents of newly-installed directories to the existing server.

In most cases, you do not replace the existing Apache configuration files with the newer versions of these files. This is because the Apache web server installation for Adobe Media Server is pre-configured with specific modules and settings. If there are changes to the configuration files, it is usually easier to update the existing files with changes.

Before upgrading:

1. Review any installation notes on apache.org about the differences between the current version and the new version. For example, look for renamed directives or renamed modules that would require you to merge configuration files.

2. Make sure the currently-installed version of Apache is working correctly:

   1. Check the master log file for errors. The master.00.log file should have a line that launches the httpd process and returns 0; for example: - C:\Program Files\Adobe\Adobe Media Server 5\Apache2.4\bin\httpd -f ./conf/httpd.conf -d "C:\Program Files\Adobe\Adobe Media Server 5\Apache2.4" -n AMSHttpd -k start returned 0:

   2. Try playing videos using the “http” protocol.

    

3. Check the current version of Apache and make a note of it. From a command prompt, go to AMS_Install_Dir/Apache2.4/bin and issue the following command:httpd -v

4. Back up following directories:AMS_Install_Dir/Apache2.4/bin AMS_Install_Dir/Apache2.4/lib AMS_Install_Dir/Apache2.4/include AMS_Install_Dir/Apache2.4/modules AMS_Install_Dir/Apache2.4/manual AMS_Install_Dir/Apache2.4/icons

To upgrade:

1. Stop Adobe Media Server.

2. Follow the directions on apache.org to download and run the Apache installer. If you are using Linux, you may be required to build the Apache server on your system.

3. Copy the following directories from the newly-installed version to the current version that was installed with Adobe Media Server:Apache_Install_Dir/bin Apache_Install_Dir/modules Apache_Install_Dir/manual Apache_Install_Dir/icons

   Note that the /conf directory, which contains the Apache configuration files, is not included in this list. You should not replace the existing configuration files with the new configuration files.

4. Merge the configuration files, if necessary. In most cases, you will not need to merge the files. However, if the newer version of Apache includes new or renamed modules or directives, you might need to edit the configuration files to meet the new requirements.

5. Start Adobe Media Server.

After upgrading:

1. Ensure that the newer version of Apache is now available. From a command prompt, go to AMS_Install_Dir/Apache2.4/bin and issue the following command:httpd -v

2. Recompile third-party modules, if necessary.

3. Make sure the newly-updated version of Apache is working correctly:

   1. Check the master log file for errors or warnings. The master.00.log file should have a line that launches the httpd process and returns 0; for example: - C:\Program Files\Adobe\Adobe Media Server 4\Apache2.4\bin\httpd -f ./conf/httpd.conf -d "C:\Program Files\Adobe\Adobe Media Media Server 4\Apache2.4" -n AMSHttpd -k start returned 0:

   2. Try playing videos using the “http” protocol.

    

Updating the OpenSSL version in the bundled Apache server

On a Window Machine, OpenSSL is available with bundled Apache. To update the OpenSSL version, follow these steps:

1. Access the bin directory of your Apache installation.

2. Copy libeay32.dll, ssleay32.dll, and openssl.exe files from a separate, patched security release of OpenSSL from the same major release.

3. Replace the existing files with the new files in the bin directory.

On Linux machines, the bundled Apache does not include the OpenSSL libraries libcrypto and libssl. Adobe recommends that the administrators keep the system updated with the appropriate version of OpenSSL binaries.

Troubleshooting Apache HTTP server

In some cases, the Apache server could be at fault for the Adobe Media Server not running properly. This is sometimes caused by syntax errors in the Apache configuration files.

Check the master.log file in the rootinstall/logs directory. If Apache could not start for some reason, it typically returns an error code of “1” and writes a line similar to the following in the master.log file:2010-06-22 15:45:09 4276 (w)2581414 C:\Program Files\Adobe\Adobe Media Server 5\Apache2.4\bin\httpd -f ./conf/httpd.conf -d "C:\Program Files\Adobe\Adobe Media Server 5\Apache2.4" -n AMSHttpd -k start returned 1:

The status of (w) or (e) indicates a warning or error. For more information about status codes in the master.log file, see Diagnostic logs.

If you are running Adobe Media Server as a service, you can check the Windows Event Viewer for errors messages. On Linux, check syslog’s log file for error messages.

You can also check the Apache log files for error messages. The default location of the Apache log files is rootinstall/Apache2.4/logs. The logs are in the default Apache error and combined access log formats. For information about these log file formats, see Log Files.

To change the location of the log files, edit the rootinstall/Apache2.4/conf/httpd.conf file.