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[1][2] in the Install Folder run the following commands

DomainService install clientguid {Client ID} friendlyname {FN}

1. Don’t put the brackets {}.
2. Replace {FN} with a name to see in the TechClient tool to easily identify this domain when searching for a username/password combination.
3. Replace {Client ID} with the Guid assigned from RuffianSoftware
4. 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.

[1] Optionally “rmmname {RN}” can be added to this commandline to specify an RMMName. RMMName is also shown in the TechClient for searching.

[2] The DomainService commandline can be rerun at any time to change or add names.