Agent Requirements

Below are the Agent system requirements to configure a Copia Agent for the backup of CODESYS v3 projects:
  • A licensed copy of CODESYS v3 (v3.5.10 or later).
  • Any additional vendor software required for project backup from the devices must be licensed and installed on PC running the Copia Agent. (i.e. Add-on's etc.)
  • The Agent should be tested using the installed Beckhoff software, and proven able to backup the project without error.

Project Configuration

To configure a project for CODESYS, you will need to already have a repository created with the CODESYS .project file.
Click either of the Add a Project buttons in the Projects tab.
First, select the Repository which contains the Project file or directory.
Next, choose the Branch of the repository that the .project file resides in. Our example repository only has a single branch, so we will select the "master" (or main) branch.
Select the CODESYS .project file that is intended for backup. Click the Next button to continue.
Enter a Name and Description for the Project. The name would often be that same name as the Project for CODESYS.
After selecting the CODESYS Project type, additional fields will be displayed, as follows:
  • CODESYS Version ****This is the version of CODESYS used for the project.
  • CODESYS.exe File Path ****The CODESYS software path on the agent. It is recommended to install and use the default.
Click on the Create Project button to finish Project setup.
If this is not your first Project, and you have already created an Agent and Device, you can assign them to the project while creating it. You can always connect the Project to an Agent or Device at a later time.
You'll notice that any project you create will display a teal eyeball in the top right corner of the project card. This means that you are watching that project and therefore receiving notifications about its backup activity.
If you do not want to receive notifications for a given Project, simply click on the Watch button on the Project card to unwatch the Project.
You have added a Project to the Site. Our next step will be to add a Device and then link it to your Project.

Device Configuration

A CODESYS Device is the actual PLC that contains the Project data that will be backed up.
To create a new Device, select the Devices tab at the top of the interface and click on either of the Add a Device buttons.
Enter a Device Name in the second field for the device. This name must be unique.
In the third field, the Device Name in Project must match the Device name in the CODESYS project tree.
Enter a Description and select the CODESYS Project type. Username and Password fields will appear. In cases that the Device will require credentials to perform the operation, enter them in the fields provided.
When finished entering the information, press Create Device.
There is no communication path for CODESYS, as it will use the communication path stored in the project file.
Your new device will be displayed in the Device tab.

Linking to a Project

Now that you've created your Device, it's time to link it to your Project. Click the caret in the device card and choose Edit Device.
On the bottom left, select the Link Device to Project dropdown, and choose the Project that should be associated with this Device.
Click the Save Changes button to finish linking.