Actions Performed Using CLI
The actions that can be performed with the command-line interface affect either the objects contained in the database or the objects executing in the ActiveMatrix Service Grid runtime.
Database Actions
Database actions modify the objects contained in the Administrator database:
- add - Add an object or an association between objects, such as between an application and a node.
- addOrUpgrade -
- Adds the features from your data file to the nodes. For example, Feature
com.acme.myapp.feature
1.5.0 gets added to DevNode with statusMarked for Install
. - Removes any other versions of the same feature, if they were present on the nodes. Features with a different major version are not affected. For example, Feature
com.acme.myapp.feature
1.0.0 and 1.6.0 are changed to statusMarked for Uninstall
, since any version not matching "1.5.0" is marked for removal. However, featurecom.acme.myapp.feature
2.0.0 is left as is, because it has a different major version.
- Adds the features from your data file to the nodes. For example, Feature
- edit - Edit an object.
- delete - Delete an object or an association between objects. When you delete an object, the entire tree rooted at the object is deleted starting at the leaves.
- set - Set the value of a substitution variable, map an application, component or binding to a node, set a property of a binding. This action deletes any existing entries that aren't present in the new set and adds any entries in the new set that weren't in the database.
- upgrade - Upgrade an existing application.
- promote - Make a service or reference available at the environment level for cross-environmental wiring.
- demote - Make a service or reference unavailable at the environment.
- resetPassword - Reset a user password.
Runtime Actions
Runtime actions modify the state of the objects contained in the ActiveMatrix Service Grid runtime:
- install - Install node on a host or a resource instance on a node.
- uninstall - Uninstall a node from a host or a resource instance from a node.
- deploy - Deploy a component or binding to a node, a logging configuration for a host, node, application, or component, a plug-in to the Administrator server. Also undeploys components and bindings from nodes they are no longer mapped to.
- undeploy - Undeploy an application or plug-in.
- start - Start a node, application, component, or binding.
- stop - Stop a node, application, component, or binding.