System designTroubleshooting

Multi-camera vision job lost after a software update: restore it

Why your multi-camera vision job ends up lost after a vision software update, and how to restore the full job from a backup or rebuild it in place.

LumaSpec Vision9 min read Share on LinkedIn

On this page 9 sections
  1. 01What a software update does to the job
  2. 02Likely causes, in order of probability
  3. 03Fix A: restore the backed-up job
  4. 04Fix B: rebuild the job and re-add the cameras
  5. 05Worked example: a four-camera line, one camera left after the update
  6. 06Prevention: the backup set that makes updates routine
  7. 07Checks before you run the next update
  8. 08When to move the job onto the camera
  9. 09Questions

The vision software update finished clean, the line restarted, and the job that opened holds one camera out of four. The cameras are fine and still on the network. What broke is the job: installers manage the directory your job files live in, and a fresh install starts a default job that contains the first camera it finds. This guide shows how to confirm that cause in a minute, restore the full multi-camera job from backup or rebuild it in place, and set up the backup that turns the next update into a non-event.

What a software update does to the job

Multi-camera vision software keeps each job as files in a jobs directory under the application's install folder, and loads the active job to the cameras when you switch into run mode. The installer owns that folder. When an upgrade or reinstall lays down a new application tree and does not find your job files in its own jobs directory, the application builds a default job containing a single camera. The other cameras stay reachable on the network; they are simply not members of the job that opened. Nothing on the cameras changed. The job's membership list did.

That symptom splits your diagnosis in two. Cameras absent from the job but reachable on the network point at the job itself, and the fixes below cover it. Cameras missing from the enumeration screen as well point at addresses or drivers, which change a camera IP address and update tools stuck on the default treats.

Two near-neighbours fail differently. A job that loads but loses settings at runtime is a storage and load-order problem, covered by camera configuration lost after job load: fix storage and load order. A job that drops after a robot fault is a handshake problem, and vision job lost after a robot fault: re-handshake at cycle start walks that path.

Likely causes, in order of probability

Rank Cause Test Fix
1 Installer wrote a fresh default job into its jobs directory The job's modified date matches the update; the camera list holds one entry Fix A below
2 The auto-load setting points at the default job Open your production job by name; it runs normally Fix A, then repoint auto-load
3 The update changed camera enumeration or addresses Ping each camera from the controller; check the enumeration list Re-address, then reload the job
4 No backup, and the uninstall removed the old install folder A disk search for the old install path finds no job files Fix B below

Work the tests top to bottom. The first two take under a minute together and cover the common case. Rank 3 announces itself: the cameras are absent everywhere, not just from the job. Rank 4 is the expensive one, and the prevention section below exists so you never meet it.

Fix A: restore the backed-up job

Restoring is a copy, a load and a verification. Expect minutes, not hours:

  1. Take the station out of run mode and close the vision application.
  2. Open the software's settings and read the job directory path, listed under the job or workspace directory. Write it down: this is the folder the running application actually reads.
  3. Go to your backup location and take the newest dated copy.
  4. Copy the backup job file into the current job directory. A file of the same name replaces the one already there, which is the intent.
  5. Copy any custom scripts or macros the software loads from the install area as well.
  6. Start the application, open the restored job and switch into run mode.
  7. Verify the restore: the camera list names every camera on the line, and a known-good part passes every tool.

Fix B: rebuild the job and re-add the cameras

No backup, and the old directory is gone? Rebuild. Calibration work dominates the effort: as a rule of thumb, count half a day for a four-camera station and under an hour for a single camera.

  1. Create a new, empty job.
  2. Add cameras from the enumeration screen, identifying each by serial or MAC address rather than by IP. Serials survive reinstalls; addresses do not.
  3. Rebuild or reload each camera's calibration. If a backup folder holds exported calibration files, load them instead of redoing the grid.
  4. Rebuild the inspection tools. Where the software exports tool or recipe settings, import them rather than re-entering values by hand.
  5. Save the job under its production name in the current job directory, then point the auto-load setting at it. The set your vision sensor to auto load its job on startup procedure shows the setting and the startup check.
  6. Save a dated backup outside the install folder immediately. The fresh rebuild is now the master copy.

Worked example: a four-camera line, one camera left after the update

The case is a typical controller-based line: four GigE cameras on one vision controller, updated last weekend. The inputs:

  • Cameras on the line: 4 GigE cameras, the count the production job listed before the update.
  • Cameras in the job that opened after the update: 1, the default job the installer created.
  • Controller: MV-VC3301H-128G66, which prints 5+ LAN ports and 4 built-in light channels.

The rule, in words: a restored job must list every camera on the line, and each GigE camera occupies one LAN port on the controller. Ports minus cameras is the margin left for the next camera or a service spare.

cameras to re-add = cameras on the line - cameras in the opened job spare camera ports = camera LAN ports on the controller - cameras on the line

The arithmetic: cameras to re-add = 4 - 1 = 3 cameras. Spare camera ports = at least 5 - 4 = 1 port, because the controller prints five or more LAN ports. The same line on a controller with 3-4 LAN ports computes 4 - 4 = 0 spare ports, and only at the top of that range.

The result: the four-camera job fits the 5+ port controller with a port in reserve. The four-port class fits it with none, so the next camera forces either a controller change or a downstream network switch, which brings its own wiring and failure points.

