[HENNGE Connect] Server Replacement Procedure

Overview

This article explains the necessary procedures related to HENNGE Connect for customers who are replacing (relocating/upgrading the OS of) their web systems or HENNGE Connect agent servers.

Notes

1. The content of this article is based on the product specifications as of July 2026 and is subject to change without notice.

Table of Contents

1. Replacing the HENNGE Connect Agent Server
2. Replacing the Web System Server (with Web System URL change)
3. Replacing the Web System Server (without Web System URL change)

Procedure

Replacing the HENNGE Connect Agent Server

1. Confirm that the replacement server meets the system requirements.
   [HENNGE Connect] Checking System Requirements
2. Access the Access Control administration.
   [Access Control] How to Log in to the Administration
3. Obtain HENNGE-Connect.msi and install the agent on the new HENNGE Connect agent server.
   [HENNGE Connect] Installing the Agent on an On-Premises Server
4. Access each connected web service via HENNGE Connect and confirm that you can use them without any issues.
5. Stop the Windows service [ngrok] on the existing HENNGE Connect agent server.

6. Copy the [config.yml] used on the existing HENNGE Connect agent server to the new HENNGE Connect agent server.

   Destination:

   C:\Program Files\hennge-connect

   * Please overwrite the [config.yml] template generated during the HENNGE Connect agent installation.

7. Start the Windows service [ngrok] on the new HENNGE Connect agent server.
8. Access each connected web service via HENNGE Connect and confirm that you can use them without any issues.

Replacing the Web System Server (with Web System URL change)

1. Back up the [config.yml] file on the HENNGE Connect agent server.
   Example: config.yml_yyyymmdd

   Location:

   C:\Program Files\hennge-connect

2. Open [config.yml] with a text editor.
3. Replace the line containing the existing web system URL with the new web system URL and save the file.
   * This will be the line starting with [url:].
4. Restart the Windows service [ngrok] on the HENNGE Connect agent server.
5. Access each connected web service via HENNGE Connect and confirm that you can use them without any issues.

Replacing the Web System Server (without Web System URL change)

No action is required.