You can submit the Uninstall Liberty profile
resources job to remove Liberty profile resources from
one or more target hosts.
Before you begin
A Liberty profile resource must exist
on one or more targets that are registered with the job manager. Start
the job manager and ensure that the resource is not in use on the
targets.
Your ID at the job manager must be authorized for the
administrator role or the operator role to submit jobs.
When
registering a target host with the job manager, you can save operating
system security information. When you submit a job to one or more
targets for which security information has not been saved, you must
specify an authorized operating system user name and either password
or public-private key information for the user name. The security
credentials must be valid for all job targets.
About this task
You can use the administrative console of the job manager
or the deployment manager to uninstall a Liberty profile resource from one
or more host targets. For each job, you can uninstall one liberty
resource type:
- Project
- Runtime environment
- Software development kit (SDK)
- Server
- Application binary file
From the console, choose the Uninstall Liberty
profile resources job, specify resource and job options,
review the summary, and submit the job.
Instead of using a console,
you can run the uninstallLibertyProfileResources job script in the
AdministrativeJobs command group. See the Administrative job types
topic.
Procedure
- Click from the navigation tree of the administrative console.
- Choose a job to uninstall a liberty resource.
- Select the Uninstall Liberty profile resources job
type from the list.
- Optionally specify a description of the job.
- Click Next.
- Choose the job targets from which to remove the resource.
- Select a group of targets from the list, or select Target
names.
Only groups of targets that are valid
for the job type that you selected are displayed in the list of target
groups.
- If you selected Target names,
then specify a target name and click Add, or
click Find and specify the chosen targets on
the Find targets page.
- If you did not choose to save security
authentication information when registering the target hosts with
the job manager, specify an operating system user name and password
or public-private key information for access to the target hosts.
The security credentials must be valid for all the job targets.
- Click Next.
- Specify parameters for the uninstall Liberty profile resources job.
- Specify only one resource type. Do not specify a resource in more
than one field on the Specify job parameters page.
- You can specify a resource name or a resource ID. If a resource
name resolves to more than one resource of the same name, the product
returns an error and does not remove the resource.
- If you specify to uninstall a server and the server is running,
the product stops the server before removing the resource.
- If you specify to uninstall a project or run time, the product
searches all the servers for the project or runtime. For each identified
server that is running, the product stops the server before attempting
to remove the resource.
- Specify a resource name or a resource ID for one of
the resource types.
To see the names of existing liberty
resources on the targets, click Find for the
resource type on the Specify job parameters page.
On the Find target resources page, click Find to
find a resource identifier. Select the resource to remove.
For example, suppose you want to
uninstall the DefaultWebApplication.war application
binary resource from the defaultServer server in
the wlp runtime. For Application binary
file to uninstall, specify the resource identifier:
runtime/wlp/liberty_server/defaultServer/application_binary/DefaultWebApplication.war
For Force deletion
of resources, optionally specify whether to delete resources
even if their status cannot be detected. The default
is not to force deletion of resources. When the option is selected,
server resources are deleted even if the status of the server resources
cannot be detected or the servers cannot be stopped.
If the
status for a server cannot be detected, the Uninstall Liberty
profile resources job fails unless Force deletion
of resources is selected.
- Click Next.
- Schedule the job.
The times and dates that
you specify are relative to the job manager.
- Optionally specify one or more email addresses where
notifications are sent when the job finishes.
If you
specify multiple email addresses, separate them with commas.
- Select when the job is available for submission.
- Select the job expiration.
- Optionally specify a recurring interval for the job,
a start date and time for the interval, and an end date and time for
the interval.
- Click Next.
- Review the summary, and click Finish to
submit the job.
Results
The targets run the job and attempt to remove the specified Liberty profile resource.
Avoid trouble: If the job fails, some of the associated files
might remain, leaving the resource in a corrupt state. If you manually
change resource files to fix the problem, after changing the files,
run an
Inventory job to update the inventory
of target resources in the job manager.
gotcha
What to do next
On the Job status page, click the
ID of the Uninstall Liberty profile resources job
and view the job status. Click the status refresh icon
to refresh the displayed status.
If
the job is not successful, view any error messages that result from
running the job, correct the error condition, and submit the job again.
If
the job is successful, click to verify that
the liberty resource is no longer in the list of resources.