Skip to content

Managing the Reflection Gateway Services

Start and Stop the Reflection Gateway Administrator Service

The Reflection Gateway Administrator service starts by default when you restart Windows. You can also use the Windows Services console to start and stop this service.

To start or stop the Reflection Gateway Administrator service using the Windows Services Console

  • On the Gateway Administrator computer, open the Windows Services console.

  • Select the service called "Micro Focus Reflection Gateway Administrator" and click start, stop, or restart.

    Note

    After the service has started, Gateway Administrator is not immediately available. To confirm that service startup is complete, look for the message "Server Container started" in the Gateway Administrator server.log.

Start and Stop the Reflection Transfer Server

The Reflection Transfer Server is the application server for the Identity Manager and also communicates with the Reflection Gateway Administrator to authenticate Reflection Gateway users. This server starts by default when you restart Windows. You can also use the Windows Services console to start and stop this service:

To start or stop the Reflection Transfer Server service

  1. On the Reflection Gateway Proxy computer, open the Windows Services console.

  2. Select the service called "Micro Focus Reflection Transfer Server" and click start, stop, or restart.

    Note

    After the service has started, the Reflection Identity Manager might not be immediately accessible. If you cannot start the Identity Manager, wait a minute or two and try again

Start and Stop the Reflection Hub

The Reflection Hub service starts by default when you restart Windows. You can also use the Windows Services console to start and stop this service.

To start or stop the Reflection Hub service using the Windows Services Console

  1. On the Gateway Administrator computer, open the Windows Services console.

  2. Select the service called "Micro Focus Reflection Hub" and click start, stop, or restart.

Reset Server Authentication on a Reflection Hub

When you activate a Hub, Gateway Administrator and the Hub exchange certificates. These certificates are used for server authentication in subsequent connections. If you reconfigure your systems (for example connecting to a Hub from a different instance of Gateway Administrator, or changing from the default self-signed Gateway Administrator certificate to a CA-signed certificate), server authentication must be reconfigured.

The following symptoms may indicate that the Hub and Gateway Administrator authentication is failing.

  • A Job fails with an entry in the Gateway Administrator log that includes: "SSLException invoking https://:9188."

  • In the Gateway Administrator user interface, you see a message saying, "Failed to activate the hub." when you click Save and Activate in the New/Edit Hub page and you have confirmed that the server name and port are correct.

To resolve this problem, you can reset the Hub.

To reset the certificate used by the Hub to authenticate the Gateway Administrator server

  1. As an administrator of the computer running the Reflection Hub service, navigate to Hub\bin in the Reflection Gateway installation folder. The default location is:

    C:\Program Files\Micro Focus\ReflectionGateway\Hub\bin

  2. Run the resetserver.bat file.

    You will see a prompt asking if you want to reset the Hub to its initial state.

  3. Press Y.

    The script stops the service, removes the saved Gateway Administrator server certificate, then restarts the service.

  4. Log on to Gateway Administrator using an account that has the System setup role enabled.

  5. Go to System > Hubs, select the Hub you reset, and click Edit. On the Edit Hub page, click Save and Activate.

Start and Stop the Reflection Secure Shell Proxy

The Reflection Secure Shell Proxy starts by default when you restart Windows. You can also use either of the following methods to start and stop this server.

To use the Reflection Secure Shell Proxy console

  • Start the Reflection Secure Shell Proxy console. It is installed in the Windows Start menu (or Apps list) under Micro Focus Reflection for Secure IT Gateway > Reflection Secure Shell Proxy.

  • Use the Action menu items or the toolbar buttons to start and stop the server.

To use the Windows Services console

  1. On the Reflection Gateway Proxy computer, open the Windows Services console.

  2. Select the service called "Micro Focus Reflection Secure Shell Proxy" and click start, stop, or restart.

Reset Gateway Administrator to All Defaults

Gateway Administrator installs a reset batch file that resets the Gateway Administrator to the original shipping state. If you are using the default HyperSQL database, running this batch file has the following effects:

  • Deletes all users and groups you have added to the ReflectionGateway user list. The default "admin" account, Administrators group, and File Transfer Administrators group will be recreated when you restart the server.

  • Deletes all Transfer Sites and Jobs.

  • Deletes all Post Transfer Actions.

  • Restores all System settings to the original defaults.

  • Deletes any queued actions and emails.

If you have changed the database, this script does not affect your Gateway Administrator data. It's only affect in this case is to delete queued actions and emails.

Caution

If you are using the default HyperSQL database, resetting the Gateway Administrator removes all saved users, Transfer Sites, and system settings. Use this option only to clear the data during initial testing, or if you cannot access the server with any available credentials and understand that all existing data and customizations will be lost.

To reset the Gateway Administrator to factory defaults

  • On the Gateway Administrator computer, open a command window running as an Administrator.

  • As an administrator of the computer running the Reflection Gateway service, navigate to GatewayAdministrator\bin in the Reflection Gateway installation folder. The default location is:

    C:\Program Files\Micro Focus\ReflectionGateway\GatewayAdministrator\bin

  • Run the resetserver.bat file.

    You will see a prompt asking if you want to reset the Gateway Administrator to its initial state.

  • Press Y.

    Without any further confirmation, the script stops the service, removes all saved user data and system settings, then restarts the service.

  • Wait until the server.log shows the message "Server container started," then connect to the Gateway Administrator and log in using "admin" and "secret".