Running tasks from the command line

You can run tasks by using the Administration Services command-line interface runTasks operation. You can run a single task or multiple tasks that are based on the specified filter.

Procedure

  1. Open a command window and browse to JazzSM_HOME/admin/bin.
  2. Run the Administration Services command-line interface for your operating system with the -runTasks operation.
    Option Description
    On Windows systems
    • Run a single task that is based on the task identifier:
      adminservices.bat -runTasks task_ID

      Where the task_ID value is, for example, TCR-derby-logging-level-check.

    • Run one or many tasks that are based on the filter value:
      adminservices.bat -runTasks 
      -filter filter_value

      Where the filter_value value is, for example, identifier:derby.

    On Linux systems
    • Run a single task that is based on the task identifier:
      ./adminservices.sh -runTasks task_ID

      Where the task_ID value is, for example, TCR-derby-logging-level-check.

    • Run one or many tasks that are based on the filter value:
      ./adminservices.sh -runTasks 
      -filter filter_value

      Where the filter_value value is, for example, identifier:derby.

  3. When authentication is enabled for the Administration Services, you must specify a user name with appropriate privileges and the associated password.
    Note: This user must be mapped to either the PlatformConfigurator or PlatformAdministrator Administration Services roles.
  4. The Administration Services command-line interface prompts you to choose which task action to perform. Enter a value for the option.
    Option Description
    Perform a health check 1
    Perform an automation action 2
    Skip 3
    Skip all 4
    Note: Although Administration Services supports single sign-on (SSO), health check and automation administration tasks use command-line interfaces to run commands. The CLIs require credentials to be provided before the administration task can be completed; therefore, SSO is not supported for these administration tasks.

What to do next

You can view the details of the task, by using the -viewTaskDetails operation.