User Guide Cancel

Troubleshooting command-line preset output generation failure

Search
Robohelp

Robohelp

Open app
  1. RoboHelp User Guide
  2. What’s new
    1. What’s new in Adobe RoboHelp (2026 release)
    2. Adobe RoboHelp release notes (2026 release) 
    3. What’s new in Adobe RoboHelp (2022 release)   
  3. Introduction
    1. Get to know RoboHelp workspace
    2. RoboHelp System Requirements
    3. Download RoboHelp on Windows and macOS
    4. Download and install Adobe app
    5. RoboHelp FAQs
  4. Projects
    1. Plan your RoboHelp project
    2. Create a project
    3. Manage projects
    4. Work with topics and folders
    5. Generate reports
    6. Work with context-sensitive help
    7. Manage References
    8. Set preferences in RoboHelp
  5. Collaborate with authors
    1. Collaborate using Git
    2. Collaborate using SharePoint Online
    3. Collaborate using Azure DevOps (Team Foundation Server)
  6. PDF Layout
    1. PDF templates
    2. Design a page layout
    3. Publish PDF output
    4. Work with the common content styles
    5. Components of a PDF template
    6. Support for language variables
    7. Customize PDFs
  7. Editing and formatting
    1. Format your content
    2. Create and manage cross-references
    3. Create and manage links
    4. Single-source with snippets
    5. Work with images and multimedia
    6. Create and use variables for easy updates
    7. Work with Variable Sets
    8. Use Find and Replace
    9. Auto save your content
    10. Side-by-side editing in Split View
    11. Use the Spell Check feature
    12. Create and Edit Bookmarks
    13. Insert and update fields
    14. Switch between multiple views
    15. Autonumbering in CSS
  8. Import and linking
    1. Import Markdown files into a project
    2. Import Word documents into a project
    3. Import FrameMaker documents into a project
  9. TOCs, indexes, glossaries, and citations
    1. Create and manage a Table of Contents
    2. Create and manage an index
    3. Create and manage a glossary
    4. Create and manage citations
    5. Create and manage browse sequences
    6. Work with See Also and Related Topics
  10. Conditional content
    1. What is conditional content
    2. Create and apply condition tags
    3. Configure output presets for conditional content
    4. Optimize and manage conditional content
  11. Microcontent
    1. Microcontent
  12. Review and Collaboration
    1. Review and Collaboration
  13. Translation
    1. Translating content to multiple languages
    2. Configure a translation framework for a service provider
  14. Generating output
    1. Generate output
    2. Generate Frameless output
    3. Generate Knowledge Base output
    4. Generate PDF output
    5. Generate Responsive HTML5 output
    6. Generate Word Document output
    7. Generate Content Only output
    8. Generate eBook output
    9. Generate Microsoft HTML Help output
    10. Generate Mobile App output
  15. Publish output
    1. Publish to a RoboHelp Server
    2. Publish to an FTP server, a Secure FTP server, or a File System
    3. Publish to SharePoint Online
    4. Publish to Zendesk Help Center
    5. Publish to Salesforce Knowledge Base
    6. Publish to ServiceNow Knowledge Base
    7. Publish to Zoho Knowledge Base
    8. Publish to Adobe Experience Manager
    9. Publish to Atlassian Confluence Knowledge Base
  16. Appendix
    1. Adobe RoboHelp Scripting Reference
    2. RoboHelp keyboard shortcuts
    3. Introduction to Frameless skin editor
    4. Troubleshooting command-line preset output generation failure

Issue

When generating output using the command-line utility with multiple presets, you may encounter errors such as “rh-render-process-gone” or Java OOM errors, causing the process to hang. This can result in RoboHelp becoming stale or stuck, and the preset output generation failing. This behavior is expected and can be resolved by following the troubleshooting steps outlined in this article.

Why does the issue arise?

The command-line preset output generation failure happens majorly due to below reasons:

  • Insufficient system resources (such as CPU and memory), can trigger the “rh-render-process-gone” error, causing the process to become stale.
  • RoboHelp is built on the Electron framework, and this issue occurs due to changes introduced in Electron version 14 and later. Electron, which internally uses Chromium, enforces a hard memory limit for the main process; 8 GB on Windows and 16 GB on macOS. For large projects, this can lead to the process running Out of Memory (OOM), causing the issue when the user has a large project or is trying to generate multiple preset outputs parallel.
Note

Chromium implemented these limits to enhance performance and security, and there is no available workaround to disable or modify this setting. Earlier versions of Electron had no restriction on RAM consumption, so this issue didn't arise when generating multiple outputs via the command line.

How to troubleshoot the issue?

  1. Download the single_preset_output.zip file on your system. Extract the zip file.

  2. Navigate to the solution folder and locate the file named preset_output.bat. Open it using a text editor, for example Notepad.

  3. Set the following variables as listed below:

    • project file path as per the location where your .rhpj file is saved for the desired project. For example, set the project file path as: PROJECT_FILE="C:\sanitization-effort\Sanitized.rhpj".
    • value of variable OUTPUT_PRESET to your desired preset output. For example: "Frameless".
    • LOG_FILE path to your desired file system path.
    • OUTPUT_DIR to your desired output directory path on the system.

  4. Save the file, after successfully editing all the details.

  5. Open Command prompt as an administrator and navigate to the location where your preset_output.bat file is present. For example, if your file is present at location C:/Downloads/solution/preset_output.bat then run the following command in the terminal:

     cd "C:/Downloads/solution"

  6. Run the command: 

    .\main "preset_output.bat"

    Your preset outputs will be generated shortly in the OUTPUT_DIR path.

  7. If an existing RoboHelp process is running in the background, an error message “Another process is running” will appear (see image below). In this case, terminate the running RoboHelp processes and try again. Once resolved, the output will be generated successfully in the specified output folder.

    Note

    If you are using a custom script to generate multiple preset outputs and encounter failures, refer to the sample workaround provided in the multiple_preset_output.zip folder. Modify the contents of rh_workaround.bat and pdf_ap_1.bat within that folder to suit your requirements.

Adobe, Inc.

Get help faster and easier

New user?

Quick links

View all your plans Manage your plans
View quick links
Hide quick links

Legal Notices    |    Online Privacy Policy