March 29, 2019

This document describes how to setup the DomainService that runs on each domain (or workstation in a workgroup) to create and manage identities for technicians.

Definitions:

Target Machine – Domain Controller, or a machine not in domain, where identities will be managed

Client ID – Guid assigned by RuffianSoftware in the form XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX where X is an alphanumeric character. If you don’t have one yet Request a Client ID.

DomainService.zip – File with all the required executable parts of the DomainService from the CD or downloaded from the RuffianSoftware webpage for the DomainService. Usually DomainService_V_B.zip where V is the version and B the architecture (86/64)

Install Folder – Folder on the Target Machine where all the domain service files will reside. By convention this is c:\Program Files\RuffianSoftware.

Steps:

1. Copy all DomainService.zip to the Install Folder on the Target Machine. Extract the contents of DomainService.zip
2. From an administrative commandline in the Install Folder run the following commands

DomainService install clientguid {Client ID} [friendlyname {FN}] [rmmname {RN}] [OU {OUName}]

1. Don’t put the brackets {}, and don’t worry, the DomainService commandline can be rerun at any time to change or add names or other options.
2. Replace {Client ID} with the Guid assigned from RuffianSoftware
3. Replace {FN} with a name to see in the TechClient tool to easily identify this domain when searching for a username/password combination.
4. Replace {RN} with a name to see in the TechClient tool to easily identify this domain when searching for a username/password combination. 
5. Replace {OUName} with the Active Directory Organization Unit name to put all managed technician accounts. More on the OUs within TechIdManager – https://ruffiansoftware.com/ad-ou-feature-in-domainservice-piece-of-techidmanger
6. The command should finish with something about success like this:

3. From an administrative commandline run the following commands

net start RuffianDomainService

1. The command should result in a message about the service started successfully like this:

At this point the domain will be assigned to the “All Domains” domain group in the Management Console and any techs and rights assigned with “All Domains” in a DomainTechRights group will be created.