Modifying the user home directory for the Layer 7 Policy Manager

Document ID : KB000057610
Last Modified Date : 14/02/2018
Show Technical Document Details

Solution

Background

The Layer 7 Policy Manager leverages the current user's home directory in order to create certain runtime files and directories for storing configuration data. By default, this directory is named ".l7tech" and is stored within the current local user's home directory. In some circumstances, this directory may need to be changed to meet organizational restrictions such as write permissions or ownership. Should you need to adjust the location of the Policy Manager's user configuration files, the following article would be applicable.

Implementation

Windows XP, 7, and 8 workstations

This requires that the Layer 7 Policy Manager has been previously installed on the workstation on which this procedure is being run. Additionally, the location must be mapped to a drive letter (such as C:\, D:\ or X:\). A UNC identifier?cannot be used.
  1. Open the Layer 7 Policy Manager configuration?file with a text editor.
Note: The file is located at C:\Program Files (x86)\Layer 7 Technologies\Layer 7 Policy Manager X.Y\Layer 7 Policy Manager.ini. The value of "X.Y" whould be substituted with the major and minor version number of the Policy Manager.
  1. Add -Duser.home="C:\path\to\home"

?Note: the value of "C:\path\to\home" should be substituted with the appropriate directory path

  1. Save the configuration file and exit the text edit
  2. Close the Layer 7 Policy Manager in order for the changes to take effect.
A screen capture of a sample configuration file can be seen as follows with the required changed highlighted for emphasis
A screen capture of a properly modified Policy Manager configuration file

UNIX-based workstatons

  1. Open the Manager.sh script in a text editor
  2. Add?-Duser.home="/home/user" to the end of the Java invocation. For example, a properly configured line would appear as follows:
$JAVA_HOME/bin/java $JAVA_OPTS $extra?-Duser.home="C:\path\to\home"?$run
?Note: the value of "/home/user" should be substituted with the appropriate directory path.
  1. Save the file and exit.
  2. Close the Layer 7 Policy Manager in order for the changes to take effect.
A screen capture of a sample configuration file can be seen as follows with the required changed highlighted for emphasis
A screen capture of a properly modified Policy Manager configuration file