Managing Users and Groups

About this task

Historian provides default security groups and a user, ihCloudHistAdmin, for the ih_security_admins group. This topic describes how to create more users and add them to groups. You can also delete a user or remove the user from a group.

Procedure

Access the folder containing the uaa_config_tool.exe file. It is provided with the collectors installer. After you install collectors, it will be available in the C:\Program Files\GE Digital\Historian Cloud Config folder by default.
To create a user, run the following command:
```
uaa_config_tool.exe add_user 
-u <username> 
-p <password> 
-s <admin password> 
-t https://<NLB DNS>:8080
```
For <admin password>, enter the password that you provided in the UAA Configuration field while deploying Proficy Historian for AWS.
For <password>, enter a value that contains:
- Minimum eight characters
- At least one each of uppercase and lowercase letters
- At least one number
- At least one special character
Tip: To find the NLB DNS:
1. Access the EKS cluster on which you have deployed Proficy Historian for AWS.
2. Access the EC2 instance.
3. In the navigation pane, under Load Balancing, select Load Balancers.
4. Select the load balancer for which you want to find the DNS.
5. In the Description section, copy the DNS name.
To add a user to a group, run the following command:
```
uaa_config_tool.exe add_user_to_group 
-g <group name>
-u <username> 
-p <password> 
-s <admin password> 
-t https://<NLB DNS>:8080
```
where <admin password> is the password that you provided in the UAA Configuration field while deploying Proficy Historian for AWS.
For <password>, enter a value that contains:
- Minimum eight characters
- At least one each of uppercase and lowercase letters
- At least one number
- At least one special character
Tip: For a list of default security groups, refer to Default Security Groups.

To remove a user from a group, run the following command:

uaa_config_tool.exe remove_user_to_group 
-g <group name>
-u <username>   
-t https://<NLB DNS>:8080

To delete a user, run the following command:

uaa_config_tool.exe remove_user
-g <group name>
-u <username> 
-s <admin password> 
-t https://<NLB DNS>:8080