Invalid CATALINA_HOME directory when installing Java EE policy agent 3.3.x for Apache Tomcat 6

Last updated Jan 5, 2021

The purpose of this article is to provide assistance when an invalid CATALINA_HOME directory error occurs when you are installing the Java EE policy agent 3.3.x for Apache Tomcat™ 6 on a Red Hat® or similar Linux® system.

1 reader recommends this article

This article has been archived and is no longer maintained by ForgeRock.


The following error is shown when attempting to install the Java EE policy agent:

Invalid CATALINA_HOME directory

Recent Changes



The path entered for the $CATALINA_HOME environment variable during the install is invalid.

The installer fails to verify the validity of the Tomcat server.


This issue can be resolved by upgrading to Java EE policy agent 3.5.0 or later; you can download this from BackStage.

Alternatively, you can resolve this in earlier versions by ensuring the following criteria are met:

  • When installing the Java EE policy agent and the Enter the $CATALINA_HOME environment variable: prompt is displayed, you must enter the path to the root of the Tomcat installation rather than the actual name of the environment variable.
  • The $CATALINA_HOME/lib/catalina.jar file exists and is readable.
  • The $CATALINA_HOME/bin/setclasspath.bat or $CATALINA_HOME/bin/ file exists, and is readable and writable.
  • All the Tomcat scripts exist in the $CATALINA_HOME/bin directory. If the scripts do not exist in your installation, copy the contents of the bin directory from a .zip download of Tomcat that is of the same version as the one you have installed.

See Also

OpenAM Java EE Policy Agent Installation Guide

Related Training


Related Issue Tracker IDs

OPENAM-2801 (Tomcat agent fails to install on Redhat)

Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.