Recovery Manager

The Recovery Manager is an additional service application that comes in handy when access to the INETAPP server is not possible due to misconfiguration. It should only ever be used when there is no means of authentication left for an administrative account or the server does not start anymore. The Recovery Manager can only be run when the INETAPP server was stopped.

The Recovery Manager is a boiled down version of the INETAPP server that only allows Configuration, Users and Groups manager and Maintenance tasks, working on the actual configuration of the server.

The Recovery Manager has to be started differently depending on the operating system of the server. In environments with a graphical interface it will display a dialog with the special URL of the Recovery Manager web interface.

The web interface does not require a password and has to be accessed from the same computer that started the Recovery Manager. For headless environments as well as Linux installations, the startup procedure requires a parameter to specify which other host computer or subnet has the permission to open the web interface. Headless environments are systems without a graphical interface, such as Docker Container environments.

Starting the Recovery Manager

The following procedures describe how to start the Recovery Manager depending on the platform the INETAPP server is installed on:

  • Windows
    • Stop the INETAPP service using the Services application
    • Start the Recovery Manager using the Start MenuINETAPPRecovery
    • or: navigate into the installation using the Explorer and start RecoveryConfiguration.exe
    • Note: the Recovery Manager has to be as administrative user
  • Mac OS
    • Start the Application System PreferencesINETAPP
    • Authenticate using the lock icon
    • Stop the server using the On/Off switch
    • Start the Recovery Manager using the specific link in the preferences interface
  • Linux
    • Stop the server using service <servicename> stop
    • Start the Recovery Manager using service <servicename> recovery -client-ip=<your-desktop-client>
    • Open the given URL using the client with the ip <your-desktop-client>
    • Note: depending on the init system you may need to use /etc/init.d/<servicename> instead of service