Command «config»

Command «config» is used for making manipulations with configs. Syntax of this command differs with action type. 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. 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>
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

1. action=get_app_instances_info

This is action, which shows info(host:base port) about each application tier. 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>]
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
Figure 4. Get app instances info example.

1. action=get_insurance_binds_option_enabled

This is action, which shows if insurance binds option is enabled or disabled. Action has no additional parameters. Here is example and syntax:
cmdmgr.exe config --action=get_insurance_binds_option_enabled
Figure 5. Get insurance binds option enabled example.

1. action=get_shared_instances_info

This is action, which shows shared instances (name: base port) for specified side. 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>
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
Figure 6. Get shared instances info example.

1. action=get_starengine_info

This is action, which shows info (name:port) about each STAR Engine. Action has no additional parameters. Here is example and syntax:
cmdmgr.exe config --action=get_starengine_info
Figure 7. Get star engine info example.

1. action=set_insurance_binds_option_enabled

This is action, which enables or disables insurance binds option. Here is command syntax with this action type:
cmdmgr.exe config --action=set_insurance_binds_option_enabled enabled=<yes|no>
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
Figure 8. Set insurance binds option enabled example.

1. action=set_service_creds

This is action, which set credentials for services. 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">]
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

1. action=show_ports

This is action which shows configured servers ports. Here is command syntax with this action type:
cmdmgr.exe config -action=show_ports [-instance=shared_instance]
Action has only one optional parameter:

• instance – shared instance name.

Example:
cmdmgr.exe config --action=show_ports
Figure 10. Show ports example.