Troubleshooting Job Processor

Before troubleshooting, see the Job Processor overview:

Job Processor Components

Job Processor has three main components.

Jobs

Tasks submitted to the job queue and completed by Job Processor; these are typically repetitive tasks like property updates or dwf creation.

Job Queue

The server-side utility that accepts jobs from Vault Clients and records job execution details.

Job Processor

The client side component that polls the job queue for tasks and executes them using the appropriate components.

Job Processor Process

  1. Once Job Processor is started, checks the job queue every 10 minutes (this is configurable).
  2. If there is an item in the queue, reserves the next queued jobs, taking priority into account.
  3. Downloads the files to the local computer.
  4. Opens the files, usually in a “headless” (no user interface) version of the associated product.
  5. If necessary, updates the file properties and saves the file as a new version.
  6. If a dwf update is needed, Job Processor creates the dwf and uploads to Vault, attaching the dwf to the source file; this does not create a new version.
  7. Moves to the next job.

Job Processor Frequently Asked Questions

Can I install the Job Processor on a server operating system?

Yes, the Job Processor has limited support on a server operating system.

The following Job types and components are supported on a server operating system.

TypeRequired Application
DWF creations of ipt, iam, idw, ipnInventor Server
DWF creations of dwgDWG TrueView
PDF creations of dwgDWG TrueView
PDF creations of idwInventor Server
Sync Properties of ipt, iam, idw, ipnInventor Server
Sync Properties of dwgDWG TrueView
DXF creations of idwInventor Server
DXF creation of dwgDWG TrueView
STEP creation of iptInventor Server
STEP creation of iamInventor Server
Note:

What are the system requirements for Job Processor?

See System requirements for Vault products.

Also check requirements for each application required to run jobs on the processor.

Can I install Job Processor on an end-user computer?

Yes, but Autodesk does not recommend this. Job Processor is a Vault Client installation option and can be installed and run on any computer. But as Job Processor runs it will open applications and use system resources. In the case of Inventor, it will create and use temporary project files. For this reason Autodesk recommends installing Job Processor on a dedicated computer.

Does Job processor use a license?

No, Job Processor doesn't require an Inventor license.

For example, if the Job Processor performs Inventor DWF Publishing (InventorDwfPublishCount), it will start Inventor and perform this type of job a set number of times before it closes Inventor and restarts it. This way it does not start and stop Inventor each time it performs one of these jobs.

See: Configure Job Processor Use Limits for CAD Services.

How often does a Job Processor look for jobs?

This is configurable, but by default Job Processor checks for jobs every ten minutes.

What sort of Jobs does Job Processor execute?

Job Processor is configured by default to create visualization files (DWF) and synchronize properties. It can be configured to update revision tables and sync files with a supported Autodesk cloud drive using Project Sync. It can also be extended to execute any number of custom tasks.

Job Processor is intended to run silently in the background. Under normal conditions, administrators should review the queue on a daily basis to look for specific failed tasks to be resubmitted, or for poorly performing processors.

See http://underthehood-autodesk.typepad.com/blog/2015/09/monitor-your-job-processor.html.

What software does Job Processor use?

Custom jobs may need additional applications. See the online help for complete job type requirements.

How do I rerun a failed job?

Jobs that have failed can be resubmitted through the job queue.

How do I automate Job Processor?

Job Processor can be set to start automatically as soon as your computer starts. This is done in the Job Processor Settings dialog box. Some administrators set up Job Processor so that it runs jobs at off-peak hours when there are additional licenses available. This is usually done using scheduled tasks and batch files.

Who should be logged into Job Processor?

The Windows user who has the credentials to run CAD applications on the computer.

A separate Vault user should be created where possible for running jobs with elevated file permissions, because the Job processor user may need to edit released or locked files to update properties.

Whose name appears on a new file version?

When Job Processor creates a new file version, the Vault user logged into Job Processor at the time is added as the creator.

With revision tables, you can choose to display the file details of the first released version rather than the most recent.

How long does the software take to process jobs?

This can vary greatly but individual jobs are usually completed in under a minute depending on computer resources, file size and job type; overall time depends on the number of jobs.

To optimize performance, CAD applications are restarted after a set number of jobs. This is configurable.

Will Job Processor migrate a file to the latest software version?

Yes, if you create a new version of the file, it will be migrated to the software version executing the job.

What happens if Job Processor does not have the right software?

