Skip to content

Installation

Follow this guide to complete the installation of the octoplant hub, including all required preparation and post-installation steps.

Prerequisites

To ensure a clean installation, check the following:

  • If a previous version of octoplant hub was installed, remove its installation directory. For example, C:\Program Files\AUVESY-MDT\octoplanthub.

  • If the config.yml file from the previous installation contains custom settings you want to preserve, copy it to another location before deleting the directory.

    Info

    These steps apply to new installations only, not updates.

Installing octoplant hub

  1. Download the octoplant.zip file from the myAMDT portal.
  2. Extract the contents of the ZIP file.
  3. Run octoplanthub.exe on a machine where no octoplant server is currently installed.
    The Setup Wizard starts automatically.
  4. To change the installation path:
    1. Select Options.
    2. Enter a new path.
    3. Select OK.
      We recommend using the default path unless otherwise required.
  5. Select Install.
    The installation begins with PostgreSQL, followed by octoplant hub.
  6. When prompted, select Next to continue.
  7. Read and accept the license agreement by selecting the checkbox, then select Next.
  8. Create a super administrator account. This user will manage other users in octoplant hub.
  9. Select Next, then select Install to begin the final installation step.
  10. When installation completes, select Finish, then select Close to exit the wizard.

Configuring trusted root certificates (if required)

If you're installing on a server where VDogHubUpload is used, install trusted root certificates to ensure
proper communication with Windows Update.

  1. Open Command Prompt as administrator on the server where VDogHubUpload runs. Change the directory to ..\Program Files (x86)\vdogServer.

  2. Run the following commands:

    • certutil -generateSSTFromWU roots.sst
    • certutil -addstore -f root roots.sst

    • del roots.sst

      Warning

      If the command fails with a timeout error, you'll see an output similar to the following:

      CertUtil:

      • generateSSTFromWU command FAILED: 0x80072ee2 (WinHttp: 12002 ERROR_WINHTTP_TIMEOUT)
      • CertUtil: The operation timed out

      This usually means the firewall is blocking access to Windows Update. Contact your IT department to allow outbound access to Windows Update.

Verifying installation

After installation, review the log files located in the logs folder within the installation directory:

  • backend.log
  • octoplanthub-config.log

These files provide detailed records of installation and configuration steps.

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.