FANUC CNC: Creating jobs

The versiondog system offers you the ability to create jobs that check when the project on the device matches the latest checked-in version of the project as well as the ability to copy live data from a device onto the versiondog server.

A licensed installation of FANUC LADDER-III on the versiondog server or a versiondog agent is required.

FANUC CNC units have two different types of memory: SRAM and FROM. This results in some special features when working with versiondog .

How to configure jobs for FANUC CNC components:

  1. Start the AdminClient and open the Jobs module.
  2. In the Project tree, select your FANUC CNC component.
  3. In the menu tab, click on Create or drag & drop the components into the Jobs section.
  4. Check in the section Job configuration, if the upload type FANUC CNC is being displayed.
  5. Make sure the desired settings are in place for the following sections: General, Notification, Upload and compare, Create a version automatically after job run. The Notification and Create a version automatically after job run sections are only displayed if the necessary settings have been implemented. For more information on configuring the general sections, see Jobs in the tutorial AdminClient.
  6. Configure the section FANUC CNC stettings as follows:
    1. Select a Connection type.

      • For a HSSB connection, the computer from which the upload is to be performed will need to have a suitable interface card from FANUC and the appropriate drivers. A node ID must also be specified in the job configuration. The default value for the node ID is 0.
      • For an Ethernet connection, you must enter an IP address or the device name and the FOCAS port. The default port is 8193.
    2. To restore your FANUC CNC units with a backup, select the checkbox Copy disaster recovery data and then select from the drop down list how to copy the SRAM backups.

      1. Creating SCRAM Backup
        Select this option only if you know that the device is in emergency stop during job execution.
        This is the only option that creates a complete disaster recovery backup.
      2. Copy all SRAM backups from the F ROM
        Select this option only if you know that the device is running (i.e. NOT in emergency stop) during job execution.
        If it is not possible to create a valid SRAM backup due to the device type or firmware version, this is the only possible option.
      3. Try to create SRAM backup, copy SRAM backups from F-ROM if SRAM is blocked
        Select this option only if you want versiondog to apply option I (see above) on stopped devices and option II. on running devices.

      This is the preferred method for versiondog .

    3. Determine whether PMC data, CNC data and user data should also be copied during job execution.

    4. Save the job and execute it.

Similar to the recommended file structure in the project tree, we recommend manually creating three separate jobs, one for CNC data, one for PMC data and one for SRAM data for disaster recovery. For the job that backs up the SRAM backup, you should select Do not compare under upload and compare as the comparison strategy. For a list of files that can be backed up during job execution, see FANUC CNC: Upload and Compare:


Configuring a timeout

When uploading large amounts of data, a timeout may occur despite the default time being preset at 30 minutes. This timeout can be adjusted globally for all upload types or for each upload type separately. To adjust the maximum time for job execution according to the upload type, proceed as follows:

  1. Start the AdminClient and open the Jobs module.
  2. In the menu, click on Global job settings.
  3. The Upload specific configuration window will then open.
  4. Select the upload type in the navigation bar on the left.
  5. Select the Use specific timeout for this upload type checkbox.
  6. In the Maximum time for job execution field, enter the time period in minutes. The maximum possible value is 540 minutes.
  7. If you do not select the Use specific timeout for this upload type checkbox, the next time you change the global timeout, the value set here will be overwritten by the global one.

Alternatively, you can adjust the timeout via the INI file Classes.ini . (Go to the path in the server or agent archive:..\VD$A\Configuration\Upload\Classes.ini).

The value entered in the Upload type specific configuration window will then be copied into the INI file.

FAQ: Why do problems occur when backing up the program directory of FANUC robots?

When creating a job for backing up programs of a FANUC robot via FTP you need to be aware that the directory name \mc: has to be entered in the section FTP settings > text field Subdirectory.


The operating system (OS) of FANUC robots requires directory names to end with a : (colon). This rule is in contradiction to the notation of commands of the File Transfer Protocol (FTP). FTP commands can or must include one or more colons, but it is not permitted that they end with that character.

A FANUC robot or rather the data that is stored on its storage device have to be backed up via FTP (= upload type).

When creating a job to backup the FANUC robots via FTP using the AdminClient every robot is specified by its IP address or (computer) name. Either IP address or computer name has to be entered in the named text fields which are located in the section FTP settings. The text field Subdirectory can be found in this section too.

As long as no other directory is specified by a valid path entered into the text field Subdirectory, only the data located in the directory \md: will be backed up. The directory name \md: represents the hard disk of the robot where the operating system is stored.

If it is not the OS that you want to back up but the robot programs, these are stored in directory \mc:. Directory \mc: represents a flash disk that is incorporated into the file system when the robot’s OS is booted.

Directory \mc: can only be accessed or rather its content can only be displayed if the corresponding flash card is located in the appropriate slot.

If the flash card is not present and still an attempt is made to access data stored on it the following error message will be displayed:

Error while calling a FTP function [Name: IwcdFtpDLXComPtr::GetFile][Fehlertext: Requested action not taken. File unavailable (e.g., file not found, no access).][Details: /mc:/from00.img][40550]