The decision: restore the whole backed-up job whenever the backup lists all 4 of 4 cameras, because one restore reloads every camera's settings and calibration in a single step. Re-add cameras individually only when the backup predates a camera added later - a backup listing 3 of 4 is restored first, then the fourth camera joins it. The threshold: the cameras missing from the backup are the only ones you rebuild by hand.

Controllers sized like this example - camera ports in reserve and built-in channels to drive the station's lights:

Vision controllersHikrobot MV-VC3301H-128G66 I3-8100, 8GB+128G SSD, No PoE, PCIe expansion supported, Incl. VM6200Pro licenseMV-VC3301H-128G66
LAN ports
5+ LAN ports
USB 3 ports
3-4 USB 3 ports
Light outputs
4 built-in channels
Memory
8 GB
$2,419.00View partBuild a system with it

Prevention: the backup set that makes updates routine

An update should never be able to cost you a job, and it cannot once the backup lives where the installer does not write. The set below takes ten minutes to maintain:

  • Copy the whole jobs directory plus any scripts or macros folder the software keeps in the install area into a dated folder outside the install root. Keep the last three.
  • Drop a five-line manifest into each backup: job file name, camera serials with addresses, auto-load target.
  • Prove each backup once by restoring it into a test job. A copy you have never restored is a hope, not a backup.
  • Stage the update on a spare controller first where one exists. The vision application runtime deployment to a target machine procedure covers staging to a target.
  • Export the on-device job before a smart camera firmware update, and file the export with the station backups.

For the fuller pre-failure routine, vision reader configuration backup before troubleshooting lists what to capture before any invasive work.

Checks before you run the next update

  • Backup dated today, outside the install path - the updater can rewrite the folders inside it.
  • Manifest with camera serials, addresses and job file name - they are the first items you re-verify.
  • Auto-load target recorded - an update can leave it pointing at a fresh default job.
  • A known-good part within reach - the closing proof of any restore is a part that passes.
  • Time booked with production - Fix A costs minutes; Fix B, with calibration, costs half a day.

When to move the job onto the camera

If this failure keeps costing you update days on a single-camera station, change where the job lives. A smart camera stores and runs its job on the device, so updating software on a PC or controller never touches it. The discipline transfers to the camera's firmware updates: export first, then update. The MV-SC3050XC-16M-ATN-H is a 5 MP color vision sensor with a global shutter that runs its inspection on the device.

Smart cameras & vision sensorsHikrobot MV-SC3050XC-16M-ATN-H 5 MP color vision sensorMV-SC3050XC-16M-ATN-H
Interface
Fast Ethernet
Resolution
5 MP
Sensor format
1/1.45"
Shutter
Global
$1,809.00View part

For multi-camera lines that stay on a controller, the answer is the runbook plus hardware margin: dated backups outside the install folder, auto-load on the production job, camera ports in reserve. Three controllers that span that need, from a compact model to a PoE model with more light channels:

Vision controllersHikrobot MV-VC2140-128G40-1T VC2100 Vision Controller, N97, 8GB+128G SSD+ 1THDDMV-VC2140-128G40-1T
LAN ports
3-4 LAN ports
USB 3 ports
2 USB 3 ports
$1,679.00View part
Vision controllersHikrobot MV-VC3301H-128G66 I3-8100, 8GB+128G SSD, No PoE, PCIe expansion supported, Incl. VM6200Pro licenseMV-VC3301H-128G66
LAN ports
5+ LAN ports
USB 3 ports
3-4 USB 3 ports
$2,419.00View part
Vision controllersHikrobot MV-VC5525-256G70-NN VC5000 Vision Controller, 12th-I5, 32GB+256G SSD, Supported PCIEMV-VC5525-256G70-NN
LAN ports
5+ LAN ports
USB 3 ports
3-4 USB 3 ports
$4,479.00 · quotedView and quote

Sizing a controller for a rebuilt line starts at the vision controllers category; single-camera jobs that fit on the camera start at smart cameras. The vision systems topic page gathers the rest of the startup, load and backup fixes. Bring your camera count and update schedule to the contact page and we will size ports, light channels and storage so the next update is a copy, a load and one good part.

Questions

Where does vision software keep its job files?

Almost always in a jobs folder under the application's install directory, because the installer creates and manages that folder. The exact path appears in the software's settings under the job or workspace directory. That placement is precisely why updates wipe jobs: an upgrade or uninstall can rewrite the folder your job files sit in, which is why the backup copy lives somewhere the installer never writes.

I updated without a backup - can the old job still be recovered?

Search the disk before rebuilding. If the update installed alongside the previous version, the old install folder may still hold the job files, and copying them into the new jobs directory is an ordinary restore. If the uninstall removed the folder, file-recovery passes sometimes retrieve job files, but treat any recovered file as suspect: rebuild if the recovered job fails validation on a known-good part.

Can I copy a job file from one controller to another?

Yes, when both machines run the same vision software version and carry the same camera set. Copy the job file into the jobs directory on the second controller, open it, and check the camera list before run mode. Version mismatch is the usual reason a copied job refuses to load or drops tools, so bring the second controller to the same software version first.

Do smart cameras suffer this failure mode?

Not from PC-side software. A smart camera stores and runs its job on the device itself, so reinstalling or updating software on a controller or PC never touches it. The risk moves to the camera's own firmware updates and factory resets, which can clear the on-device job. Export the camera job before its firmware updates and keep the export with the station's backups.