Top
ETERNUS SF AdvancedCopy Manager V16.1 Operation Guide
FUJITSU Storage

11.3.1 Create Scheduler Task

Use the wizard to create Scheduler Tasks, and a new Scheduler Task can be registered to ETERNUS SF Manager. Schedule date and time can be specified per hour, per day, or per day of the week on a weekly basis, or on a month-end specified monthly basis.

To create a Scheduler Task, refer to "Create New Scheduler Task" in the ETERNUS SF Web Console Guide.

Note

  • The format of scripts to be registered must be filled in with the following requirements:

    • File name: ASCII

    • Encoding: ASCII, MS932 or Shift-JIS

    • Line breaks: CR+LF

  • When the return value of a script is 0 (zero), the script terminates normally, and when other than 0 (zero), it terminates abnormally.

  • Do not use the number 99999 and -2 as a return value of scripts.

  • If multiple Scheduler Tasks are created on the same host, they cannot be executed at the same time. Wait until the script of one Scheduler Task has been executed and execute the next one.

  • The number of Scheduler Tasks concurrently executable in the system is up to 10.

  • There is not a limit to the number of creatable Scheduler Tasks.

  • If the execution time of Scheduler Tasks is overlapped, the priority of execution is as follows:

    1. Give priority to the Scheduler Task executed immediately.

    2. Execute in order of Next start time.

    3. Execute in order of creating of Scheduler Tasks.

  • There is not a limit to the number of scripts that can be registered to one Scheduler Task.

  • If multiple scripts are registered to one Scheduler Task, a script that terminates abnormally and later scripts are not executed and the Scheduler Task terminates abnormally.
    Regardless of the execution result of the last script, to execute additional scripts, another Scheduler Task must be created.

  • If the total execution time of a script file with a Scheduler Task exceeds a time length of 10 minutes and 30 seconds, timeout occurs. If timeout occurs, the previous execution result of Scheduler Task become "Warning", and the result cannot be viewed on the Overview screen for Scheduler Tasks. The result can be viewed by the script execution log of agent. To view the script execution log, refer to "11.3.1.1 How to View Results in Log".

11.3.1.1 How to View Results in Log

The script execution log is output at the following location:

<AdvancedCopy Manager work directory>\var\trc\ESFscheduler_script.log.<n> (*)

*: n is a serial number.

If it is seen in the script execution log that the executed script terminates normally, the value of return code becomes 0 (zero), and the executed script terminates abnormally, the values of return code becomes other than 0 (zero). If the script was not executed due to an authentication error, Return Code is not displayed and the error content is displayed in Detail.
The following is an example of script execution log (script terminates normally):

yyyy/MM/dd HH:mm:ss,SSS INFO - [START]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat 
UserName : administrator
DomainName : sampleDomain

yyyy/MM/dd HH:mm:ss,SSS INFO - [END]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat
ReturnCode: 0
Statndard Out:
[0] execute_backup is successfully completed.
Statndard Error:

The example of the output of a script execution log for authentication error is shown below:

yyyy/MM/dd HH:mm:ss,SSS INFO - [START]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat
UserName : administrator
DomainName : sampleDomain
yyyy/MM/dd HH:mm:ss,SSS ERROR - [END]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat
Detail: Failed to authentication.

The example of the output of a script execution log in which Return Code is 1 is shown below:

yyyy/MM/dd HH:mm:ss,SSS INFO - [START]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat 
UserName : administrator
DomainName : sampleDomain
yyyy/MM/dd HH:mm:ss,SSS ERROR - [END]
TaskName : sampleTask
ScriptFile : C:\Win32app\AdvancedCopyManager\Wizard\bat\SampleDB_20140210130055.bat
ReturnCode: 1
Statndard Out:
Statndard Error:
[0] execute_backup failed.