Problem Note 58621: The SAS® Environment Manager agent fails to start and returns the error "Unable to register agent: Permission denied"
If a warning occurs when you configure SAS Environment Manager, the following output might be displayed when you instruct the SAS Environment Manager agent to start or restart:
[sas@hostname bin]$ ./hq-agent.sh start Starting HQ Agent...... running (31510). [ Running agent setup ] Should Agent communications to HQ be unidirectional [default=no]: yes
What is the HQ server IP address: hostname.sas.com Should Agent communications to HQ always be secure [default=yes]: no
What is the HQ server port [default=7080]: 7080 - Testing insecure connection ... Success
What is the HQ server SSL port for unidirectional communications [default=7443]: 7443 - Testing secure connection ... Success
What is your HQ login [default=hqadmin]: sasevs@saspw
What is your HQ password: **Not echoing value**
What is the agent IP address [default=192.168.1.1]: hostname.sas.com - Received temporary auth token from agent - Registering agent with HQ - Unable to register agent: Permission denied
This Permission denied error is caused by a permission issue with the sasevs@saspw internal account within SAS Environment Manager.
Check the Instructions.html file in the SAS-configuration-directory/Lev1/Documents/ directory on the middle tier for any additional steps required for the SAS Environment Manager configuration. The steps listed in this file might include verifying that the sasevs@saspw account exists within the SAS Environment Manager web console and verifying that the SAS App Tier Role is assigned to sasevs@saspw.
For reference, the instructions below typically surface in the Instructions.html file when SAS Environment Manager encounters errors in creating or assigning correct permissions to the sasevs@saspw internal account during configuration.
Create the New SAS® Environment Manager Role
- Log on to the SAS Environment Manager web console. The default port is http://hostname.example.com:7080/ (this port is recorded in Instructions.html).
- Click List Roles on the Manage page.
- If the SAS App Tier Role role exists in the Roles list, then skip the following steps and go directly to the next section ("Synchronize the SAS® Environment Manager Service Account").
- Click New Role on the Manage page.
- In the Properties section of the New Role page, enter the following values:
- Name: SAS App Tier Role
- Description: SAS App Tier Role
- Click OK to save the new role.
Synchronize the SAS® Environment Manager Service Account
- Log on to the SAS Environment Manager web console.
- Click Synchronize Users on the Manage page.
- Click List Users on the Manage page.
- Click sasevs@saspw in the User list.
- If the SAS App Tier Role role exists in the Roles Assigned To list, skip the following steps and restart all SAS Environment Manager agents.
- Click Add to List in the Roles Assigned To section of the New Role page.
- In the Roles panel on the left side of the page, select the SAS App Tier Role role to add this role, and then click the blue arrow to move the role to the Assign To Role panel.
- Click OK to save.
- Restart all SAS Environment Manager agents.
Operating System and Release Information
SAS System | SAS Environment Manager | Microsoft® Windows® for x64 | 9.4 TS1M0 | 9.4 TS1M4 |
64-bit Enabled AIX | 9.4 TS1M0 | 9.4 TS1M4 |
64-bit Enabled Solaris | 9.4 TS1M0 | 9.4 TS1M4 |
HP-UX IPF | 9.4 TS1M0 | 9.4 TS1M4 |
Linux for x64 | 9.4 TS1M0 | 9.4 TS1M4 |
Solaris for x64 | 9.4 TS1M0 | 9.4 TS1M4 |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
The SAS Environment Manager agent fails to start and returns this error: "Unable to register agent: Permission denied" The failure prevents the SAS Environment Manager Agent from connecting to the SAS Environment Manager Server and from sending metrics.
Type: | Problem Note |
Priority: | medium |
Date Modified: | 2016-09-08 11:50:38 |
Date Created: | 2016-07-15 10:29:31 |