Modifying, repairing, or uninstalling the Windows client

You can modify, repair, or uninstall an existing Windows client.

Before you begin

If you plan to modify or repair the client and it is installed on the same system as the IBM® Storage Protect server version 8.1.2 or later level, ensure that you halt the IBM Storage Protect server before you modify or repair the client. This action will prevent the client installation process from forcing the system to reboot. After you modify or repair the client, you can restart the IBM Storage Protect server.

About this task

Use the Windows control panel to modify, repair, or uninstall the Windows client.

Procedure

Click Start > Control Panel > Uninstall a program.
Select IBM Storage Protect Client in the list of installed programs.

Select the function that you want to perform: Repair, Change, or Uninstall.

Option Description

Repair

Option	Description
Repair	Wait for any in-progress backup-archive client tasks to completed before you repair the Windows client. This option repairs an existing Windows client installation. If you select Repair, the files installed by the installation program are examined to determine whether they have somehow become corrupted. If a file is determined to be corrupted, the repair option attempts to replace it from the saved installation image. The repair option also repairs missing program short cuts and icons, missing files, and registry keys.
Change	Wait for any in-progress backup-archive client tasks to completed before you modify the Windows client. This option modifies an existing installation. If you select Change, the next screen that is displayed shows Modify as the option for changing installed programs. If you already installed the client and you need to add or remove components, click Change, and select Modify. Choose the icon next to the feature that you want to install or remove and select the appropriate action from the drop-down list. For example, if you selected a typical installation when you installed the client, the administrative client command line interface files are not installed. If you decide that a node needs this interface, select the icon next to Administrative Client Command Line Files and click the This feature will be installed on local hard drive option. Note: This option achieves the same effect as upgrading the client. The difference is that you bypass the initial steps and the installation process begins with the last installation type that you selected. If you want to change the installation type, you can click Back, and select the new installation type; then complete the information as you are prompted for it. Use the information that is provided in Upgrading the Windows client (start at step 7) if you have questions about a prompt.
Uninstall	Wait for any in-progress backup-archive client tasks to completed before you uninstall the Windows client. This option uninstalls the Windows client program. It does not remove any client services. It also does not remove log files, or other items that were created when you configured or used the client. Most of these artifacts remain in the installation directory (Program Files\Tivoli\TSM directory), but they can exist anywhere on the disk, depending on what you chose for the installation directory and other options. This option also does not remove files that were copied to the local disk if you extracted the installation files from a compressed distribution file. Leaving these artifacts on disk is not a problem if you want to reinstall the client in the future. However, if you want to more thoroughly remove the client and related files and settings, see the support article How to completely remove the Backup-Archive client from Microsoft Windows. The installation program stops any client services that are running before it uninstalls the software. If you want to stop the services yourself, type the following commands at a command prompt window: `net stop "tsm journal service"` `net stop "tsm client acceptor"` `net stop "tsm client scheduler"` `net stop "tsm remote client agent"` You can also use the Control Panel to stop these services. Their display names match the name used on the command line. Note: The service names shown here are the default names that are set by the installation program. You can change some of these service names when you configure the services using one of the configuration wizards on the Utilities > Setup Wizard menus. If you change the service name, record the name that you specify and use that name to stop the services. If you want to remove any of these services without uninstalling the client, perform the following steps: Click Start > All Programs > IBM Storage Protect > Backup-Archive GUI. Click Utilities > Setup Wizard. Select and run the wizard for each service that you want to remove. The setup wizard options can also remove the configuration information for online image support and open file support.

Wait for any in-progress backup-archive client tasks to completed before you repair the Windows client.

This option repairs an existing Windows client installation. If you select Repair, the files installed by the installation program are examined to determine whether they have somehow become corrupted. If a file is determined to be corrupted, the repair option attempts to replace it from the saved installation image. The repair option also repairs missing program short cuts and icons, missing files, and registry keys.

Change

Wait for any in-progress backup-archive client tasks to completed before you modify the Windows client.

This option modifies an existing installation. If you select Change, the next screen that is displayed shows Modify as the option for changing installed programs. If you already installed the client and you need to add or remove components, click Change, and select Modify. Choose the icon next to the feature that you want to install or remove and select the appropriate action from the drop-down list. For example, if you selected a typical installation when you installed the client, the administrative client command line interface files are not installed. If you decide that a node needs this interface, select the icon next to Administrative Client Command Line Files and click the This feature will be installed on local hard drive option.

Note: This option achieves the same effect as upgrading the client. The difference is that you bypass the initial steps and the installation process begins with the last installation type that you selected. If you want to change the installation type, you can click Back, and select the new installation type; then complete the information as you are prompted for it. Use the information that is provided in Upgrading the Windows client (start at step 7) if you have questions about a prompt.

Uninstall

Wait for any in-progress backup-archive client tasks to completed before you uninstall the Windows client.

This option uninstalls the Windows client program. It does not remove any client services. It also does not remove log files, or other items that were created when you configured or used the client. Most of these artifacts remain in the installation directory (Program Files\Tivoli\TSM directory), but they can exist anywhere on the disk, depending on what you chose for the installation directory and other options. This option also does not remove files that were copied to the local disk if you extracted the installation files from a compressed distribution file.

Leaving these artifacts on disk is not a problem if you want to reinstall the client in the future. However, if you want to more thoroughly remove the client and related files and settings, see the support article How to completely remove the Backup-Archive client from Microsoft Windows.

The installation program stops any client services that are running before it uninstalls the software. If you want to stop the services yourself, type the following commands at a command prompt window:

net stop "tsm journal service"
net stop "tsm client acceptor"
net stop "tsm client scheduler"
net stop "tsm remote client agent"

You can also use the Control Panel to stop these services. Their display names match the name used on the command line.

Note: The service names shown here are the default names that are set by the installation program. You can change some of these service names when you configure the services using one of the configuration wizards on the Utilities > Setup Wizard menus. If you change the service name, record the name that you specify and use that name to stop the services.

If you want to remove any of these services without uninstalling the client, perform the following steps:

Click Start > All Programs > IBM Storage Protect > Backup-Archive GUI.
Click Utilities > Setup Wizard.
Select and run the wizard for each service that you want to remove. The setup wizard options can also remove the configuration information for online image support and open file support.

If you are uninstalling the backup-archive client, you must also uninstall the IBM Storage Protect Java™ Virtual Machine (JVM):
1. In the Control Panel window, click Uninstall a program.
2. In the Programs and Features window, select IBM Storage Protect JVM and click Uninstall.
3. Click Yes when prompted.