search cancel

Single Sign-On Agent for PeopleSoft Agent API initialization error


Article ID: 41845


Updated On:


CA Single Sign On Secure Proxy Server (SiteMinder) CA Single Sign On SOA Security Manager (SiteMinder) CA Single Sign-On



After installing or upgrading to the 12.51 Single Sign-On Agent for PeopleSoft, the PeopleSoft agent logs an error “Agent API init failed” despite the policy server being verified as reachable, and no failed handshake message is logged at the policy server.


12.51 Agent for PeopleSoft

Any version of PeopleSoft

Operating System and PeopleTools versions:

All unix operating systems listed, and all PeopleTools versions listed in the 12.51 Agent for PeopleSoft platform support matrix, located at:


Unlike previous versions of the Agent for PeopleSoft, environment variables must be set in your shell prior to starting the PeopleSoft server in order for the Single Sign-On agent API to function.


After installation of the agent, and before starting or restarting the PeopleSoft server to enable the agent, you must execute the following commands in your shell:

  • cd <installation directory of the agent for peoplesoft>
  • . ./

Note the notation of the second command, being dot space dot slash and then the file name.  This sources the environment variables within the file into your shell.  You can then proceed with starting the PeopleSoft server process.




Release: ESPSTM99000-12.51-Single Sign On-Extended Support Plus