Team Authoring Administrative Functions

A special administrative utility is included when Doc-To-Help is installed. This utility, C1D2HTeamAdmin.exe, should be used by the Doc-To-Help administrator to perform certain actions, such as removing backup files, unlocking files from the repository, upgrading a team authoring project, or removing team authoring support from a working copy of a project. See Team Authoring.

C1D2HTeamAdmin.exe can be found in \\Program Files (x86)\MadCap Software\DocToHelp. Double-click on it to open.

In addition to setting up a team project (see Setting Up a Team Project), following are the primary tasks of an administrator:

  • Change Repository Settings When a project is first set up for team authoring using the Share Project Wizard, the author sharing the project determines if the number of backup files kept in the repository for each file is limited, and, if so, to how many. The author also determines whether other team members can delete old backup files when they check a newer version of the file into the repository and the limit of backups for that file has been exceeded. These settings can be changed by the administrator using C1D2HTeamAdmin.exe. See Changing Repository Settings.
  • Remove Backup Files To conserve the repository disk space, an administrator should delete unneeded backup files from time to time. See Removing Backup Files From the Repository.
  • Remove Team Authoring Support You can remove team-authoring support from a local, working copy of a project. See Removing Team Authoring Support From a Working Copy.
  • Unlock Files in Repository Checking out a file creates a lock in the repository that prevents other team members from checking out the same file. This could cause a problem if an author checks out a file and forgets to (or cannot) check it back in. Then the file remains permanently locked, preventing the other team members from checking it out and modifying it. The administrator can manually remove the lock using C1D2HTeamAdmin.exe. See Unlocking Files in the Repository.
  • Unlock DHV File In certain circumstances, you may need to unlock a special file, <project_name>.dhv, located in the D2HTeamInfo folder created by Doc-To-Help. See Unlocking the DHV File.
  • Upgrade Project All users of a team project must have exactly the same version (including build number) of Doc-To-Help installed on their machines. To upgrade the project to a newer version of Doc-To-Help, the administrator must first upgrade the team project in the repository and then each team member can install the newest version of Doc-To-Help. See Upgrading a Team Authoring Project.

Note This utility is only used with team projects stored in a File System or Web Repository, not projects stored in Microsoft Team Foundation Server (TFS) repositories.