Modifying HTTP Server Settings

You may configure the IBM Aspera Faspex Apache HTTP Server to use different host name, communication port, and namespace.

Important: For help on regenerating the self-signed SSL certificate (due to a host name change) that is installed with this Aspera Web application, see Regenerating Self-Signed SSL Certificate (Apache). For instructions on creating and enabling a CA-signed certificate, see Installing a Signed SSL Certificate Provided by Authorities.

To begin, in a Command Prompt (Start menu > All Programs > Accessories > >Command Prompt), execute the following command to navigate into the Faspex directory:

OS Version Command
32-bit Windows
> cd "C:\Program Files (x86)\Aspera\Faspex" 
64-bit Windows
> cd "C:\Program Files (x86)\Aspera\Faspex" 
  1. Update the hostname.

    The hostname used by apache is configured when you first install Faspex. Use this command to print the current hostname:

    > asctl apache:hostname

    To change the hostname, use the following command. Replace HOSTNAME with the new hostname:

    > asctl apache:hostname HOSTNAME

    Also update your SSL certificate to reflect the new hostname:

    > asctl apache:make_ssl_cert HOSTNAME
  2. Change HTTP and HTTPS ports.

    By default, Faspex uses standard ports for HTTP (80) and HTTPS (443). Use the following commands to update these ports:

    Item Command
    HTTP
    > asctl apache:http_port NEW_HTTP_PORT
    HTTPS
    > asctl apache:https_port NEW_HTTPS_PORT
  3. Change Faspex namespace.

    Faspex uses the namespace /aspera/faspex by default. Use this command to print the current namespace:

    > asctl faspex:uri_namespace

    To set the namespace to, for example, /faspex, use the following command:

    > asctl faspex:uri_namespace /faspex

    When the namespace is updated, advise your users of the new URL. For example, if your faspex server's address is https://198.51.100.24/aspera/faspex and you change the namespace to /faspex, they would use the following URL: https://198.51.100.24/faspex.

For a complete asctl command reference, see asctl Command Reference.