Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Code Block
languagebash
sudo chown -R serveradmin:staff tomcat_v6_agent/
sudo chmod -R 750 tomcat_v6_agent/

Setup Password File

Create your password file using an editor. Do not use a command line because it may be logged into some kind of history file for example,

Code Block
languagebash
cd /opt/openam.0/agents
vi tomcat.2.password.txt 

Afterwards protect the file so only serveradmin has access,

Code Block
languagebash
 chmod 600 ./tomcat.2.password.txt

 

Run Setup

Before installing the policy agent, make sure OpenDJ and OpenAM are running. Also make sure the target tomcat server is currently off. Using serveradmin,

Code Block
languagebash
cd /opt/openam.0/agents/tomcat_v6_agent
./agentadmin --install

Here is the output of our sample install,

Code Block
-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Tomcat Server Config Directory : /opt/apache/tomcat.12/conf 
OpenSSO server URL : http://openam.krypton.com:8080/openam 
$CATALINA_HOME environment variable : /opt/apache/tomcat.12 
Tomcat global web.xml filter install : true 
Agent URL : http://krypton.com:81808280/examples 
Agent Profile name : jee 
Agent Profile Password file name :
/homeopt/svradm/openam.0/agents/tomcat.2.password.txt 
Verify your settings above and decide from the choices below.
1. Continue with Installation
2. Back to the last interaction
3. Start Over
4. Exit
Please make your selection [1]:

Updating the /opt/apache/tomcat.1

A successful install will look like the following,

Expand

Updating the /opt/tomcat.2/bin/setenv.sh

script

with

the

Agent

configuration

JVM

option

...DONE.


DONE.

Creating

directory

layout

and

configuring

Agent

file

for

Agent_001

instance

...DONE.

Reading

data

from

file

/opt/

j2ee_

openam.0/agents/tomcat

_v6_agent/

.2.password.txt

and

encrypting

it

...DONE.

Generating

audit

log

file

name

...DONE.

Creating

tag

swapped

OpenSSOAgentBootstrap.properties

file

for

instance

Agent_001

...DONE.

Creating

a

backup

for

file

/opt/

apache/

tomcat.

1

2/conf/server.xml

...DONE.

Creating

a

backup

for

file

/opt/

apache/

tomcat.

1

2/conf/web.xml

...DONE.

Adding

OpenSSO

Tomcat

Agent

Realm

to

Server

XML

file

:


/opt/

apache/

tomcat.

1

2/conf/server.xml

...DONE.

Adding

filter

to

Global

deployment

descriptor

file

:


/opt/

apache/

tomcat.

1

2/conf/web.xml

...DONE.

Adding

OpenSSO

Tomcat

Agent

Filter

and

Form

login

authentication

to


selected

Web

applications

...DONE.



SUMMARY

OF

AGENT

INSTALLATION


-----------------------------


Agent

instance

name:

Agent_001


Agent

Bootstrap

file

location:


/opt/openam

-agents

.0/

j2ee_

agents/tomcat_v6_agent/Agent_001/config/OpenSSOAgentBootstrap.properties


Agent

Configuration

file

location


/opt/openam

-agents

.0/

j2ee_

agents/tomcat_v6_agent/Agent_001/config/OpenSSOAgentConfiguration.properties


Agent

Audit

directory

location:


/opt/openam

-agents

.0/

j2ee_

agents/tomcat_v6_agent/Agent_001/logs/audit


Agent

Debug

directory

location:


/opt/openam

-agents

.0/

j2ee_

agents/tomcat_v6_agent/Agent_001/logs/debug

Install

log

file

location:


/opt/openam

-agents

.0/

j2ee_

agents/tomcat_v6_agent/installer-logs/audit/install.

l

 

log

Thank you for using OpenSSO Policy Agent

Test

Warning

Before testing make sure you log out of your current OpenAM login used to access the OpenAM console.

Go to the url of the protected application, http://krypton.com:8280/examples.

You should be redirect to the OpenAM login page. Enter in the credentials of a the created user.

References

http://openam.forgerock.org/doc/agent-install-guide/OpenAM-Agent-Install-Guide.html

...