The job type is disabled, and will not run on that computer. Jobs can be manually disabled or configured using the JobProcessor.exe.config file found at C:\Program Files\Autodesk\Vault XXXX\Explorer.

What happens if Job Processor does not have the right software version?

The job fails if the file cannot be opened (for example an Inventor 2017 file in Inventor 2016).

What Should I do if processing is slow?

If you are running a high volume of jobs and are experiencing reduced performance, try the following:

Troubleshooting Job Processor

Corrupt installation

From Windows Control Panel, repair or uninstall and reinstall the software.

Make sure proper licensing is configured

If the processing software requires a license, make sure that it can obtain one.

Unable to process a file type

Make sure you have the appropriate software for the file format you need to work with.

Install the latest service packs

Some errors can be fixed by installing the latest service packs for both the Processing Software and the Vault Client.

Job Processor does not respond

Restart Job Processor. If necessary, stop the process in Task Manager, or restart Windows. If a DWF publish is not working, try opening the same file on Job Processor, and export the DWF to the local disk manually. If problems persist, reinstall or repair the installation.

Software not registered with Windows

Log into the Job Processor computer, start the software, then close it. Check for any error message displayed and troubleshoot them by searching the internet for more information.

Insufficient user privileges

The user account used by Job Processor needs to have sufficient privileges to perform the action required of it. For example, if file properties need updating when a file is moved from “Work in Progress” to “Released,” the account must have the privileges needed to edit file properties. Check the lifecycle definitions for that category and the account being used by Job Processor.

Corrupt file errors

Job types not processed

Occasionally, Job Type parameters in Job Processor can be deselected; this might have happened if the processing software became unregistered from the operating system. To check, go to Job Processor > Administration > Job Types and see if the jobs you are expecting to be processed on that computer are selected.

Steps to take when jobs are not being processed or are receiving errors

Steps to troubleshoot Job Processor

View Job Processor Logs

If errors persist despite troubleshooting, refer to this information on error logging and potential fixes.

Access error details

Enable Verbose Logging

Locate the JobProcessor.exe.config file. For example, for Vault Professional 20xx, by default this is in C:\Program Files\Autodesk\Vault Professional 20xx\Explorer. This location will be different if you are using a different release of Vault client.

         <add key="LogLevel" value="0" />
        <add key="InventorUpdateRevBlockReleasePeriodInMinutes" value="10" />
        <add key="InventorDwfPublishReleasePeriodInMinutes" value="10" />
        <add key="TrueViewDwfPublishReleasePeriodInMinutes" value="10" />
    <add key="DataManagement.Common.Logging.ApplicationName" value="JobProcessor" />
    <add key="DataManagement.Common.Logging.Enabled" value="True" />
    <add key="DataManagement.Common.Logging.ServiceMachine" value="." />
    <add key="DataManagement.Common.Logging.LogFile" value="" />
    <add key="DataManagement.Common.Logging.SerializeProperties" value="False" />
    <add key="DataManagement.Common.Logging.Viewer.Path" value="H:\Common\Logging\LoggingBin\MessageViewer\DataManagement.Common.Messaging.Viewer.exe" />
    <add key="DataManagement.Common.Logging.Viewer.AcceptLocalMessageOnly" value="True" />
    <add key="DataManagement.Common.Logging.Viewer.Port" value="8080" />
    <add key="DataManagement.Common.Logging.Viewer.AutoLaunch" value="False" />

Once the value has been changed to 1, save the JobProcessor.exe.config file and then restart Job Processor.

When Job Processor processes a new job, information will be inserted in the JobProcessor.log file.

Also, more verbose information will be posted into JobProcessorJobActivity.log.

Review the new information in both new files.

Error Reference

"Unknown Error During Publish"

This can have a number of causes. When this happens with specific files, open the affected file manually and try to save to a new file and recreate the failed task (for example, create DWF).

Possible causes:

"Unable to retrieve File version for id xxxxxxx" or “An error occurred while attempting to retrieve a file.”

This happens when a job is created for a certain file, but the file is removed from Vault (for example, deleted) before the job could be executed.

"Index (zero-based) must be greater than or equal to zero and less than the size of the argument list."

This can be a result of the DWF attached to the file being updated being locked (for example, checked out or in use). To resolve, try the following:

"The new Job Processor service is not responding."

This error occurs if JobProcessor.exe or Connectivity.JobProcessor.Delegate.Host.exe stops responding. You will need to log into the computer and do one of the following:

