modify_proxy

Modifies a proxy which mediates the HTTP(S) traffic from the Oracle Management Server to the Management Agent.

Note:

This proxy is modeled as an 'oracle_em_proxy' target type.

Management Agents associated with the proxy can be modified in two ways:

• Using Management Agent names.

• Using patterns for Management Agent names.

Currently, 'oracle_em_proxy' target type proxies are supported only for traffic from the Oracle Management Server to the Management Agent. For traffic in the reverse direction (that is, from the Management Agent to the Oracle Management Server), proxy settings can be specified in the emd.properties file of the corresponding Management Agent.

Format

 emcli modify_proxy 
   -name="<name>"
    [-port=<port>]
    [-protocol=<http | https>]
    [-named_credential="<credential name>"]
    [
     [-agents="<name1>,<name2>,..."]
       |
       [
        [-add_agents="<name1>,<name2>,..."]
        [-delete_agents="<name1>,<name2>,..."]
       ]
    ]
    [
     [-agent_patterns="<name pattern1>,<name pattern2>,..."]
       |
       [
        [-add_agent_patterns="<name pattern1>,<name pattern2>,..."]
        [-delete_agent_patterns="<name pattern1>,<name pattern2>,..."]
      ]
    ]
    [
     [-excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]

      |
      [
        [-add_excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]
        [-delete_excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]]
      ]
    ]

[ ]  indicates that the parameter is optional.

Options

• -name

  Name that identifies a proxy.

• -port

  Port on the proxy host offering the proxy service.

• -protocol

  Protocol used by the traffic which the proxy mediates. Valid values are:

  • http

  • https

• -named_credential

  Name of the Named Credential to be used for authentication with the proxy.

• -agents

  Comma separated list of the names of the Management Agents which the proxy mediates for. You can use the backslash character (\) as an escape character. If the Management Agent with the specified name does not exist, then it is ignored.

• -add_agents

  Comma separated list of the names of "additional" Management Agents which the proxy should mediate for. If the Management Agent with the specified name does not exist, then it is ignored. Note that you can use the backslash character (\) as an escape character.

• -delete_agents

  Comma separated list of the names of Management Agents which the proxy should not mediate for. This list, in addition to the list of Management Agents already associated with the proxy via their names, is applicable to the list of Management Agents specified in -add_agents option (if specified) also. Note that you can use the backslash character (\) as an escape character.

• -agent_patterns

  Comma separated list of patterns for the names of Management Agents which the proxy mediates for. The pattern can use two wildcard characters:

  • Asterisk character (*) for one or more characters

  • Question mark character (?) for a single character.

  • Backslash character (\) as an escape character.

• -add_agent_patterns

  Comma separated list of "additional" patterns for the names of Management Agents which the proxy should mediate for. These patterns also use the same wildcard characters as applicable for the -agent_patterns option.

• -delete_agent_patterns

  Comma separated list of patterns which should be removed from the list of patterns for the names of Management Agents which the proxy should mediate for. This list, in addition to the list of Management Agents name patterns already associated with the proxy, is applicable to the list of patterns specified in -add_agent_patterns option (if specified).

• -excluded_agent_patterns

  Comma separated list of patterns for the names of Management Agents which must be excluded from the names of the Management Agents identified by Management Agent name patterns associated with the proxy. These patterns can also use same wildcard characters as applicable for the -agent_patterns option.

• -delete_excluded_agent_patterns

  Comma separated list of patterns which should be removed from the list of patterns for the names of Management Agents which must be excluded from the names of Management Agents identified by the Management Agent name patterns associated with the proxy. This list, in addition to the list of excluded Management Agents name patterns already associated with the proxy, is applicable to the list specified in the -add_excluded_agent_patterns option (if specified) as well.

Examples

Example 1

The following command modifies the proxy identified by the " us-proxy-1" name to allow HTTPS traffic only.

emcli modify_proxy
       -name="us-proxy-1"
       -protocol=https

Example 2

The following command modifies the proxy identified by the "us-proxy-1" name to be associated with the "myhost001.us.example.com:3535 and myhost002.us.example.com:3535" Management Agents. If the proxy was associated with any other Management Agents using patterns previously, those patterns and the list of Management Agents they derive remains the same.

emcli modify_proxy
      -name="us-proxy-1"
      -format="name:script;column_separator:|"
      -agents="myhost001.us.example.com:3535,myhost002.us.example.com:3535