Group Configuration Example

Once user groups have been enabled, as described in the preceding section, groups can be created and users added to their respective groups.  Note that VTS does not maintain a list of user groups: simply adding the <Group><NameSpaceDelimiter> prefix to a user name will both create the group and make the user a member of it.  

The following steps will enable groups, create a group named "op_PlantA" and add a user to that group.

1.   Stop the VTS application for which you wish to configure user groups.

2.   Navigate to your application's directory (within the VTS installation directory).

3.   Open the "SecurityManager.ini" file using the text editor of your choice.

4.   Ensure that "NameSpaceDelimiter" appears beneath the "[SecurityManager-Admin]" heading in the SecurityManager.ini file.

If it does not, add it.

5.   Set "NameSpaceDelimiter" to a character (or characters) that will be used to separate group names from user names.

In this example, we will use a colon (:) as shown in the example below.

[SecurityManager-Admin]

...

NameSpaceDelimiter = :

6.   Ensure that "GroupLogin" appears beneath the "[SecurityManager-Admin]" heading in the SecurityManager.ini file. If it does not, add it.

7.   Set "GroupLogin" to 1, as shown in the example below.

[SecurityManager-Admin]

...

NameSpaceDelimiter = :

GroupLogin = 1 

8.   Save and close the "SecurityManager.ini" file.

9.   Run the application.

10. Click the "Logon" button.

The "Please Logon" dialog opens.

11. Leave the "Group" field blank.

12. Logon to the application using the Manager1 account and password, or using an existing account that has the "Manager" privilege assigned to it.

Because this account has not been assigned to any group, it will have full access to all user accounts on the local machine, regardless of group. (For this reason, it is recommended that your application have at least one such user account with the "Manager" privilege assigned to it – see the "Note" below for further details.)

13. Click the logon button, which is now labeled with the username of the account you just used to logon (i.e."Manager1").

A dialog opens, showing a list of buttons for the security options.

14. Click the "Users" button.

The "Accounts" dialog opens.

15. Click the "Add" button.

The "Add Account" dialog opens.

16. In the "Username" field, enter the following (from the example above):

op_PlantA:JSmith

Where "op_PlantA" is the group to be created, ":" is the name space delimiter and "JSmith" is the account username.

17. Enter a password for this new account in the "Password" field.

18. Enter the password for this new account in the "Confirm Password" field.

19. Click the checkboxes according to the privileges you wish to grant to this user.

(Information on the VTS system privileges can be found in System Privileges).

20. Click the "OK" button.  

A new group named "op_PlantA" has been created and a new account, "JSmith", has been created and assigned to the op_PlantA group.

21. Log off from the manager account and test the newly created group by logging in as the new user.

You may repeat the above instructions to create as many groups and/or user accounts as you need.

Note: It is important that the "Manager1" account (or its equivalent), not be given a group name prefix. This account will enable you to view and modify all security accounts, regardless of their group configuration.