Versions Compared

Version Old Version 7 New Version Current
Changes made by

박준남 (Unlicensed)

정은진

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Section

 

Column

 

 
Column

Process agent is an agent that starts, terminates or monitors the process designated by a user.
Process means that an application achieves a single process.
The execution binary should have the same name as the process residing in the memory.
The execution binary program should be installed in the same directory on every node. It cannot be installed in the data areas such as mirror disks or shared disks.

 
Column
width350px
Panel

이 페이지의 주요 내용Table of Contents

Table of Contents
maxLevel4

 

 

정의

기본 응용 에이전트는 사용자가 지정한 프로세스를 시작, 종료, 감시하는 에이전트입니다. 기본 응용이란 응용프로그램이 단일 프로세스를 이루는 것을 의미합니다.

실행 바이너리와 메모리에 상주하는 프로세스의 이름은 동일해야 합니다.

실행 바이너리 프로그램은 모든 노드 상에서 같은 경로에 설치되어야 하며, 미러 디스크나 공유 디스크와 같은 데이터 영역에 설치될 수 없습니다.

추가

그룹에서 추가 할 경우

그룹 - 마우스 우 클릭 - 리소스 추가를 선택합니다.

...

리소스 타입에서 추가 할 경우

...

삭제

리소스타입 - 마우스 우 클릭 - 리소스 삭제를 선택합니다.

             삭제 메뉴를 선택합니다.

            Image Removed

            [그림] 기본응용 리소스 삭제 화면

 

상태

온라인

등록된 프로세스가 실행중인 상태입니다.

오프라인

등록된 프로세스가 종료된 상태입니다.

장애

온라인 상태인 프로세스가 에이전트의 종료 명령을 거치지 않고 오프라인 상태로 변경되었을 경우에 장애 상태로 정의합니다.

속성

Image Removed

[그림] 기본 응용 속성 화면

 

ArgList 인수

설명

데이터 타입

필수여부

Arguments

프로그램 인수입니다.

여러 개의 인수는 하나 이상의 공백을 식별자로 사용해야 합니다. 하나의 인수 내에 공백이 들어갈 경우에는 인수를 큰 따옴표(" ")를 사용해야 합니다.

모두 합쳐 80문자를 초과할 수 없습니다.

STRING

 

ForcibleTermination

이 값이 True 로 설정되면 프로세스를 강제로 종료 시킵니다.

이 값이 False로 설정되면 정상종료 시도를 합니다. 정상종료가 실행되지 않으면 오프라인타임아웃 값에 설정된 시간이 지난 후 강제로 종료 시킵니다.

사용자 응답을 기다리는 응용 프로그램은 무한히 대기할 수 있으므로 옵션 설정 시 고려하시기 바랍니다. (기본값=false)

BOOLEAN

 

 

Path

프로그램 실행 파일의 절대 경로명 입니다. 이 값이 유효하지 않으면 리소스를 사용할 수 없습니다.

FILE

필수

StartupDirectory

등록된 프로그램이 실행될 경로입니다. 입력값이 없으면 %MCCS_HOME 을 의미합니다. (기본= . )

FILE

 

User

프로그램을 사용할 수 있는 권한을 부여 받은 사용자 계정입니다.

입력 값이 없으면 MCCS 서비스 실행 계정입니다.

STRING

 

ArgList 인수들에 대한 속성값은 해당 리소스를 등록할 때에 입력된 값이며, '리소스 고유 속성'에서 값을 변경하거나 확인할 수 있습니다.

 

기본 응용 에이전트

일반적인 프로세스를 관리합니다.

기능

Online

기본 응용의 속성 중 Path에 지정된 프로그램을 실행합니다.

Argument 속성을 사용하여 추가 인수를 줄 수도 있습니다. Path 속성은 시스템 상에 존재하는 프로그램의 절대 경로입니다. 이 값이 유효하지 않으면 기본 응용 에이전트를 시작 할 수 없습니다.

