31.4 Configuring Custom File Paths

Access Manager provides a configurable list of files and directories for Identity Server and Access Gateway to export. This list contains default paths of the most frequently customized files. If you have customized any additional files or you have saved the custom file at any other location instead of the default directory, you must update the path before initiating the export process.

This list also contains paths of customized files for Access Manager installed Windows. You can ignore the paths if your setup is on Linux.

IMPORTANT:Ensure that the custom files do not include any system-specific data.

Perform the following steps to configure the custom file paths:

  1. In Administration Console Dashboard, click <user name> at the top right of the page and then click Code Promotion > Settings.

    Use this tab only when you export the configuration data. You do not need to make any change in file paths while importing the configuration data.

  2. Ensure that the paths are correct. Update the default paths with the actual paths wherever applicable.

    NOTE:You must provide the complete name of the custom file. Code Promotion does not support wildcard characters in file names. For example:

    Supported: /opt/novell/nam/mag/webapps/agm/WEB-INF/config/current/ErrorMessages.xml.en

    Not supported: /opt/novell/nam/mag/webapps/agm/WEB-INF/config/current/ErrorMessages.xml.*

  3. Click OK.

On Windows, Code Promotion does not support importing the custom files. If needed, import the files manually.

To import the Identity Server custom files manually on Windows, perform the following steps:

  1. Extract the exported Code Promotion file (NAMExportedConfig_***.namcfg).

    During the extraction process, if prompted, provide the same password given while exporting the configuration.

  2. After extracting the configuration file, go to the exportedconfig > exportedCustomConfig folder.

  3. Extract the respective custom configuration zip file for Identity Server (SCC*.tar.gz) and copy custom files manually to Identity Server devices.

    • You can see the list of custom files those are successfully imported in the filesSucceeded file available in the exportedCustomConfig > customfiles folder. All custom files, which are successfully imported, are available in the C#-# folder name representing the Windows C:\ partition.

    • Custom files located in C:\Program Files\Novell\Tomcat\webapps\nidp\jsp\main_custom.jsp are available in the C#-#\ Program Files\Novell\Tomcat\webapps\nidp\jsp\ folder.

    • The novlwww users have the file permissions, such as Full Control, Modify, and Read&Execute to perform file operations on custom files.

To import the Access Gateway custom files manually on Windows, perform the following steps:

  1. Extract the exported Code Promotion file (NAMExportedConfig_***.namcfg).

    During the extraction process, if prompted, provide the same password given while exporting the configuration.

  2. After extracting the configuration file, go to the exportedconfig > exportedCustomConfig folder.

  3. Extract the respective custom configuration zip file for Access Gateway and copy custom files manually to Access Gateway devices.

    • You can see the list of custom files those are successfully imported in the filesSucceeded file available in the exportedCustomConfig > customfiles folder. All custom files, which are successfully imported, are available in the C#-# folder name representing the Windows C:\ partition.

    • Custom files located in C:\Program Files\Novell\Tomcat\webapps\nesp\jsp\ are available in the C#-#\ Program Files\Novell\Tomcat\webapps\nesp\jsp\ folder.

    • The administrators have the file permissions, such as Full Control, Modify, and Read&Execute to perform file operations on custom files.