Uninstalling Platform Agents on Windows

The basic steps that need to be completed to remove RunMyJobs from a Windows server are the following.

  • Remove the service(s).
  • Remove the program directory.
  • Remove output files.

All three steps are normally performed using the regular Platform Agent Service Manager.

Procedure

To remove a platform agent, follow this procedure.

  • Start the Platform Agent Service Manager. If there is no shortcut accessible via the Start menu, use the Explorer to browse to the installation directory and run the servicemanager.exe program located at ${InstallDir}\${version}\bin.
  • Select the desired service and click Stop. If the service takes a long time to stop, you may need to click Refresh to show the updated status.
  • Click Uninstall. If the Platform Agent Service Manager detects instance-specific files, such as job output files, it will ask if you want to remove these files as well. If this is the last instance that used a particular installation directory, it will also remove that directory.

Manually Removing the Service

It is best to remove the service with the procedure above. However, if the ${InstallDir}\${version}\bin directory is removed before the services are removed, the services must be removed manually. This can be done with the sc command using the following syntax, where <service> is the Service Name (not the Display Name of the service). The Service Name of the default instance is jcs_default, and other instance Service Names are jcs_<instance>. The Display Name is Scheduler Platform Agent <instance>.

sc delete <service>

To remove a service, follow this procedure.

  1. Open services.msc.
  2. Locate any services with a Display Name that starts with Scheduler Platform Agent, and retrieve their Service Name (as displayed in the properties pane). Stop the services by choosing Stop from their context menu.
  3. For each service stopped in the previous step, issue the command sc delete <Service Name>. Note that you will have to restart services.msc to see the changes take effect.
  4. Remove the directories as usual in Microsoft Windows. The Platform Agent installs no registry items, DLLs, or COM objects, so you do not need to worry about those.