Uninstalling a file package from hosts

Uninstall a file package that you installed using the repository server from multiple hosts.

About this task

To remove a file package from a group of hosts, send an uninstall request to the repository server. The repository server removes the file package by remotely starting the rsdeploy agent on each host. The rsdeploy agent runs the uninstall script to remove the files from the host, then removes the file package.

Procedure

Use the rsdeploy uninstall command to uninstall a file package.

rsdeploy uninstall package_name [—c consumer —r resource_group | —r resource_group] [—t host_name] [—u user_name] [—x password]

For example, to uninstall the file package with the default settings,

rsdeploy uninstall mypkg.v1

The repository server attempts to uninstall mypkg.v1 (using the uninstall script included with the file package) on all hosts in the cluster using the default consumer /ClusterServices/EGOClusterServices and the resource group InternalResourceGroup.

The execution user for the installation is the user associated with the consumer, normally the installation user. The execution user must have sufficient access rights to run the uninstall script and remove the directory.

Results

Uninstalling the file package does not remove it from the repository server.

What to do next

If some hosts were unavailable during the uninstallation, run rsdeploy uninstall again when the hosts become available or use rsdeploy status to view the status of the uninstall.

Note: The repository server does not automatically uninstall the file package from unavailable hosts when they become available. You must manually run rsdeploy uninstall when the hosts become available.

If you no longer need the file package, remove it from the repository server.