Troubleshooting issues with Help access in application
Normally, clicking Help in Internal Audit will take you to a web page containing the product help pages.
If you click on the Help link and are taken to a page with an error such as:
403 – Forbidden: Access is denied
404 – File or directory not found
. . then this normally indicates that either the application configuration is pointing to an incorrect location, or that the Help files have not been copied correctly to the server during the system installation.
To fix this, you will need:
- Access the server
- Internal Audit install file set
- A configured App Manager instance
The desktop application and WebUI have different help guides, stored at different paths. You may need to follow one or both of the procedures below, depending whether one or both are affected.
For the desktop application
- At the application server, open App Manger
- Select the correct application instance
- Go to the [Config] tab
- Click on the [Client] tab
- Locate the line <add key="HelpUrl" value="…" />
If the Value is a valid URL for the server, e.g. https://yourserver.domain.com/PentanaPRD/Help:
The path specified is where the client is expecting to find the help files:
- Go to the Internal Audit install file set
- In the Help\Single Client Help subfolder you will find the help files for the desktop application
- Copy these files, and paste them to the path specified in App Manager
- You should now find that clicking Help in the application takes you to the documentation pages
If the Value is [helpURL]:
This means that the help path has never been configured:
- Decide where the help files should be located, e.g. https://yourserver.domain.com/PentanaPRD/Help
- Overwrite [helpURL] with this URL
- Click the Save icon
- If you are using ClickOnce then this will cause the Internal Audit desktop client to download a an updated version of the config file when it is next started
- If you are distributing the client with another method, then you will need to distribute the updated exe.config file to your users
- Go to the Internal Audit install file set
- In the Help\Single Client Help subfolder you will find the help files for the desktop application
- Copy these files, and paste them to the path specified in App Manager
- You should now find that clicking Help in the application takes you to the documentation pages
For the WebUI
- At the application server, open App Manger
- Select the correct application instance
- Go to the [Config] tab
- Click on the [WebUI] tab
- Locate the line <add key="HelpUrl" value="…" />
If the Value is a valid URL for the server, e.g. https://yourserver.domain.com/PentanaPRD/WebHelp:
The path specified is where the client is expecting to find the help files:
- Go to the Internal Audit install file set
- In the Web\Web Module Help subfolder you will find the help files for the WebUI
- Copy these files, and paste them to the path specified in App Manager
- You should now find that clicking Help in the application takes you to the documentation pages
If the Value is [webHelpURL]:
This means that the help path has never been configured:
Note: following the steps below will cause the WebUI application to restart and disconnect anyone currently connected
- Decide where the help files should be located, e.g. https://yourserver.domain.com/PentanaPRD/WebHelp
- Overwrite [webHelpURL] with this URL
- Click the Save icon
- Go to the Internal Audit install file set
- In the Web\Web Module Help subfolder you will find the help files for the WebUI
- Copy these files, and paste them to the path specified in App Manager
- You should now find that clicking Help in the application takes you to the documentation pages