Section | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
정의
기본 응용 에이전트는 사용자가 지정한 프로세스를 시작, 종료, 감시하는 에이전트입니다. 기본 응용이란 응용프로그램이 단일 프로세스를 이루는 것을 의미합니다.
실행 바이너리와 메모리에 상주하는 프로세스의 이름은 동일해야 합니다.
실행 바이너리 프로그램은 모든 노드 상에서 같은 경로에 설치되어야 하며, 미러 디스크나 공유 디스크와 같은 데이터 영역에 설치될 수 없습니다.
추가
그룹에서 추가 할 경우
그룹 - 마우스 우 클릭 - 리소스 추가를 선택합니다.
...
리소스 타입에서 추가 할 경우
...
삭제
리소스타입 - 마우스 우 클릭 - 리소스 삭제를 선택합니다.
삭제 메뉴를 선택합니다.
[그림] 기본응용 리소스 삭제 화면
상태
온라인
등록된 프로세스가 실행중인 상태입니다.
오프라인
등록된 프로세스가 종료된 상태입니다.
장애
온라인 상태인 프로세스가 에이전트의 종료 명령을 거치지 않고 오프라인 상태로 변경되었을 경우에 장애 상태로 정의합니다.
속성
[그림] 기본 응용 속성 화면
ArgList 인수 | 설명 | 데이터 타입 | 필수여부 |
Arguments | 프로그램 인수입니다. 여러 개의 인수는 하나 이상의 공백을 식별자로 사용해야 합니다. 하나의 인수 내에 공백이 들어갈 경우에는 인수를 큰 따옴표(" ")를 사용해야 합니다. 최대 80자 입니다. | STRING | |
Domain | 사용자 계정의 도메인을 지정합니다. 사용자 이름이 지정되지 않으면 무시됩니다. | STRING | |
ForcibleTermination | 이 값이 True 로 설정되면 프로세스를 강제로 종료 시킵니다. 이 값이 False로 설정되면 정상종료 시도를 합니다. 정상종료가 실행되지 않으면 오프라인타임아웃 값에 설정된 시간이 지난 후 강제로 종료 시킵니다. 사용자 응답을 기다리는 응용 프로그램은 무한히 대기할 수 있으므로 옵션 설정 시 고려하시기 바랍니다. (기본값=false) | BOOLEAN
| |
InteractiveWithDesktop | 데스크톱과 상호 작용을 허용합니다. (GUI를 보여주는지 숨기는지 결정) 백그라운드(background)로 실행하는지 포그라운드(foreground)로 실행하는지를 결정합니다. (기본값=false(background)) | BOOLEAN
| |
Password | 사용자 계정의 패스워드입니다. 사용자 계정이 지정되어 있지 않으면 무시됩니다. | PASSWORD | |
Path | 프로그램 실행 파일의 절대 경로명 입니다. 이 값이 유효하지 않으면 리소스를 사용할 수 없습니다. | FILE | 필수 |
StartupDirectory | 등록된 프로그램이 실행될 경로입니다. 입력값이 없으면 %MCCS_HOME 을 의미합니다. (기본= . ) | DIRECTORY | |
User | 프로그램을 사용할 수 있는 권한을 부여 받은 사용자 계정입니다. 입력 값이 없으면 MCCS 서비스 실행 계정입니다. (기본=SYSTEM) | STRING |
ArgList 인수들에 대한 속성값은 해당 리소스를 등록할 때에 입력된 값이며, '리소스 고유 속성'에서 값을 변경하거나 확인할 수 있습니다.
기본 응용 에이전트
일반적인 프로세스를 관리합니다.
기능
Online
기본 응용의 속성 중 Path에 지정된 프로그램을 실행합니다.
Argument 속성을 사용하여 추가 인수를 줄 수도 있습니다. Path 속성은 시스템 상에 존재하는 프로그램의 절대 경로입니다. 이 값이 유효하지 않으면 기본 응용 에이전트를 시작 할 수 없습니다.
예를 들면 'notepad.exe readme.txt' 라는 명령을 사용하는 프로그램을 기본 응용 에이전트로 구성한다면 다음과 같이 표현할 수 있습니다.
"Path": "c: \windows\system32\notepad.exe" "Arguments": "readme.txt"
Offline
실행중인 프로세스에 종료 신호(TerminateProcess)를 보내어 해당 프로세스를 종료합니다.
Monitor
프로세스가 메모리에서 현재 실행 중인지 주기적으로 감시합니다.
운영체제의 프로세스 테이블에 프로세스의 존재를 확인한 후 Path 속성에 등록된 경로 정보를 이용하여 리소스로 등록된 경로와의 일치여부를 확인합니다.
프로세스의 내부적인 동작 상태나 정상적인 응답 여부는 확인하지 않습니다.
...
Adding
Add the basic application resource to a group.
When add a resource from a group name, select a group → right click → 'Add Resource'. Or select Edit(E) from the main menu bar → select 'Add Resource'. Or select 'Add Resource' icon from the tool bar.
- Select 'Process' from Resource Type lists and click 'Next' button. When add a resource from the Process resource type name, this step will be skipped.
Enter the resource name and then the process name.
You can add a process to the dialogue by pressing the '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.
[Figure] Basic Application Resource Added- As an additional setting, you can select desktop option and forced to terminate option.
[Figure] Additional Settings of process resource view - 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.
Status | Agent command | Description | Note |
---|---|---|---|
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. | ||
Offline The registered process is terminated. | Online | In the attributes of process, run the program designated in the Path. For instance, if you configure the program that uses the 'notepad.exe readme.txt' command as a process agent, you can express it as follows. | |
Monitoring | It periodically monitors whether the process runs in the memory. | ||
Fault 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 process, run the program designated in the Path. For instance, if you configure the program that uses the 'notepad.exe readme.txt' command as a process agent, you can express it as follows. | |
Offline | Terminate an ongoing process by sending the termination signal (TerminateProcess) to it. |
Attribute
Show the unique attribute of basic application resource.
Attribute | Description | Type | Default | Edit | Note |
Arguments | It is the program argument. | STRING | O | longer than 80 characters. | |
Domain | It specifies the domain of user. It will be ignored if user name is not specified. | STRING | O | ||
ForcibleTermination | When this value is inserted as True, process is terminated forcibly. if this value is inserted as True, it will try normal termination. If termination did not executed, it will be terminated forcibly after the time set in offlinetimeout. Note that application has no limit in standby. | BOOLEAN
| false | O | |
InteractiveWithDesktop | It permits reciprocal action with desktop. (It determines whether GUI to appear or hide) It determines to execute by background or foreground. | BOOLEAN
| false | O | |
Password | It is the password defined by the user. | PASSWORD | O | ||
Path | It defines the path name of the program file. If this value is invalid, resource cannot be used. | O | |||
StartupDirectory | It is a work directory. it means %MCCS_HOME% if it does not have a input value. | DIRECTORY | (.) | O | |
User | It is the user name which has received the permission to use the application. | STRING | O |
Attribute value of ArgList arguments are the values that are added resources and the value can be changed or viewed through ’Specified Attribute’ list on the detailed information panel.