Skip to content

Installation

Prerequisites

If there was already an installation of the octoplant hub on the server, make sure that the installation directory of the old installation, e.g. C:\Program Files\AUVESY-MDT\octoplanthub, and in particular the file config.yml, is no longer present when performing a new installation (not an update). If you have made changes to the config.yml file that you wish to keep, copy it to another directory and delete the installation directory of the old installation.

Procedure

  1. Download the octoplant_hub.zip file from the AMDT download portal.
  2. Unzip the file and execute the octoplanthub.exe file on the computer on which no octoplant server is running.

  3. The octoplant hub Setup wizard is started.
    Figure: Installation wizard, start dialog

    If you wish to designate an Install location different to that of the default path provided, you can do so by selecting Options, entering the new path, and selecting OK. We do recommend, however, that you use the default path provided.

    Figure: Installation wizard, Setup options dialog

  4. Select the Install button.

  5. The PostgreSQL will begin installing.

    Figure: Installation wizard, PostgreSQL

  6. The octoplant hub will follow.

    Figure: Installation wizard, octoplant hub

  7. After then the octoplant hub Setup wizard will appear again. Select Next.

    Figure: octoplant hub Setup, Welcome dialog

  8. Read through the License agreement and select the checkbox, indicating that you accept the terms.

    Figure: octoplant hub Setup, license agreements

  9. Select Next.

  10. Create a super administrator for the octoplant hub. The administrator specified here can create new users for the octoplant hub.

    Figure: octoplant hub Setup, Create a super administrator

  11. Select Next.

  12. The octoplant hub is ready for installation. Select the Install button.

    Figure: octoplant hub Setup, Ready to install

  13. Once the installation is complete, select the Finish button.

    Figure: octoplant hub Setup, installation complete

  14. Select the Close button.

    Figure: Installation wizard, Installation Successfully Completed

Log files

In the installation directory you will find a logs subdirectory with the two files: backend.log and octoplanthub-config.log. Here, the steps performed during the installation are logged.

FAQ

FAQ

I've lost/forgotten the SuperAdmin password for the octoplant hub. What do I do?

If you have lost or forgotten the SuperAdmin password for the octoplant hub, you must uninstall, delete the installation directory, then re-install the octoplant hub.

  1. Back up the config.yml file to another directory if you wish to retain any settings.
  2. Uninstall the octoplant hub.

  3. Delete the directory C:\Program Files\AUVESY-MDT\octoplanthub. This step is necessary to reset the SuperAdmin password during reinstalling the octoplant hub.

  4. Reinstall the octoplant hub.

  5. Insert the entries from the backed-up config.yml file.

Make sure that the installation directory of the old installation is deleted before the new installation. An example would be to delete C:\Program Files\AUVESY-MDT\octoplanthub directory, and in particular the config.yml file. If you have made changes to the config.yml file and wish to retain them, copy it to another directory then delete the installation directory of the old installation.