Using a Virtual Name for a Web Service

Updated

You can use the Host HTTP header to define a virtual name for the Web Server. Defining a virtual name is helpful if you do not want to use the name of the physical host when accessing the resource.

Update the DNS

  • Add the virtual name to the DNS, and then map the name to the I.P. address of the physical machine. The mapping keeps the communication with the web service functional.

Configure the Web Server Hostname

  1. Log on to the CommCell Console.

  2. To the Web Server computer, add the sIISInternalHostname additional setting as shown in the following table.

    For instructions about adding an additional setting from the CommCell Console, see Adding an Additional Settings from the CommCell Console.

    Property

    Value

    Name

    sIISInternalHostname

    Category

    Session

    Type

    String

    Value

    The virtual name for the Web Server.

Applies to: CommCell environments that use Compliance Search

  1. Log on to the Compliance Search computer.

  2. Go to software_installation_path\Web-INF\Classes.

  3. Back up the configuration.properties file by making a copy of the file.

  4. Open the configuration.properties file, and then update the WebServiceURL parameter to use the virtual name:

    WebServiceURL=http://virtual_name:port/SearchSvc

  5. Restart the Tomcat services.

    Note

    If Compliance Search and Web Console are on the same computer, you can restart the Tomcat services after you complete the "Update the Web Console Computer" step.

Update the Web Console Computer

  1. Log on to the Web Console computer.

  2. Open the registry editor and click:

    HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\instance\WebConsole

    where instance is the installation instance of the Web Console.

  3. Right-click the baseUrl registry key, and then click Modify.

  4. In the Value Data box, update the value to use the virtual name:

    https://virtual_name:port/SearchSvc/CVWebService.svc

  5. If you use a proxy service, update the proxyServiceUrl registry key and the ProxySettings.config file:

    1. Right-click the proxyServiceUrl registry key, and then click Modify.

      Note

      If proxyServiceUrl does not exist, create it and use string as the type.

    2. In the Value Data box, update the value to use the virtual name:

      https://virtual_name:port/proxysvc/proxy.aspx

    3. Go to software_installation_path\CVProxyService.

    4. Back up the ProxySettings.config file by making a copy of the file.

    5. Open the ProxySettings.config file, and then update the WEB_SERVICE_URL parameter to use the virtual name:

      <add key="WEB_SERVICE_URL" value="http://virtual_name:port/SearchSvc/CVWebService.svc/" />

  6. Restart the Tomcat services.