Command «config»

Command «config» is used for making manipulations with configs. Syntax of this command differs with action type.

General Syntax

General command syntax is:

cmdmgr.exe config action=<clone_shared_instance|get_app_instances_info|get_shared_instances_info|get_starengine_info|set_service_creds|show_ports|get_insurance_binds_option_enabled|set_insurance_binds_option_enabled> [other args]

Based on action type here is list of action detailed description with examples:

1. action=clone_shared_instance

This is action, that creates new shared instance based on existing.

Syntax

Here is syntax of command with this action type:

cmdmgr.exe config --action=clone_shared_instance --from=<cloned instance> --to=<new instance> --baseport=<base port> --remote_ip_pri=<some ip> --remote_ip_sec=<some ip> --remote_dupport_pri=<some port> --remote_dupport_sec=<some port>

Parameters

Action has such parameter:

• from – existing shared instance with will be cloned;
• to – destination shared instance cloned from instance specified in parameter «from»;
• baseport – base port for new instance;
• remote_ip_pri – option in syncsend.ini;
• remote_ip_sec – option in syncsend.ini;
• remote_dupport_pri – option in syncsend.ini;
• remote_dupport_sec – option in syncsend.ini.

Example

cmdmgr.exe config --action=clone_shared_instance --from=sweb01 --to=sweb02 --baseport=21000 --remote_ip_pri=0.0.0.0 --remote_ip_sec=0.0.0.0 --remote_dupport_pri=5555 --remote_dupport_sec=5555

2. action=get_app_instances_info

This is action, which shows info(host:base port) about each application tier.

Syntax

Here is syntax of command with this action type:

cmdmgr.exe config --action=get_app_instances_info [--emshell_host=<Thick EMShell host> --emshell_port=<Thick EMShell port>]

Parameters

Action has such parameters:

• emshell_host – host of thick EMShell can't be empty if emshell port has been specifed;
• emshell_port – port of thick EMShell can't be empty if emshell host has been specified.

Example

cmdmgr.exe config --action=get_app_instances_info --emshell_host=127.0.0.1 --emshell_port=20000

3. action=get_insurance_binds_option_enabled

This is action, which shows if insurance binds option is enabled or disabled. Action has no additional parameters.

Syntax

cmdmgr.exe config --action=get_insurance_binds_option_enabled

Example

4. action=get_shared_instances_info

This is action, which shows shared instances (name: base port) for specified side.

Syntax

Here is command syntax with this action type:

cmdmgr.exe config --action=get_shared_instances_info --emshell_host=<Thick EMShell host> --emshell_port=<Thick EMShell port>

Parameters

Action has such parameters:

• emshell_host – Host of thick emshell, this parameter cannot be empty
• emshell_port – Port of thick emshell, this parameter cannot be empty

Example

cmdmgr.exe config --action=get_shared_instances_info --emshell_host=127.0.0.1 --emshell_port=31050

5. action=get_starengine_info

This is action, which shows info (name:port) about each STAR Engine. Action has no additional parameters.

Syntax

Here is example and syntax:

cmdmgr.exe config --action=get_starengine_info

Example

6. action=set_insurance_binds_option_enabled

This is action, which enables or disables insurance binds option.

Syntax

Here is command syntax with this action type:

cmdmgr.exe config --action=set_insurance_binds_option_enabled enabled=<yes|no>

Parameter

Action got only one parameter that cannot be empty:

• enabled – enable or disable option.

Example

cmdmgr.exe config --action=set_insurance_binds_option_enabled enabled=yes

7. action=set_service_creds

This is action, which set credentials for services.

Syntax

Here is command syntax with this action type:

cmdmgr.exe config --action=set_service_creds --passfile=<Path to credentials file> [--servicename=<"Eagle service name">] [--account=<"domain\user">]

Parameters

Action has such parameter:

• passfile – path to file with password and user;
• servicename – name for service. This is optional parameter and can be empty. By default credentials will be set for all eagle services;
• account – user account. This is optional parameter and can be empty. Be default user and domain will be retrieved from current process.

Example

cmdmgr.exe config --action=set_service_creds --passfile="passfile" --servicename=emshell_thick --account=domain\user

8. action=show_ports

This is action which shows configured servers ports.

Syntax

Here is command syntax with this action type:

cmdmgr.exe config --action=show_ports [--instance=shared_instance]

Parameter

Action has only one optional parameter:

• instance – shared instance name.

Example

cmdmgr.exe config --action=show_ports