Versions Compared

Version Old Version 4 New Version Current
Changes made by

박준남 (Unlicensed)

정은진

Saved on

Key

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

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

  1. 삭제 메뉴를 선택합니다.
    Image Removed
    [그림] 복합응용 리소스 삭제 화면

상태

온라인

MonitorProcesses에 등록된 모든 프로세스들이 실행 중이고 MonitorProgram이 '0'을 반환하는 상태입니다.

오프라인

MonitorProcesses에 등록된 프로세스 중에서 하나라도 종료되었거나, 감시 프로그램이 '0'이 아닌 값을 반환할 때는 오프라인 상태로 판단합니다.

장애

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

속성

Image Removed

[그림] 복합 응용 속성 화면

속성

설명

데이터 타입

필수여부

MonitorProcesses

모니터링 해야 할 프로세스들의 목록입니다.
프로세스 이름은 실행 파일 이름이며 2개 이상일 경우에는 콤마(',')로 구분합니다.
MonitorProgram과 이 값 중에 하나는 반드시 입력되어야 합니다.
(예 : dfssvc.exe)

STRING

MonitorProgram 이 없을 경우 필수 혹은 두 속성 모두 입력 가능.

두 속성 모두 입력 시 모두 만족해야 함

MonitorProgram

모니터링을 위해 실행할 프로그램 혹은 배치 스크립트의 경로명을 입력합니다.
MonitorProcesses와 이 값 중에 하나는 반드시 입력되어야 합니다.

FILE

MonitorProcesses 없을 경우 필수 혹은 두 속성 모두 입력 가능.

두 속성 모두 입력 시 모두 만족해야 함

StartProgram

리소스를 시작할 때에 실행할 프로그램 혹은 배치 스크립트 경로를 입력합니다.

FILE

필수

StartupDirectory

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

FILE

 

StopProgram

리소스를 종료할 때에 실행 프로그램 혹은 배치 스크립트 경로입니다.

FILE

필수

User

응용프로그램을 사용할 수 있는 권한을 부여 받은 사용자 계정 이름입니다.
입력 값이 없으면 MCCS 서비스 실행 계정입니다.
(기본=root)

STRING

 

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

복합 응용 에이전트

일반적인 어플리케이션 항목을 관리합니다.

기본 응용보다 복잡하며 더 많은 확장성을 제공하여 애플리케이션 및 서비스 등을 관리합니다. 

기능

online 

StartProgram 속성에 등록된 스크립트를 실행합니다. 

StartProgram 속성은 배치 스크립트를 사용하여 기본 응용 리소스보다 유연하게 프로그램을 실행할 수 있습니다. StartProgram 속성 값을 입력하면 MCCS 엔진은 유효성 검사를 합니다. 이 검사는 지정된 경로에 스크립트가 존재하는지 만 확인합니다. 

잘못된 경로를 입력한 경우에는 MCCS가 에러 로그를 출력하고 리소스를 사용할 수 없게 합니다. 

offline 

StopProgram 속성에 등록된 스크립트를 실행합니다. 

monitor 

사용자가 정의한 감시 프로그램 혹은 스크립트를 실행하여 종료 값을 확인하여 판단하거나, 프로세스 목록을 확인하여 정상여부를 판단합니다. 

스크립트로 감시 할 경우에는 종료값이 0 일 경우 성공, 그 외의 경우에는 실패를 의미합니다.

프로세스 목록으로 감시할 경우 리스트에 등록한 모든 프로세스가 구동중일 경우 성공, 그렇지 않으면 실패를 의미합니다.

프로세스 목록과 스크립트를 모두 등록할 경우에는 2 가지 조건이 모두 성공해야만 성공을 의미하며 프로세스 목록이 없거나, 스크립트가 성공이 아니라면 실패로 간주하게 됩니다.

예를 들면 ORACLE을 위한 복합 응용 리소스를 만들었다면 데이터베이스의 특성상 지속적인 I/O가 보장 되어야 합니다. 먼저 ORACLE이 노드에서 정상적으로 동작을 해야 하고, 해당 데이터베이스의 인스턴스에서 I/O가 정상적으로 이루어져야 합니다.

우선 MonitorProcesses 속성에 ORACLE의 프로세스 이름을 등록합니다. 그러면 리소스는 주기적으로 서비스가 동작 중인지 감시합니다.

그리고 SQL 질의에 정상적으로 응답하는지 확인하기 위해 간단한 SQL query를 사용해서 스크립트를 작성하여 MonitorProgram에 등록합니다.

...

Section
Column

 

Column
width350px
Panel

이 페이지의 주요 내용

Table of Contents
maxLevel4

정의

복합 응용 리소스는 MCCS가 프로그램을 시작, 종료하고 그 상태를 감시할 수 있는 리소스입니다.

기본 응용 리소스와 비슷하지만, 일반적인 프로세스 실행뿐만 아니라 스크립트를 사용하여 보다 복잡한 처리와 조합이 가능합니다. 그리고 복합 응용 리소스는 시작, 종료, 모니터링을 위한 실행경로를 각각 지정해 줄 수 있습니다.

