Installing a new server with client¶

When installing a new octoplant server with client, the client applications are set up in addition to the octoplant server applications. octoplant server and client applications run on the same computer with this type of installation.

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. The same applies to the drive that is intended as the storage location for the client 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 New server with client (both on this computer) and select Next.
Enter the path to the octoplant license file and click on Next. You can enter the path directly or select it using the Browse... button.
Select the desired program extensions.

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

Options:

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.
Select Next.
Enter the paths to the client application and server application directories. You can enter the paths directly or select them using the Browse... button.

We recommend keeping the paths suggested in the installation wizard. Examples:
- C:\Program Files\vdogClient
- C:\Program Files\vdogServer
Select Next.
Select the storage location for the server archive. The following options are available:
- Local: The server archive is stored in a local directory.
- Remote: The server archive is stored in a remote directory.
Select Next.
Specify 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 the 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 you have selected the option Remote as the storage location for the server archive, the field Path to the project files on an external drive: is displayed. Enter the path to the remote directory in this field (format: \\System name\Share\Path).

For technical reasons, a path for the local server archive must also be entered if the Remote option is selected. The user or the user account from which the installation is carried out requires read and write permissions to the remote system.

Info

The server archive contains a range of data: versions, backups, metadata etc. Allow sufficient storage space for the server archive.
Select Next.
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.
Select Next.
If you want to make the octoplant client setup files available on the network, activate the option Create the above network share. This 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 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).
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.
If you want to install octoplant sample data, activate the option Install examples. The Install examples option is deactivated by default. The sample data is only for illustration purposes, the octoplant system is also fully functional without sample data.
Select Next.
A summary of your entries is displayed.
Check the displayed data. 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.