Show TOC

Procedure documentationConfiguring Host Mapping and Path Prefix Locate this document in the navigation structure

 

You can specify the following URL mappings:

  • Virtual host, HTTP port, and HTTPS port mapping for a specific host. This HTTP mapping (WS HTTP Mapping) applies only to Web services and overrides the global HTTP mappings.

    You can configure a WS HTTP Mapping as relevant for Services Registry publication.

  • A path prefix that should be inserted in the URI after the virtual host name and port.

    You can specify a WSDL prefix and an endpoint prefix. The path prefixes apply only to hosts for which you have set WS HTTP Mapping.

For more information about the usage of reverse proxies, see Configuring Reverse Proxy Settings.

Procedure

Accessing the Reverse Proxy Settings

  1. In Visual Administrator, choose   Cluster   Server   Services   Web Services Container  .

  2. Choose the Runtime tab on the top and then the Settings tab on the bottom.

  3. Edit the settings in the Reverse Proxy screen area as described below.

Configuring WS HTTP Mapping for a Host

  1. In the HTTP Mappings screen area, choose Add.

  2. In the Host field, enter the IP address or the name of the host for which you want to create a mapping.

  3. In the Virtual Host field, enter the virtual host name or IP address you want to assign for this host.

  4. Enter the virtual HTTP and HTTPS ports.

    Example Example

    You want to create the following mapping:

    • Internal URL: http://10.1.1.2:50000/ExampleService/Example?wsdl

    • External URL: http://example.com:80/ExampleService/Example?wsdl

    To do this, you should create a WS HTTP Mapping for 10.1.1.2 to the example.com virtual host on virtual port 80.

    End of the example.

  5. To mark a particular WS HTTP Mapping as relevant for Services Registry publication, select it and choose Set as Default.

    For WS HTTP Mapping marked as Services Registry relevant, the system uses the HTTP transport protocol by default

    Note Note

    If there are no such WS HTTP Mappings, then the system chooses the first global HTTP mapping it finds as the default Services Registry publication relevant HTTP mapping. The system uses this default value for the generation of the first part for external endpoint/WSDL URLs published in Services Registry.

    End of the note.

  6. Save your entries.

For more information, see Mappings for Host and Port and Mappings for URL Published in Services Registry.

Configuring Path Prefixes

  1. In the WSDL Prefix and Endpoint Prefix fields, enter the path prefix that should be used for WSDL URL and endpoint URL, respectively.

    The strings for the prefixes can contain a forward slash (/) character except at the start and at the end.

    Example Example

    You want to create the following mapping:

    • Internal URL: http://[host]:[port]/ExampleService/Example?wsdl

    • External URL: http://[vhost]:[vport]/my/folder/ExampleService/Example?wsdl

    To do this, you should enter a my/folder prefix for WSDL.

    End of the example.

  2. Save your entries.

For more information, see Mappings for Path.