"This file is only available from the following sites which are not accessible at this time:"

This can be caused by an interruption in network connectivity between the ADMS and AVFS servers.

This could also occur if the AVFS computer was restarted or suffered a power outage.

Resubmitting the Job once communication between ADMS and AVFS is restored should resolve the issue.

"File Locked;"

This Job Processor error can occur if a user tries to execute a task on a file, such as Synchronize Property, but the file is locked to the Job Processor user account.

"Sync properties not allowed on non-tip versions"

This error indicates that a new version of this file was created before the job could be completed. This can happen if a user changes the state on a file, for example from “work in progress” to “in review.” Administrators can ignore, delete, or filter out this type of error.

Lack of adequate permissions

There are a number of permission issues that can prevent access to edit a file (object- and state-based security). Recheck user access to specific CAD or visualization files, or log into Job Processor as a user with elevated privileges. Note that Job Processor cannot update locked visualization files.

Non-Unique Visualization files

If you have “enforce unique file names” enabled and there are existing duplicate visualization files in Vault, Job Processor will not be allowed to check in updated visualization files.

Login Failed

This can happen if Job Processor cannot access a Vault license (all licenses might be use). In this case users will need to make sure licenses are available and manually log in through the Job Processor client again.

"User is not of the correct Auth type"

The Job Processor does not have the correct permissions to execute a specific job.

"A visualization file cannot be generated for a non cad file”

This might occur when a virus scanner is running on the Job Processor computer. Test with the virus scanner disabled, and add Autodesk products to the exceptions list.

This can occur when checking in an IPT file linked to a DWG. It occurs when the process Connectivity.WindowsService.JobDispath.exe is started before the process Connectivity.JobProcessor.Delegate.Host.exe.

To resolve this, start Vault Client as the first process, update the file view with Job Processor, and add one or more jobs to the Job Queue. Start Job Processor.

"It looks like an error occurred during the file update. Please open DWG TrueView, Inventor, or Navisworks and try again."

This might occur while running the Job Processor using Task Scheduler to create a PDF and DWF for AutoCAD DWG.

To resolve this issue, perform the following steps:

  1. Close all related processes to jobprocessor (jobProcessor.exe, jobProcessor.delegate.host).
  2. End task in Task Scheduler.
  3. Go to Component Services > Computers > My Computer > DCOM Config > DWG TrueView Drawing Properties, and select the "The interactive user" option on the Identity tab.
  4. Remove previous jobs and create new in job queue.
  5. Restart computer.

Appendix

Batch file to start Job Processor from the command line:

See: Job Processor Command Line

REM start Job Processor
start JobProcessor.exe
REM prevents Job Processor from processing any more jobs on its queue after finishing its current job
JobProcessor.exe /pause
REM allows Job Processor to continue processing jobs on its queue from a paused state
JobProcessor.exe /resume
REM stops and exits Job Processor after finishing its current job
JobProcessor.exe /stop

You can also use command line arguments, in combination with a scheduled task and powershell, to restart JobProcessor.exe every few hours on the VM.

# === powershell.ps1 script ===
& "C:\Program Files\Autodesk\Vault Professional 2021\Explorer\JobProcessor.exe" /stop
Wait-Process JobProcessor
& "C:\Program Files\Autodesk\Vault Professional 2021\Explorer\JobProcessor.exe"
# === powershell.ps1 script ===

The /stop command will finish the current job then exit Job Processor (releasing Inventor's resources).

See this article on how to do this with Vault 2013 Professional: http://justonesandzeros.typepad.com/blog/2012/10/job-processor-command-line-tricks.html.

Job Processor configuration file time out settings

C:\Program Files\autodesk\autodesk vault xxxx\explorer\JobProcessor.exe.config

<add key="PeriodInMinutes" value="10" />
        <add key="WebServiceTimeout" value="1000000" />
            <add key="RequestSendTimeout" value="90" />
        <add key="RequestReceiveTimeout" value="90" />
        <add key="HostServiceSendTimeout" value="10" />
        <add key="HostServiceReceiveTimeout" value="90" />
        <add key="PingTimeout" value="30" />

Job Processor configuration application cycles

    <add key="UpdateRevBlockMigrateLatestINV" value="0" />
    <add key="InventorUpdateRevBlockCount" value="100" />
    <add key="InventorDwfPublishCount" value="100" />
    <add key="TrueViewDwfPublishCount" value="500" />
Parent page: Job Server Administration