Use the AdminApp object for scripted administration
Use the AdminApp object to manage applications.
Before you beginThis object communicates with the run time application management object in WAS to make application inquires and changes, for example:
- Installing and uninstalling applications
- Listing applications
- Editing applications or modules
Because applications are part of configuration data, any changes that you make to an application are kept in the configuration session, similar to other configuration data. Be sure to save your application changes so that the data transfers from the configuration session to the master repository.
About this task
With the application already installed, the AdminApp object can update application metadata, map virtual hosts to Web modules, and map servers to modules. You must perform any other changes, such as specifying a library for the application to use or setting session management configuration properties, using the AdminConfig object.
You can run the commands for the AdminApp object in local mode. If a server is running, it is not recommended that you run the scripting client in local mode because any configuration changes that are made in local mode will not be reflected in the running server configuration and vice versa. If you save a conflicting configuration, you could corrupt the configuration.
In a deployment manager environment, configuration updates are available only if a scripting client is connected to a deployment manager. When connected to a node agent or a managed application server, you will not be able to update the configuration because the configuration for these server processes are copies of the master configuration which resides in the deployment manager. The copies are created on a node machine when a configuration synchronization occurs between the deployment manager and the node agent. Make configuration changes to the server processes by connecting a scripting client to a deployment manager. For this reason, to change a configuration, do not run a scripting client in local mode on a node machine. It is not a supported configuration.
To see a list of all available commands for the AdminApp object:
- See the Commands for the AdminApp object article.
- You can also use the Help command, for example:
Using Jacl$AdminApp help
Using Jythonprint AdminApp.help()
Listing applications with the wsadmin tool
Editing application configurations with the wsadmin tool
Commands for the AdminApp object
WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.