The Recovery Manager is an additional service application that comes in handy when access to the i-net CoWork 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 i-net CoWork server was stopped.

The Recovery Manager is a boiled down version of the i-net CoWork 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.

The following procedures describe how to start the Recovery Manager depending on the platform the i-net CoWork server is installed on:

• Windows
  • Stop the i-net CoWork service using the Services application
  • Start the Recovery Manager using the Start Menu → i-net CoWork → Recovery
  • 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 Preferences → i-net CoWork
  • 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
  • Starting the Recovery Manager: depending on the product, there is a startRecovery.sh script in the installation directory /usr/share/i-net-<product> or in the Server subdirectory. This must be executed on the console with sh startRecovery.sh -client.ip <your-desktop-client>.
  • Open the given URL using the client with the ip <your-desktop-client>
  • Note: since the startRecovery.sh script wants to run the Recovery Manager with the product user, this must be executed with the root user

• Docker
  • To start the Recovery Manager, there is a specific guide that you should follow.