Skip to content

Installing a server with existing server archive

When installing a octoplant server with an existing server archive, the octoplant server applications are installed and an existing server archive is integrated. With this type of installation, existing server archive data can continue to be used. No new server archive needs to be created and no data is lost.

Warning

We recommend that the installation with an existing server archive is carried out with the same octoplant version that was used to create the server archive.

The client applications that are required for the configuration and administration of the octoplant server must be set up separately. For details on setting up the client applications, see Installing client applications.

Prerequisites

  • The octoplant setup file is accessible.
  • You have a valid license file.
  • The user performing the installation or the user account through which the installation is performed has administrative rights.
  • Executing files must be permitted on the drive that is intended as the storage location for the server archive. Any existing security policies that prevent the execution of files must be deactivated.

  • If the execution of files is not permitted, an error message (SQLException) is displayed later when logging into the system. A login is not possible.

  • It is recommended not to install the octoplant hub on a computer on which a octoplant server is already installed. If this has already been done, the postgres service octoplant hub PostgreSQL 14 must be stopped manually when installing/updating the octoplant server.

Procedure

  1. Execute the Setup.exe file on the computer intended for the installation as administrator.
  2. The installation wizard will then open.
  3. Select a language. English and German are currently available.
  4. On the welcome page of the installation wizard, select Next.
  5. Select the Install octoplant applications option and then select Next.
  6. On the license agreement page, select I agree to continue with the installation
  7. Select the Install server applications option and then select Next.
  8. Select the Server with existing server archive option and then select Next.
  9. In the next step, you will be asked to create a backup of your server archive or to confirm that you have already created a backup of the server archive. Data backup is required as a database migration is being performed, during which the server archive may be damaged and data may be lost.

  10. Enter the path to the directory for the program files of the octoplant server applications. You can enter paths directly or select them using the Browse... button.

    We recommend that you keep the paths suggested in the installation wizard.

    Example

    • C:\Program Files\vdogServer

    The field Path to the client applications is grayed out. 1. Select Next. 1. Specify where the existing server archive is stored:

    • Local: The server archive is stored in a local directory.
    • Remote: The server archive is stored in a remote directory.

  11. Select Next.

  12. Enter the paths to the existing server archive and the directory for the client setup files. You can enter paths directly or select them using the Browse... button.

    We recommend keeping the paths suggested in the installation wizard.

    Examples:

    • D:\vdServerArchive
    • D:\vdServerArchive\vdog client setup

    If the server archive is stored in a remote directory, the user or the user account from which the installation is carried out requires read and write access to the remote system. If no octoplant server archive exists at the specified address, an error message appears. The setup cannot be continued until all entries are specified correctly. 1. Select Next.

  13. TCP port 64023 is required for octoplant. If you update from an older versiondog version, a note will be displayed stating that this port must be enabled. Confirm the note by entering the required text.

  14. Windows XP Professional SP3, Windows Vista SP2 and Windows Server 2003 are no longer supported by octoplant. A note is displayed in the setup. This contains a link to a detailed list of the options available to you, if you are using older systems. Read the text carefully and confirm it if necessary, by entering "I understand" in the input field.

  15. If you want to make the octoplant client setup files available on the network, activate the option Create the above network share. The Create the above network share option is deactivated by default.
  16. Select Next.

  17. Specify the user account from which the octoplant services are to be started. You have the choice between the Local system account and Username options.

    The account must have full access rights to the server archive directory. We recommend selecting the Username option and specifying an account with administrative rights. The system account may not have the necessary rights. The domain must always be specified for a domain account. Format:{Domain}\{Username} (example: DATAMAN\TomT)

  18. Select Next.

  19. On the next page, enter the password for the versiondog superuser.

    Warning

    Don't use the password change-it. If the password change-it is set for the user versiondog when the server is started, a critical error is written to the Event log of octoplant. You must then change the password at the next login.

  20. Select Next.

  21. A summary of your entries is displayed.
  22. Check the data displayed. If everything is correct, select Next.
  23. The setup is executed. The completion of the installation process is indicated by a message.
  24. If the Windows Firewall service has not been started on the system on which you want to install octoplant, a note will be displayed. To continue the installation process, select Continue.
  25. After successful installation, select Finish to close the wizard.