Always-On Monitoring Commands
The following EMSCTL commands are used to control Always-On Monitoring.
| Command | What it does |
|---|---|
| emsctl start | Starts Always-On Monitoring. |
| emsctl stop | Shuts down Always-On Monitoring. |
| emsctl enable_notification -nosync (optional) | Allow Always-On Monitoring to send email notifications. By default, an incremental SYNC is performed when enabling email notifications. To prevent synchronization with the Enterprise Manager repository, specify the -nosync option. |
| emsctl disable_notification | Prevent Always-On Monitoring from sending email notifications. |
| emsctl list_agents | Lists the URLs of Agents and a count of Agents that have communicated with the Always-On Monitoring Service in the past hour. |
| emsctl ping | Ping the Always-On Monitoring service to determine whether it is up or down. |
| emsctl sync | Synchronize Always-On Monitoring target and notification data with the Enterprise Manager repository. |
| emsctl secure [-wallet=<absolute path to the wallet location>] | [-reg_pwd=<Agent registration password>] [-host=<Fully qualified Always-On Monitoring hostname>] [-cert_validity=<validity period in days - defaults to 10 years] [-key_strength=<certificate key strength - defaults to 1024] [sign_alg=<md5|sha1|sha256|sha384|sha512 - defaults to sha512> | Generates a wallet file for Always-On Monitoring service to run on a secured port. |
| emsctl status | Display information related to Always-On Monitoring operational status. |
| emsctl getstats | Display the current Always-On Monitoring performance statistics |
| emsctl list_properties | Display Always-On Monitoring configuration properties. |
| emsctl set_property -name=<property name> -value=<property value> | Set Always-On Monitoring configuration properties. For a complete list of configuration properties, see Modifiable Always-On Monitoring Properties |
| emsctl unset_property -name=<property name> | Unset an existing Always-On Monitoring configuration property. For a complete list of configuration properties, see Modifiable Always-On Monitoring Properties. |
| emsctl update_task -task_name=<SYNC|PURGE> -run_interval=<time in minutes between task executions> | Update the intervals for performing Always-On Monitoring tasks such as SYNC or PURGE. |
| emsctl set_em_repos_conn -username=<em username> -password=<em password> -connect_string=<em connect descriptor> | Update the username, password and connect string used to connect to Enterprise Manager repository database. |
| emsctl set_ems_repos_conn -username=<ems username> -password=<ems password> -connect_string=<ems connect descriptor> | Update username, password and connect string used to connect to the Always-On Monitoring repository database. |