Installing the client applications

The standard installation includes the UserClient, AdminClient, EasyClient and ReportClient client applications. Optional with this installation are the BackupClient and the LibraryManagement. To install the optional client applications afterwards, uninstall the client applications first and then install them altogether using the setup file.

 

Previous to the installation

Installation requirements for mounted drives

We recommend that you do not install the client archive on a mounted drive. Should you have to, please be aware of the following:

 

Procedure

  1. Open the octoplant client setup directory and execute the program Setup.exe. Select the option execute as administrator by right clicking on the file.
  2. In Windows 10, the desktop shortcuts of the octoplant client applications are displayed for all users of a computer, if the program Setup.exe is started with the option execute as Administrator (provided that the shortcuts were created during installation- see step 11). If this option is not selected, the desktop shortcuts are displayed only for the user who ran the Setup.exe program.

  3. The installation wizard will then start. In the first dialog, select the language.
  4. On the welcome page of the setup wizard, no steps are required. Read the text and then click on Next.
  5. Then in Install octoplant applications, click on Next.
  6. Image: Installation wizard, Installation octoplant applications

  7. In the License Agreement dialog box, select I agree to proceed with the installation.
  8. Then select Install client applications and click on Next.
  9. Image: Installation wizard, Installing Clients

  10. In the next dialog box, select from the following options:
  11. Images: Installation wizard, selection of program extensions

    Options:

    BackupClient

    The BackupClient is used to make backups for automation devices that can only be accessed by the octoplant system.

    This option is available at no extra cost. If you now install BackupClient but never use it on this PC, this will have no negative effects. It is always possible to install the BackupClient at a later date.

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

    LibraryManagement

    The LibraryManagement is a version management tool for standard blocks and currently available for Siemens S7, Siemens TIA Portal and RSLogix 5000.

    A subsequent installation of LibraryManagement is possible at any time.

    Register file extension for SmartImport for supplier projects

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

    If the option has been checked, an entry will be written into the Windows Registry, which makes it possible to open a versiondog delivery bill for suppliers (file of the type *.vdog-sdn) in the file manager. If the option has not been enabled, no registry entry will be written and files of type *.vdog-sdn can be opened only through the UserClient.

    The registration of the file extension can also be done or undone in the UserClient, in the Client Settings dialog, located under the Extensions tab.

    Register protocol extension to start octoplant via web link

    If you have enabled this option, you will be able to start the UserClient from the browser via a weblink. The weblink has the format vdog:cid/<CID>, where <CID> is the component ID of the system.

    The registration of the protocol extension can also be done or undone in the UserClient, in the Client Settings dialog, located under the Extensions tab.

  12. In the next dialog, either accept the default path for the octoplant client applications directory or specify a path of your choice.

    If the path to the directory is being displayed in grey, it is not active.

    When entering another path, please pay attention to the following:
    • The applications cannot be installed in the root directory of a drive (there must therefore be at least one directory in the path).
    • You need to specify a target directory for the client applications (vdogClient by default).
    • The target directory may only contain the octoplant client applications.
    • Do not select the Desktop as the target directory (an exclusive use would not be possible here).
    • Do not select the file program files as the target directory (an exclusive use would not be possible here).
    To enable SmartUpdates to be carried out, the user will require write access to the installation file on the octoplant client application. From Windows 7 onwards, only administrators have write access to directories located under C:\program files\. To enable SmartUpdates to be carried out, ssign the user either write access to the file C:\Program files\vdogClient or select the installation path to which you want the user to have write access to (for example, C:\vdClientArchive\Client\).
  13. In the next dialog Path to local client archive, you must either accept the default path provided or specify a path of your choice. The client archive directory must be located on a local drive of your computer. We recommend a directory that can be accessed by all users working on that machine and that does not require administrator privileges.
    If you have installed BackupClient, the dialog Path to the local backup archive (of the BackupClient) will be enabled and you can now apply or adjust the path to the backup archive in the same way.

  14. In the next dialog, the option to grant the Windows user group All users access to the octoplant client archive is selected by default - otherwise deactivate this option.
  15. Image: Installation wizard, Set rights for client archive

  16. In the next dialog, you will need to decide which shortcuts you want to install for the octoplant client applications:
  17. Images: Installation wizard, Select shortcuts

  18. The storage location, that has been selected for program files and the client archive, will be displayed for you to check:
  19. Images: Installation wizard, summary

  20. Start the installation by clicking on Next.
  21. Once the client applications has been successfully installed, the dialog Installation successful! will be displayed. Click on Finish.

How do I change the directory in which the client archive is stored?

 

To change the directory of the client archive, proceed as follows:

  1. Close all octoplant applications.
  2. Copy the vdClientArchive to the desired directory (for example: E:\vdClientArchive)
  3. Change the target in the settings of all octoplant links.
    1. To do this, right-click on the octoplant shortcut.
    2. Select the menu item configuration.
    3. In the Shortcut tab, enter the desired location in the field Target , for example, D:\Programs\vdogClient\VDogClient.exe" /at:c "/rd:E:\vdClientArchive.
  4. Log on to a client application as usual. The new location for the client archive is now used.

 

To FAQ list

 

How do I ensure each user has a unique vdClientArchive in octoplant on a shared system?

Use environment variables, as follows:

  1. Install the octoplant client applications.
  2. No more than one client can work with any one client archive (in other words, each client needs a separate archive to which it has exclusive access).

    If you want users to work in parallel with a single client installation, each user needs a unique client archive.

  3. Customize the shortcuts of the octoplant client applications (UserClient, EasyClient, AdminClient, ReportClient):
    1. Right-click on the shortcut of the octoplant application.
    2. Click on Properties in the application window.

    3. In the Shortcut tab, adjust the directory, for example

      C:\Program Files (x86)\vdogClient\VDogClient.exe /at:C "/rd:%USERPROFILE%\vdClientArchive"

      For systems like Citrix, all otheroctoplant client application shortcuts on the terminal server also have to be changed. In order to do this, go to C:Users\Public\Public Desktop in the terminal server and customize all octoplant shortcuts.

 

To FAQ list

Is it possible to use octoplant on a terminal server? If so, how is it done?

 

Yes, it is possible to use octoplant on a terminal server.

In order to use octoplant on a terminal server, you will need to edit the desktop shortcuts for the client applications (UserClient, AdminClient, and ReportClient):

  1. Right-click on the octoplant client application shortcut.

  2. Click on Properties.

  3. On the tab Shortcut, set the path to the local archive in the field Target, e.g

    C:\program files\vdogClient\VDogClient.exe /at:c "/rd:%USERPROFILE%\vdClientArchive"

  4. Change the octoplant client application shortcuts on the terminal server to match. To do this, go to C:\Users\Public\Desktop on the terminal server and make the above changes to all the shortcuts.

 

To FAQ list

 

Related topics:
BackupClient
Library Management
UserClient -> Client settings
UserClient -> Working with suppliers