예를 들면 gedit readme.txt' 라는 명령을 사용하는 프로그램을 기본 응용 에이전트로 구성한다면 다음과 같이 표현할 수 있습니다.

"Path": "/usr/bin/gedit" "Arguments": "readme.txt"

 

Offline

실행중인 프로세스에 종료 신호(TerminateProcess)를 보내어 해당 프로세스를 종료합니다.

 

Monitor

프로세스가 메모리에서 현재 실행 중인지 주기적으로 감시합니다. 

운영체제의 프로세스 테이블에 프로세스의 존재를 확인한 후 Path 속성에 등록된 경로 정보를 이용하여 리소스로 등록된 경로와의 일치여부를 확인합니다. 

프로세스의 내부적인 동작 상태나 정상적인 응답 여부는 확인하지 않습니다.

...

Adding

Add the basic application resource to a group.

  1. Select a group → right click → 'Add Resource'.


  2. Select 'Process' from Resource Type lists and click 'Next' button.

  3. Enter the resource name and then the process name.
    You can add a process to the dialogue by pressing the Image Added 'File' button on the right.

    Info

    The default user for running the basic app is the user that runs the MCCS process.
    If the process needs to run for another user other than the default user, then you must designate an execution account as follows. 

     

    Image Added 
    [Figure] Basic Application Resource Added

  4. As an additional setting, you can select forced to terminate option.
    Image Added 
    [Figure] Additional Settings of process resouce view

  5. Click the 'Finish' button to add the basic application resource.
    You can immediately check the result in the management web console.

Deleting

Select resource type → right click → delete resource.
The deleted resource will immediately disappear from the management web console.

 

Status

The following table explains the status switching of the MCCS resource caused by a user's command and the status.
The command assumes that it is generated by a user.

Process agent: Manages the general processes.

StatusAgent commandDesctriptionNote

Online

The registered process is running.

Offline

Terminate an ongoing process by sending the termination signal (TerminateProcess) to it.

 
Monitoring

 It periodically monitors whether the process runs in the memory.
For the monitoring purpose, the operational status is checked by using the process name that includes the absolute path and the process ID (PID).

 

Offline

The registered process is terminated.

Online

 In the attributes of basic application, run the program designated in the Path.
Path attribute is the absolute path for a program existing on the system.

 
Monitoring

 It periodically monitors whether the process runs in the memory.
For the monitoring purpose, the operational status is checked by using the process name that includes the absolute path and the process ID (PID).

 

Trouble

  

When the online process is switched to offline without using the agent termination command, it is defined as the trouble state.

Online

 In the attributes of basic application, run the program designated in the Path.
Path attribute is the absolute path for a program existing on the system.

 
OfflineTerminate an ongoing process by sending the termination signal (TerminateProcess) to it. 

 

 

Attribute

Show the unique attribute of process resource.

 

Attribute

Description

Type

DefaultEditNote

Arguments

It is a program argument.
Multiple arguments must use at least one space as an identifier.
If an argument has a space in it, you should wrap this argument with quotation marks(" ").

STRING

 Olonger than 80 characters

ForcibleTermination

If the value is set to true, the process is forced to terminate.
If the value is set to false, it will be terminated normally.
If it is not terminated properly, it will be forcefully terminated after passing the offline timeout.
An application waiting for a user's response can go into infinite standby, so please consider it when you set the option

BOOLEAN

 

falseO 

Path

It is the absolute path for the program execution file. If the value is not valid, you cannot use the resource.

FILE

 O 

StartupDirectory

It is the path for running the registered program. If there is no input, it means %MCCS_HOME. 

DIRECTORY

(.)O 

User

It is a user account having the rights to use the program.
If there is no input, it uses the MCCS service execution account.

STRING

 O 

The attribute value is entered to register the resource, and you can change or check it in the 'Specified Attribute'.