As a system admin, you can configure settings and leverage ARM functionality. The ARM tab appears in the tab list when you are in Home mode. It is not visible in the workspace in which it was installed, and it is only visible to system admins.
To work with ARM, select one of the subtabs. Clicking ARM Jobs takes you to the Job list screen, and clicking Configuration takes you to the ARM Configuration page.
Note: It is recommended that the maximum number of ARM jobs running in parallel must be less or equal to the number of enabled ARM Agents.
The Job list screen displays all workspace jobs with the following statuses:
- Not Started—the job has been created but not started.
- Paused—the job has been created and was started, then paused.
- Processing—the job has been created and is in the process of running.
- Errored—the job has been created and was started, then encountered an error.
The Job list screen includes the job’s name, type, priority, and status, as well as the name of the user who submitted the job and the job’s creation date. Click the name of any job to view more details for that job.
If a job has been created but not yet run, you can click the Edit link to edit the job from the Job list screen.
The content of the Job Details page varies with each type of job.
Archive Job Details page
The Archive Job Details page lists the details for the job based on the settings when the job was created and provides additional options, through the console at the right of the screen, based on the job’s status.
The Job Details pages display different content and options based on the status of each job.
For jobs that have not yet been run, you can run or cancel the job from the Job Actions section of the console at the right of the screen. Canceling the job stops the job if it is already running, and then removes the job from the job list whether or not it has started running.
When you click Run Job or Cancel Job, a confirmation dialog appears. Click OK to proceed with running or canceling the job.
For jobs that are currently running, a Progress Bar pane appears at the top of the screen. This pane identifies the stage that the job is currently in along with a visual display of the stages and percent completed.
The stage name displays above the progress bar at the bottom of the pane. The timer to the right of the progress bar indicates the amount of time since that particular stage was started. The Time Elapsed timer at the top right of the pane indicates the amount of time since the job was started.
Processing a Restore job
When running a Restore job, after the Procuro workspace upgrade has been complete the following warning message will display above the Progress Bar pane.
Note: ARM will also send an email notification with the same warning message if you are subscribed to receive them.
This warning message indicates that the archived workspace is available with limited accessibility while the job is still processing.
More job statuses and options
For currently running jobs, you have the option to Pause or Cancel the job from Job Actions section of the console at the right of the screen.
When a job is paused, it will continue to execute tasks and pause it after the stage is completed. Status of the job will change to Pause Requested.
When a job is canceled, it will continue to execute tasks until it reaches a safe spot to cancel. This provides a stable location to continue processing from if you retry the job.
When a job has finished running, a new Job Status pane appears at the top of the Job Details page. This pane displays the status, the Job Id, the Time Elapsed, and the name of the user who submitted the job.
When a job is finished, you can click Download Log on the console to display a report of the job.
If ARM detects Malware Files during Archive or Restore, the Download Malware File List button displays. You can click this button to generate a CSV file listing the malware files.
For Archive jobs, if any of the files in the job were missing, the Download Missing File List button displays. You can click this button to generate a CSV file listing the missing files.
When a job encounters an error, you can either retry or cancel the job. In the ARM tool, each stage is broken into a set of tasks. The tool makes note of the tasks that failed during the job so that you can resolve the error and retry the job.
- Beginning in ARM 10.3, the Recurring Jobs option will not be available for customers who do not have any recurring jobs already scheduled.
- Existing recurring jobs will execute normally at scheduled recurrence until ARM 18.104.22.16812 (1/4/2020 - 1/18/2020).
- Customers with scheduled recurring jobs will no longer be able to edit their recurring jobs.
To access the Job History screen, click the ARM tab, and then select ARM Jobs. Next, select Job History from the drop-down list.
The Job History screen shows all jobs that have been run from the ARM application. Click the name of a job to view the Job History page for that job.
Note: During the Archive or Restore job, if malware files are detected, a Job Warning message displays at the top of the page. Errors with specific files considered as malware can be found under the Errors tab. The Job Statistics table will display the files excluded from the archive or restore.
Job Status section—displays the following information for each job:
- Status—jobs can have the following statuses:
- Cancellation Complete
- Job Id—the identification number for the job.
- Time Elapsed—the total time the job took to complete.
Job Statistics section:
- For Archive jobs—displays the following information for each job in the Workspace Statistic, Archive Content, Skipped Files, and Malware Files columns:
- Document Repository Files — the number of repository files archived.
- Document Linked Files— the number of linked files archived.
- Non Document Repository Files— the number of non-repository files archived.
- Processing Files—for RelativityOne, you may see this field. This is the number of Processing files archived.
- Conceptual Analytics—the number of conceptual analytics files archived.
- Structured Analytics— the number of structured analytics files archived.
- dtSearch Indexes— the number of dtSearch indexes archived.
- Extracted Text Files—the number of Data Grid files archived.
- For Restore jobs—displays the following information for each job in the Archive Content, Workspace Repository, and Malware Files columns:
Document Files (Repository + Linked)—sum of restored Document repository and linked files.
- Processing Files—the sum of Processing files.
- Conceptual Analytics—the sum of Conceptual Analytics files.
- Structured Analytics— the sum of Structured Analytics files.
- dtSearch Indexes— the sum of dtSearch indexes.
- Extracted Text Files—the sum of Data Grid files.
Note: During an archive job, if ARM cannot find a file in File repository, the file will be reported as Skipped. During an archive and restore job, if Relativity detects a file as a potential malware file, ARM will report the file as Malware File.
Application Restored Options section—restore statuses include:
- Completed—application was successfully upgraded/installed
- Errored—application failed to install. You can manually repair it in Application Library and/or Workspace Upgrade
- Not Started—application is in archive, but it is core application which ARM doesn’t have to install
- Skipped—user chosen to skip application.
Additionally, the Job History page lists the details for the job based on the settings when the job was created. It also includes Record History and User Action History sections to provide information on users’ interaction with the job.
Using the console at the right of the page, you can view additional options based on the job’s status.
When a job has a status of Cancellation Complete, the Download Log button appears active; however, the log file is currently empty and does not display information on the steps taken in the job.
A successfully canceled job cannot be retried.
When a job has a status of Complete, the Download Log button appears active; however, the log file is currently empty and does not display information on the steps taken in the job.
When a job has a status of Errored, the Download Log button appears active. Click Download Log to download a text file log showing details about each step in the job.
When an Archive job encountered a missing file, you can download a missing file list in .CSV format from the Error and Status section of the console by clicking the Download Missing File List button.
For jobs with a status of Errored, the Stage column on the Job history page displays the stage the job was in when the error was encountered. With this information, you can attempt to resolve the error. Once the error is resolved, click Retry Job.