배치 스크립트를 사용하여 프로그램을 실행하는 이유는 서비스 응용프로그램처럼 시작하는 프로그램과 실행중인 프로세스 이름이 다른 경우라도 모두 처리가 가능하도록 하기 위해서 입니다.

때로는 실행중인 프로세스 목록에서 프로세스 존재를 감시(existence test)하는 것뿐만 아니라 프로세스가 제대로 서비스를 하고 있는지도 감시(response test)해야 합니다.

이러한 일을 유연하게 처리하기 위해서 배치 스크립트를 활용할 수 있으며 복합 응용 리소스에서는 스크립트를 입력할 수 있습니다.

 기본 응용과 마찬가지로 복합 응용에서도 기본적으로 root 계정으로 실행이 되지만 User 속성을 이용하여 특정 사용자계정으로도 실행이 가능합니다.

추가

그룹에서 추가 할 경우

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

    Image Removed
    [그림] 리소스 위자드 리소스추가 화면
  2. 리소스 위자드에서 복합응용 리소스를 선택하고 Next 버튼을 클릭합니다.
    Image Removed
    [그림] 리소스 위자드 선택화면
  3. 나머지 과정은 아래의 리소스 타입에서 추가 할 경우와 같습니다.
리소스 타입에서 추가 할 경우

...

모두 입력을 완료한 화면입니다.

Info

감시 프로그램과 감시대상 프로세스 목록이 모두 입력이 될 경우 감시 프로그램의 성공여부와 감시대상 프로세스 목록의 여부까지 모두 확인합니다.

...

삭제

The application resource is the resource where MCCS can start or terminate the program and monitor the status.
It is similar to the process resource. But, it can achieve more complex process and combination by using scripts beside general process execution.   In addition, the application resource can set the execution path for starting, terminating or monitoring.
We execute the programs by using the batch scripts because we can handle everything even if the name of start program is different from the name of running process as in the case of service applications.
Sometimes, in the list of running processes, we need to monitor (response test) whether the process is providing proper service as well as monitoring the existence of process (existence test). To process such tasks flexibly, we can use the batch scripts.
In the application resource, you can enter the scripts. Just like the process resource, the applications can basically run on the root account, but by using User attributes, you can run it on a specific user account.

Column
width350px
Panel

Table of Contents

Table of Contents
maxLevel4

Adding

Add the complex application resource to a group.

Adding in Group

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

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

  3. Enter the name of resource and the program for start, termination and monitoring, or the process lists for monitoring target.
    In the start, terminate or monitoring program, click the Image Added'File' button to select each script file
    or, click the Image Added'Edit' button to create a script file.

    Info
    1. If all of the monitoring programs and the process lists for monitoring target are entered, check whether the monitoring program is successful or whether there are process lists for monitoring target.
    2. 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] Add Complex Application Resource

     

  4. Click 'Finish' to see that the complex application resource is created as follows.
    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.

Application agent: It manages general application items.
It provides a more complex, wider expandability than processes to manage applications and services.

StatusAgent commandDescriptionNote

Online

All the processes registered in MonitorProcesses are running and MonitorProgram returns '0'.

Offline

Runs the script registered in the StopProgram attributes. 

 
Monitoring

Runs the scripts registered in the MonitorProgram attributes.
When the scripts are used for monitoring, the final value of 0 means success and other value means failures.
When you use the list of processes registered in the MonitorProcesses attributes for monitoring, then if all the processes registered in the list are running, it is success. If not, it is failures.
When both the process list and script are registered, meeting both the conditions means success, and if there is no process list or the script is not successful, it is regarded as a failure.

 

Offline

If any one of the processes registered in MonitorProcesses is terminated or the monitoring program returns a non-zero value, it is deemed as offline.

Online

Runs the script registered in the StartProgram attribute.
StartProgram attributes allow you to use the batch scripts to run the program in a more flexible way than the process resource.
If the wrong path is entered, MCCS will display an error log and the resource cannot be used.

 
Monitoring

Refer to the description of monitoring as above.

 

Trouble

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

Online

Refer to the above online command.

 
OfflineRuns the script registered in the StopProgram attributes. 

 

 

Attribute

Show the unique attribute of application resource.

Attribute

Description

Type

DefaultEditNote

MonitorProcesses

It is the list of processes to monitor.
The process name is the name of execution file. If more than one, use a comma (',') as a separator.
Either of this value and 'MonitorProgram' must be entered.

STRING

 O

 

If there is no MonitorProgram, you must enter the attribute.
You can enter the both attributes. If you do, the both of them should meet the requirements.

MonitorProgram

Enter the path for the program or batch script used to monitor status
Either of the value and the 'list of monitoring processes' should be entered.

FILE

 O

StartProgram

Enter the path for the batch script or program to run when starting the resource.

FILE

 O 

StartupDirectory

It is the working directory where the program starts. If there is no input, it means $MCCS_HOME.

DIRECTORY

(.)O 

StopProgram

It is the path for the batch script or program to run when terminating the resource.

FILE

 O 

User

It is a user account having the rights to use the program.
Can run the programs such as Clean, Monitor, Start or Stop.
 If there is no input, it uses the MCCS execution account.

STRING

rootO 

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