Frm-18105 Failed | To Start The Help System
In the world of Oracle Forms, FRM-18105: Failed to start the Help System is a classic "ghost in the machine" error. It typically happens when the Form Builder is ready to work, but the bridge to its documentation is broken. The Backstory: Why It Fails
This error is rarely about the help files being missing; it's almost always a communication breakdown between the Form Builder and the Java environment required to render the help viewer.
Permissions Blockade: The most common "deep" reason is that the Windows user doesn't have sufficient privileges to execute the Java components or access the specific Oracle Home folders where the help libraries live.
Java Identity Crisis: If multiple Java versions are installed (like a mix of JDK 1.8 and older versions), the Form Builder might be trying to "speak" to the wrong one.
Missing Bridges (Environment Variables): The Builder needs a specific map—defined by variables like FORMS_BUILDER_CLASSPATH—to find its help-related .jar files. How to Fix the "Story"
If you're stuck in this loop, here is the sequence of events to get the help system back online:
The "Admin" Shortcut: Many users find that simply right-clicking the Form Builder and selecting Run as Administrator bypasses the error entirely by granting the necessary file system permissions.
Define the Classpath: Ensure your system knows where the help libraries are. A common fix involves adding a FORMS_BUILDER_CLASSPATH variable to your Environment Variables:
Include paths like %ORACLE_HOME%\jlib\ohj.jar and %ORACLE_HOME%\jlib\help-share.jar.
Check Java Alignment: Make sure your PATH variable points to the correct Java version (usually JDK 1.8 for modern Forms versions) and that it appears before any other Java entries.
Folder Permissions: If you can't run as Admin, manually grant "Read & Execute" permissions to your specific Windows user for the C:\Oracle\Middleware\Oracle_Home folder.
For deeper technical troubleshooting, Oracle recommends checking the Java stack trace (found via the "Details" button if available) to see exactly which library is failing to load.
The error FRM-18105: Failed to start the help system typically occurs in Oracle Forms when the application cannot launch the help viewer (usually a .hlp or .chm file, or Oracle's internal help).
Here’s a helpful troubleshooting guide to resolve it:
Oracle Forms locates the help file using a registry key. For Forms 6i:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\FORMS60_HELP_PATH
For Forms 9i/10g:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_DevSuiteHome1\FORMS90_HELP_PATH
Required value: The full path to a valid help file, e.g.,
C:\ORANT\FORMS60\FORMS60.HLP or C:\DevSuite\help\forms.chm.
Steps to fix:
Note for 64‑bit Windows: Registry redirection may apply. Check both
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ORACLE\...
The Oracle Forms error FRM-18105: Failed to start the help system is a configuration issue, not a code bug. It appears when the Forms runtime cannot locate or launch the designated help viewer. By methodically checking the registry (client‑server) or the virtual path and server files (web), you can resolve the error in under 15 minutes.
If you have followed this guide and still see the error, contact Oracle Support with a copy of your formsweb.cfg (web) or your registry export (client‑server) and the exact version of Forms you are using. In most real‑world cases, the problem is a missing help file or a disabled WinHelp component on a modern Windows OS.
Next step: After fixing, test every form that includes context‑sensitive help. Also inform your end‑users that F1 help is restored.
Last updated: March 2025. Compatible with Oracle Forms 6i through 12c.
FRM-18105: Failed to start the help system typically occurs in Oracle Forms Builder (specifically version 12c) when the tool cannot initialize the Java-based online help components
. This is often due to environment variable conflicts, incorrect Java pathing, or incomplete installation privileges. Common Causes Path Conflicts
: Multiple Oracle product installations (like older versions of Oracle Client or Middleware) may appear earlier in the system
than the current Forms Home, causing the Builder to load incompatible libraries. Missing Environment Variables FORMS_BUILDER_CLASSPATH
or specific Java-related variables may not be correctly defined for the Builder's help system to locate its required Privilege Issues
: If the Oracle Fusion Middleware was not installed using "Run as Administrator," certain registry keys or configuration files required for the help system might be missing. Java Version Mismatch
: The Forms Builder requires a specific JDK version (typically JDK 8 for 12c). If a newer Java version (like Java 11 or 17) is primary in the system path, it can break the help subsystem. Recommended Solutions Adjust the System PATH
Ensure the Oracle Forms 12c bin directory is at the very beginning of your Windows System Path. Advanced System Settings Environment Variables Move the entry for your Oracle 12c Home (e.g., C:\Oracle\Middleware\Oracle_Home\bin ) to the top of the list. Define FORMS_BUILDER_CLASSPATH
Manually adding the classpath can help the Builder find the help system jars: Create a new System Variable named FORMS_BUILDER_CLASSPATH Set its value to include the help jars, typically found in:
%ORACLE_HOME%\jlib\ohj.jar;%ORACLE_HOME%\jlib\help-share.jar;%ORACLE_HOME%\jlib\oracle_ice.jar Run as Administrator Always launch the Forms Builder ( frmbld.exe ) by right-clicking and selecting Run as Administrator
to ensure it has full access to the required local resources. Verify Java Configuration frm-18105 failed to start the help system
Confirm that the JDK 8 path is correctly referenced in your environment. If the help system still fails, check the
section in the Forms Builder to see which Java version it is currently utilizing. Re-installation (Last Resort)
If environment tweaks fail, the installation may be corrupted. A clean reinstall often requires deleting the Oracle registry keys under HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE
and the physical installation directory before starting a fresh install with full administrative privileges. or do you need help locating your Oracle Home directory
FRM-18105: Failed to start the Help System. Form Builder 12.
Troubleshooting FRM-18105: Failed to Start the Help System If you are working with Oracle Forms Developer and encounter the error "FRM-18105: Failed to start the help system," you aren't alone. This is a common legacy issue that typically occurs when the application tries to launch the help documentation but cannot find the necessary engine or file pathing to execute it.
While it doesn't usually crash your workspace, it can be a major roadblock when you need quick syntax references or property palette explanations. What Causes FRM-18105?
This error is almost always related to a disconnect between the Oracle Forms executable and the Windows Help subsystem. The primary culprits are:
Missing WinHlp32.exe: Modern versions of Windows (Vista and later) do not include the legacy Help engine required by older Oracle software.
Incorrect Registry Keys: The path pointing to the help files is broken or missing.
Environment Variables: The FORMS_PATH or ORACLE_HOME is not correctly identifying where the .hlp or .chm files reside. Step-by-Step Solutions 1. Install the Windows Help Program (WinHlp32.exe)
Most Oracle Forms versions (like 6i or 10g) rely on .hlp files. Microsoft discontinued the viewer for these files due to security concerns.
The Fix: You may need to download the WinHlp32.exe update specifically for your version of Windows from the official Microsoft Support site.
Note for Windows 10/11 users: Since Microsoft has officially retired this, you might need to use a third-party "WinHlp32 fix" script available on developer forums like GitHub to restore functionality. 2. Verify the ORACLE_HOME Environment Variable
Oracle Forms looks for help files relative to your installation directory.
Right-click This PC > Properties > Advanced System Settings > Environment Variables.
Ensure ORACLE_HOME points to the correct directory (e.g., C:\DevSuiteHome_1).
Check that the FORMS_PATH variable includes the folder where your help files are stored. 3. Update the Registry Settings
Sometimes the path is hardcoded in the Windows Registry during installation and gets corrupted if the folder is moved. Press Win + R, type regedit, and hit Enter.
Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE (or HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ORACLE on 64-bit systems). Look for the key related to your Oracle Home.
Ensure the string value for FORMS_HELP or FORMS60_PATH (depending on version) is pointing to the directory containing the .hlp files. 4. Run as Administrator
Oracle Forms Developer often requires elevated permissions to trigger external processes like the Help System. Close the application, right-click the shortcut, and select Run as Administrator. If this fixes it, you can permanently set this in the shortcut’s Compatibility tab. The Modern Workaround: Online Documentation
Since the built-in help system in Oracle Forms is based on aging technology, many developers find it faster to bypass the error entirely.
Oracle maintains comprehensive Online Documentation Libraries. If you are using Oracle Forms 11g or 12c, the documentation is provided in PDF and HTML formats online, which are more searchable and up-to-date than the local .hlp files that trigger the FRM-18105 error.
To fix FRM-18105, your first move should be checking if WinHlp32.exe is functional on your machine. If it is, a quick check of your Environment Variables will usually bridge the gap and get your help system back online.
The FRM-18105: Failed to start the help system error typically occurs in Oracle Forms Builder (especially versions 11g and 12c) when the local environment is missing critical registry entries or permissions required to launch the Java-based help viewer. 1. Execute as Administrator
The most common workaround is a lack of elevated permissions.
Action: Close Forms Builder. Right-click the Forms Builder executable (or its shortcut) and select Run as Administrator.
Why it works: Certain help components require administrative access to initialize Java classes or registry keys on the first run. 2. Run the Configuration Script (Standalone Installations)
If you performed a "Standalone" installation, the help system often remains unconfigured until a specific script is run.
Action: Open an elevated command prompt and run config_builder.cmd (found in your ORACLE_HOME/bin directory).
Requirement: You must run this using an elevated shell (Run as Administrator) for it to correctly register components. 3. Verify Environment Variables
Mismatched or missing Java paths can prevent the help system's JVM from starting. Variable: FORMS_BUILDER_CLASSPATH In the world of Oracle Forms, FRM-18105: Failed
Action: Ensure this variable is set in your System Environment Variables and matches the value in your Windows Registry under HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_.
Java Path: Ensure a supported Java version (like JDK 8u211+) is at the beginning of your system PATH. 4. Adjust Folder Permissions
If "Run as Administrator" fixes the issue but you want a permanent fix for standard users:
Action: Grant Read & Execute permissions to the specific user for the ORACLE_HOME folder and all subfolders.
Navigation: Right-click the Oracle Home folder → Properties → Security → Edit → Add the user and check "Read & execute". 5. Final Resort: Recreate the Domain
If the help system still fails and you are using a full WebLogic installation, the initial configuration may have failed to write registry entries.
Action: Recreate the WebLogic domain, ensuring that Node Manager, Admin Server, and WLS_FORMS are all started as an elevated Windows user for the very first time.
FRM-18105: Failed to start the Help System. Form Builder 12.
FRM-18105: Failed to start the Help System error in Oracle Forms Builder (commonly 12c)
occurs when the builder cannot locate or execute the necessary help files or the browser required to display them
. This is frequently due to installation issues, missing Java paths, or improper environment variables. Oracle Forums
Here are the most effective solutions based on Oracle forums and community troubleshooting: 1. Fix Environment Variables (FORMS_BUILDER_CLASSPATH) The most common cause is that the debugger.jar or help system jar files are not properly referenced. Add or update the FORMS_BUILDER_CLASSPATH in your system environment variables. It should point to the debugger.jar files in your Oracle Home (e.g., C:\Oracle\Middleware\Oracle_Home\forms\java\debugger.jar Stack Overflow 2. Verify Oracle Home Path Order
Ensure that your current Oracle Form Builder home is the first entry in your Windows system system variable and make sure the new 12c folder (e.g., C:\Oracle\Middleware\Oracle_Home\bin ) comes before any old Oracle or 32-bit Java references. Oracle Forums 3. Ensure Proper Installation Rights
If the installation was not done with sufficient privileges, files may be missing or locked. Perform a clean re-installation. Delete the entire tree in the registry, delete the existing ORACLE_HOME folder, and reinstall using "Run as Administrator" Oracle Forums 4. Correct Java Version
Forms Builder 12c requires a specific version of Java (usually 32-bit for the builder, even on 64-bit Windows) to run correctly.
Verify that you are using 32-bit Java 8 for the builder, even if your WebLogic server uses 64-bit. Oracle Forums 5. Alternative Solution: Use a Supported Browser
Sometimes, the built-in help viewer fails due to outdated embedded browser components.
Open a support ticket to verify the current browser compatibility. Older versions of Forms Builder often depend on Internet Explorer components that may no longer function. Oracle Forums Summary of Quick Checks Checkpoint FORMS_BUILDER_CLASSPATH debugger.jar of new installation is first in 32-bit Java is configured for Form Builder.
Remove old ORACLE entries (64-bit and 32-bit) before reinstalling. If this happens while attempting to debug, ensure your formsweb.cfg allow_debug=true debugger.jar is properly included in default.env
FRM-18105: Failed to start the Help System. Form Builder 12.
The Oracle Forms error FRM-18105: Failed to start the Help System
typically indicates a permissions issue or an incomplete environment configuration Quick Fixes Run as Administrator : Right-click the Forms Builder executable (or its shortcut) and select "Run as Administrator"
. This is the most common resolution for accessing the help system in newer versions of Windows. Set Web Browser Preferences
: Ensure a browser is correctly linked to the builder. Go to Edit > Preferences > General and verify the Web Browser Location
field contains the full path to your browser’s executable (e.g., C:\Program Files\Google\Chrome\Application\chrome.exe Advanced Troubleshooting
If the basic fixes don't work, the issue may be rooted in your installation or environment variables: Check Environment Variables : Verify that FORMS_BUILDER_CLASSPATH
is correctly defined in your system environment variables or the Windows registry. Elevated Configuration : For Forms 12c, ensure you ran the config_builder.cmd (or equivalent) in an elevated shell
(Run as Admin) during initial setup. Failure to do so can prevent the creation of necessary registry entries. Java Conflicts : Ensure your system
has the correct Java version (typically Java 8 for older Forms versions) at the beginning to avoid conflicts with other installed Java versions. if they are missing?
FRM-18105: Failed to start the Help System. Form Builder 12.
In the world of Oracle development, the error FRM-18105: Failed to start the Help System is often the final hurdle after a fresh installation or upgrade of Oracle Forms Builder. It typically surfaces when a developer attempts to access the internal help documentation (often via the F1 key), only to find that the Java-based help engine is unable to launch. Common Root Causes
The "story" behind this error usually involves a breakdown in how the Form Builder interacts with its Java environment or the Windows operating system:
Incomplete Installation Steps: Often, the post-installation configuration (like starting Node Manager or Admin Server as an elevated user) wasn't fully completed. Oracle Forms locates the help file using a registry key
Pathing and Classpath Issues: The environment variable FORMS_BUILDER_CLASSPATH is frequently missing or incorrectly set in the Windows Registry, preventing the builder from finding the necessary JAR files (like ohj.jar) to run the help system.
Permissions Constraints: On modern Windows systems, the Help System sometimes requires "Run as Administrator" privileges to access specific files or initialize the Java Virtual Machine (JVM) correctly.
Java Version Conflicts: Older Oracle installations on the same machine can "disturb" the call to the help system due to mismatched DLLs or conflicting Java versions. Standard Solutions
To resolve the error and get the help system back online, developers typically follow these steps:
Run as Administrator: Right-click the Oracle Forms Builder executable and select Run as Administrator to see if it's a simple permission block.
Verify Environment Variables: Ensure FORMS_BUILDER_CLASSPATH exists in your system variables and contains the correct paths to your Oracle home, specifically including the help-related JARs.
Check the Registry: Open the Registry Editor and navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_. Ensure that FORMS_BUILDER_CLASSPATH matches your actual file paths.
Re-register the Oracle Home: In some cases, bringing the Oracle 12c (or current version) path to the first position in the system PATH variable can resolve conflicts with older installations.
For more specific troubleshooting, check the Oracle Forums or official documentation for your version of Oracle Middleware.
The most common culprit is a missing or incorrect path in your configuration. FORMS_PATH:
Ensure the directory containing your help files is included in the FORMS_PATH variable in your default.env file (or the registry on Windows). ORACLE_HELP_PATH:
Some versions use this specific variable. Make sure it points to the folder where your help system resides. 2. Verify File Permissions
The OS user running the Forms services (or the local user, depending on your setup) must have
permissions for the help files and the directory they are stored in. 3. Validate the Filename Open your Form in Oracle Forms Builder and check the properties: Form Module property palette. Look at the Help Book Title or specific help-related properties.
Ensure the filename listed matches the actual file on the server (remember, Linux/Unix is case-sensitive). 4. Browser/Viewer Issues If your help system is web-based: Pop-up Blockers: Ensure the browser isn't silently killing the help window. Java Security:
If the help system uses a Java applet, ensure the URL is added to the "Exception Site List" in the Java Control Panel. 5. Test with a Absolute Path
As a quick diagnostic, try hardcoding the full absolute path to the help file in the Form properties. If it works, you know the issue is definitely with your environment variables or pathing logic. file or the specific Form properties?
FRM-18105 Failed to Start the Help System: A Comprehensive Guide to Resolution
Are you encountering the frustrating error message "FRM-18105 failed to start the help system" while working with Oracle Forms? This issue can be a significant hindrance to your productivity, especially if you're relying on the help system for guidance. In this blog post, we'll delve into the causes of this error, its implications, and most importantly, provide a step-by-step guide on how to resolve it.
Understanding the Error
The error message "FRM-18105 failed to start the help system" typically occurs when Oracle Forms is unable to launch the help system. This could be due to a variety of reasons ranging from configuration issues, missing files, to permissions problems. The help system in Oracle Forms is a crucial component that provides users with context-sensitive help, making it easier to understand and use the application.
Causes of FRM-18105 Error
Several factors can contribute to the occurrence of the FRM-18105 error:
Implications of the Error
The FRM-18105 error not only hampers your ability to access help but also impacts your overall productivity and user experience with Oracle Forms. For applications that heavily rely on the help system for user guidance, this error can lead to increased support requests and user frustration.
Resolving the FRM-18105 Error
To resolve the "FRM-18105 failed to start the help system" error, follow these steps:
If the path configuration isn't in the environment file, it might be missing from the Windows Registry.
In Oracle Forms Builder:
Create a simple form with one button. Set its Help File property to a known working .chm file. Run the form and press F1. If it works, your main form’s help configuration is the issue.
"If you see FRM-18105, first check whether the help file exists in the application's install folder. Right-click the .chm file, select Properties and click 'Unblock' if present. If that doesn't help, reinstall or repair the application, and ensure your antivirus or OS policies haven't blocked help files."
Add a temporary error handler
Check Oracle Forms version