CloudCenter 4.8 has reached End of Life (EOL) as of November 14, 2018. See End of Support Notices for additional context.

Proxy Settings

If you need a proxy server to connect to the internet, be sure to configure the Proxy setting for the underlying services on the CCM and CCO servers.

Guidelines

Adhere to these guidelines if you decide to use a proxy server to connect to the internet:

  • Set the proxy variables before starting the installation processes. 

  • Proxy configuration is only applicable to the CCM and CCO instances – they are not applicable for any other components.

  • The process differs based on the CloudCenter version.

  • These proxy values are used by the CCM or CCO. In some cases, your worker VM agent might also require a proxy connection to communicate with the outside world. 

    • If so, configure the values as described in the Repo (Conditional) or REPO Upgrade (Conditional) sections. 

    • If not provided, then the CloudCenter platform copies the proxy values from the CCO settings, assuming that the CCO and agent are located in the same network.

CloudCenter 4.9.1 – Wizard Configuration

If you have a local custom repository, then configure the non-proxy host variable in the wizard.

To connect to the Internet using a proxy server, follow this process:

  1. Modify your proxy environment to reflect your proxy settings.

  2. Invoke the CCM or CCO wizard as a root user (see Virtual Appliance Process > Cloud-Specific Setup Details for a sample setup).

    CCM Wizard Path
    /usr/local/cliqr/bin/ccm_config_wizard.sh
    CCO Wizard Path
    /usr/local/cliqr/bin/cco_config_wizard.sh
  3. Configure the Proxy server configuration.

    Write this down for future reference!

    Write down the Field details in a printed version of the Installation Approach > Your Notes section for later use.

    If you do not configure any of these settings, the default settings are used as follows:

    • CCM: No proxy configuration is set

    • CCO: No proxy configuration is set

    No other default values is updated automatically – if the value is default, then the value for that field is considered to be empty.

    Wizard Menu

    Field

    Description

    Proxy servers configuration


    HTTPS Proxy Host

    Provide the proxy host if using the HTTPS protocol.

    HTTPS Proxy Port

    Provide the HTTPS proxy port.

    If you update the host, you must update the port as well.

    HTTP Proxy Host

    Provide the proxy host if using the HTTP protocol

    HTTP Proxy Port

    Provide the HTTP proxy port.

    If you update the host, you must update the port as well.

    No Proxy Hosts

    Use a | (pipe) character to separate the list of domain extensions which do not need the proxy configuration. For example:

    localhost|devCC|127.0.0.1
    HTTPS Proxy Host for Agent

    Provide the proxy host if using the HTTPS protocol for the agent bundles to be downloaded based on the agent proxies.


    HTTPS Proxy Port for Agent

    Provide the HTTPS proxy port.

    If you update the host, you must update the port as well.

    HTTP Proxy Host for Agent

    Provide the proxy host if using the HTTP protocol for the agent bundles to be downloaded based on the agent proxies.

    HTTP Proxy Port for Agent

    Provide the HTTP proxy port.

    If you update the host, you must update the port as well.

    No Proxy Hosts for Agent

    Use a | (pipe) character to separate the list of domain extensions which do not need the proxy configuration. For example:

    localhost|127.0.0.1|cisco.com
  4. Verify your changes.

  5. Restart the server and corresponding CloudCenter services.

  6. Exit the CCM or CCO configuration wizard.

CloudCenter 4.9.1 – CLI Configuration

To connect to the Internet using a proxy server, follow this CLI-based process:

  1. Invoke the CCM or CCO config CLI as a root user.

    Be sure to provide arguments in the same order.

    Provide default as an argument, instead of providing empty values.

    /usr/local/cliqr/bin/ccm_config_cli.sh proxy_config  <https_proxy_host>
    <https_proxy_port> <http_proxy_host> <http_proxy_port>
    <http_non_proxy_hosts> <agent_https_proxy_host> <agent_https_proxy_port>
    <agent_http_proxy_host> <agent_http_proxy_port>
    <agent_http_non_proxy_hosts>
    
  2. Restart the service.

CloudCenter 4.9.0 – Wizard Configuration

If you have already installed a custom repository (not the CloudCenter REPO Virtual Appliance) in your environment, these proxy variables are ignored.

To connect to the Internet using a proxy server, follow this process:

  1. Modify your proxy environment to reflect your proxy settings.

    1. Invoke the CCM or CCO wizard as a root user (see Virtual Appliance Process > Cloud-Specific Setup Details for a sample setup).

      CCM Wizard Path
      /usr/local/cliqr/bin/ccm_config_wizard.sh
      CCO Wizard Path
      /usr/local/cliqr/bin/cco_config_wizard.sh
    2. Configure the Proxy settings.

      Write this down for future reference!

      Write down the Field details in a printed version of the Installation Approach > Your Notes section for later use.

      Wizard Menu

      Field

      Description

      Proxy_Settings

      HTTPS Proxy Host

      Provide the proxy URL as follows:

      https://proxyServer:port

      HTTPS Proxy Server URL

      Provide the proxy URL as follows:

      http://proxyServer:port

      No Proxy Hosts

      A comma separated list of domain extensions which do not need the proxy configuration
      If you set the HTTP or HTTPs options, then this field will display the following default values:

      localhost, devCC, 127.0.0.1
    3. Verify your changes.

    4. Restart the server and corresponding CloudCenter services.

    5. Exit the CCM or CCO configuration wizard.

  2. Verify that the proxy settings are in effect by issuing the following command:

    ps aux | grep java 
    
    #Output of the ps aux | grep java command
    
    cliqrus+ 25106 0.0 45.3 4368868 929000 ? Sl
    Mar02 54:15 /usr/lib/jvm/java-8-sun/bin/java -Djava.util.logging.config.file=/usr/local/tomcatgua/conf/logging.properties
    -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
    -Djava.awt.headless=true -Dfile.encoding=UTF-8 -server -Xms1024m -Xmx2048m
    -XX:NewSize=512m -XX:MaxNewSize=512m -XX:PermSize=512m -XX:MaxPermSize=512m
    -Djav.endorsed.dirs=/usr/local/tomcatgua/endorsed -classpath
    /usr/local/tomcatgua/bin/bootstrap.jar:/usr/local/tomcatgua/bin/tomcat-juli.jar
    -Dcatalina.base=/usr/local/tomcatgua -Dcatalina.home=/usr/local/tomcatgua -Djava.io.tmpdir=/usr/local/tomcatgua/temp
    -Dhttp.proxyHost=proxy.cisco.com -Dhttp.proxyPort=80
    -Dhttp.nonProxyHosts=10.1.1.1 org.apache.catalina.startup.Bootstrap start
  3. Ensure that the line  -Dhttp.proxyHost=proxy.cisco.com -Dhttp.proxyPort=80 -Dhttp.nonProxyHosts=10.1.1.1 is present in the output.

CloudCenter 4.9.0 – CLI Configuration

To connect to the Internet using a proxy server, follow this CLI-based process:

  1. Invoke the CCM or CCO config CLI as a root user.

    /usr/local/cliqr/bin/ccm_config_cli.sh proxy_config 
    HTTPS_PROXY=<https_proxy_url> HTTP_PROXY=<http_proxy_url> 
    NO_PROXY=<no_proxy_configurations>
  2. Restart the service.


Back to:

  • No labels
© 2017-2019 Cisco Systems, Inc. All rights reserved