Installing a server with existing server archive and client¶

When installing a octoplant server with an existing server archive and client, the octoplant server and client 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.

If desired, an existing client archive can also be integrated.

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.

Requirements for the installation¶

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.
Execution of 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¶

Execute the Setup.exe file on the computer intended for the installation as administrator.
The installation wizard will then open.
Select a language. English and German are currently available.
On the welcome page of the installation wizard, select Next.
Select the option Install octoplant applications and then select Next.
Select the option I agree. and then select Next. If you do not agree to the license agreements, the installation will not continue.
Select the option Install server applications and select Next.
Select the option Server with existing server archive plus client and select Next.
Select the desired program extensions.

The BackupClient cannot be installed on the computer on which the octoplant server is running.

LibraryManagement

LibraryManagement is an application for version management of standard blocks and is currently available for Siemens S7, Siemens TIA Portal and RSLogix 5000.

LibraryManagement can be installed at a later date at any time.

Register file extension for SmartImport for supplier projects

This option allows you to send octoplant projects by email to suppliers and customers who do not use octoplant or do not have access to your octoplant server.

If the option is activated, an entry is written in the Windows registry that allows a octoplant delivery bill for suppliers (file type *.vdog-sdn) to be opened in the file manager. If the option is not activated, no registry entry is written and file types *.vdog-sdn can only be opened using the UserClient.

The registration of the file extension can also be made or undone in the UserClient. This is located in the Client settings dialog in the Extensions tab.

Register protocol extension to start octoplant via web link

If you have activated this option, you can start the UserClient using a web link in the browser. The web link has the format vdog:cid/{CID}, whereas {CID} is the component ID of the system.

You can also register or deregister the protocol extension in the UserClient. This is located in the Client settings dialog in the Extensions tab.
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 carried out during which the server archive may be damaged and data may be lost.
Enter the paths to the directory of the octoplant client applications and server applications.
You can enter the paths directly or select them using the Browse... button.

We recommend that you keep the paths and directories suggested in the installation wizard.
Examples:
- C:\Program Files\vdogClient
- C:\Program Files\vdogServer
Select Next.
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.
Select Next.
Enter the path to the existing server archive, a directory for the client setup files and the storage location of the client archive.
You can enter the path and directories 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
- D:\vdClientArchive
If the server archive is stored in a remote directory, the user or 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 correct. An existing client archive can also be integrated if required.
Select Next.

TCP port 64023 is required for octoplant. If you are updating from a versiondog version older than 9.5, will display a note will be displayed stating that this port must be enabled. Confirm the note by entering the required text.
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.
If necessary, give the other users of the computer access rights to the client archive. By default, the option Grant rights to "All Users" is activated.
If you want to make the octoplant client setup files available on the network, activate the Create the above network share option. The Create the above network share option is disabled by default.
The name of the network share is vdog client setup.

Info

By default, every user has read access to the directory and administrators have full access.
Select Next.
Specify the user account from which the octoplant services are to be started. You have the choice between the options Local system account and Username.

The account must have full access rights to the server archive directory. We recommend that you select the Username option and specify 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}\{user name}. Example: DATAMAN\TomT.
Select Next.
The dialog for entering the password for the superuser versiondog opens.

Info

The password change-it must not be used. 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.
Specify the options to start the program. You can select several options:
- Add entry to menu "All Programs"
- Create shortcuts on desktop
- Create shortcuts on Quick Launch Bar
Select Next. A summary of your entries appears.
Check the data displayed. If everything is correct, select Next.
The setup is executed. The completion of the installation process is indicated by a message.
If the Windows Firewall Service has not been started on the system on which you want to install octoplant, a note is displayed. To continue the installation process, select Continue.
After successful installation, select Finish to close the wizard.

Installing a server with existing server archive and client¶

Requirements for the installation¶

Procedure¶

Related topics¶