리눅스 시스템 관리 프로그램(LSMP) 4편: LSMP 개발자 메뉴얼

tar xvfpz lsmp-1.0.0.tar.gz

cd lsmp-1.0.0

./configure --prefix=/usr/local/lsmp

make

make install

# LSMP Configuration file

[general]

insdir=/usr/local/lsmp

[lsmpd]

port=9694 # LSMP 웹인터페이스 포트

pwfile=pwfile # LSMP 웹인터페이스 비밀번호 저장 파일

daemon=True

logfile=lsmp_web.log # LSMP 웹로그 저장 파일

[bind]

bind_conf=/etc/named.conf # 네임서버 설정파일 경로

bind_named_dir=/var/named/chroot/var/named # 네임서버 zone 파일 위치

bind_nsDomain=ns.your-domain.com # 네임서버 도메인

[mysql]

mysql_root_pw=MySQLRootPasswd # MySQL root 패스워드

[httpd]

http_vhost_conf=/usr/local/apache/conf/extra/httpd-vhosts.conf

# Apache 가상호스트 설정파일

[status]

eth_dev=eth0 # 트래픽 모니터링 할 장치명

모듈 이름

lsmp_mod_user

요구사항 번호

1.1.1

요구사항 이름

리눅스 시스템 사용자 관리

함수명

get()

파라미터

full, user

1. 현재 설정된 사용자를 반환한다.

2. 파라미터

- full : 설정된 모든 사용자를 반환. False면 uid 500이상, nfsnobody 제외 한 사용자 리스트

- user : 특정 사용자의 정보를 반환 한다. 값이 없으면 모든 사용자의 정보를 반환한다. user 에 값이 있으면 full의 값은 영향을 미치지 않는다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<user>

<id> </id>

<uid> </uid>

<gid> </gid>

<comment> </comment>

<home_dir> </home_dir>

<shell> </shell>

<locked>True|False</locked>

</user>

..........

</result>

함수명

add()

파라미터

user, comment, pw, shell

1. 새로운 사용자를 추가한다.

2. 파라미터

- user : 사용자 ID

- comment : 사용자에 대한 설명

- pw : 비밀번호

- shell : 사용할 쉘 예) bash, /dev/null

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.) , XML형식의 문자열

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

user, del_home

1. 사용자를 제거한다.

2. 파라미터

- user : 사용자 ID

- del_home : True면 삭제, False면 삭제하지 않음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

user, comment, pw, home_dir, shell, lock

1. 사용자의 정보를 변경한다.

2. 파라미터

- user : 사용자 ID

- comment : 사용자에 대한 설명

- pw : 비밀번호

- home_dir : 계정의 홈 디렉토리

- shell : 사용할 쉘 예) bash, /dev/null

- lock : 사용자 계정 잠금 ( True : lock, False: unlock)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

get_shells()

파라미터

없음

1. 할당 가능한 쉘을 반환한다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<shell> </shell>

........

</result>

모듈 이름

lsmp_mod_iuser

요구사항 번호

1.1.2

요구사항 이름

리눅스 통합 사용자 관리

함수명

get()

파라미터

user

1. 현재 설정된 통합 사용자를 반환한다.

2. 파라미터

- user : 특정 사용자의 정보를 반환 한다. 값이 없으면 모든 사용자의 정보를 반환한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<user>

<id> </id>

<comment> </comment>

<home_dir> </home_dir>

<locked>True|False</locked>

<domain> </domain>

<db_user> </db_user>

<db_name> </db_name>

<self_dns> </self_dns>

</user>

..........

</result>

함수명

add()

파라미터

user, comment, pw, domain, db_user, db_pw

db_name, dns_set

1. 새로운 통합 사용자를 추가한다. 통합 사용자 리스트를 별도 파일에 저장한다. 비밀번호는 암호화 된 상태로 저장한다.

2. 파라미터

- user : 사용자 ID

- comment : 사용자에 대한 설명

- pw : 비밀번호

- domain : 도메인 (도메인 생성시 www, mail은 기본 생성하고, 모든 서브도메인(“*”) 설정)

- db_user : DB사용자명(기본 user와 같다)

- db_pw : DB비밀번호 (기본 pw와 같다)

- db_name : DB이름 (기본 user와 같다)

- dns_set : DNS서버 설정 유무 ( True : 설정, False: 설정하지 않음)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

user, del_data

1. 통합 사용자를 제거한다. 모든 설정(DNS, 웹, 사용자, DB, 메일) 제거

2. 파라미터

- user : 사용자 ID

- del_data : True면 삭제, False면 삭제하지 않음

(삭제 항목 : home디렉토리, DB데이터)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

user, comment, pw, domain, db_user, db_pw

db_name

1. 사용자의 정보를 변경한다.

2. 파라미터

- user : 사용자 ID

- comment : 사용자에 대한 설명

- pw : 비밀번호

- domain : 도메인

- db_user : DB사용자명(기본 user와 같다)

- db_pw : DB비밀번호 (기본 pw와 같다)

- db_name : DB이름 (기본 user와 같다)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

모듈 이름

lsmp_mod_bind

요구사항 번호

1.2.1

요구사항 이름

DNS서버 도메인 설정 관리

함수명

get()

파라미터

domain

1. 현재 설정된 도메인은 반환한다.

2. 파라미터

- domain : 특정 도메인의 정보를 반환 한다. 값이 없으면 모든 도메인의 정보를 반환한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<domain>

<name> </name>

<comment> </comment>

<ttl> </ttl>

<records>

<record>

<rec_name> </rec_name>

<type> </type>

<ip> </ip>

<line_no> </line_no>

</record>

............

</records>

</domain>

..........

</result>

함수명

add()

파라미터

domain, comment, ip, ttl, rec_name, rec_type, rec_ip

1. 새로운 도메인을 설정한다. 만약 동일한 도메인이 있으면 레코드를 추가한다.

2. 파라미터

- domain : 도메인

- comment : 설명

- ip : 아이피 주소

- ttl : TTL 값, 생략가능, 기본 43200 (12시간)

- rec_name : 레코드 이름 (서브 도메인), 생략가능

- rec_type : 레코드 타입 , 생략가능, 기본 A

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

domain, rec_line_no

1. 도메인 설정 제거, 레코드 삭제 한다.

2. 파라미터

- domain : 도메인

- rec_line_no : 레코드 라인 번호, 만약 레코드 라인 번호를 명시하지 않으면 도메인에 대한 모든 정보를 삭제한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

domain, comment, ttl, rec_name, rec_type, rec_ip, rec_line_no

1. 도메인 설정을 수정한다.

2. 파라미터

- domain : 도메인 (필수)

- comment : 사용자에 대한 설명, 생략가능

- ttl : TTL , 생략가능

- rec_name : 레코드 이름, 생략가능

- rec_type : 레코드 타입, 생략가능 기본 A

- rec_ip : 레코드 IP, 생략가능

- rec_line_no : 레코드 수정시 설정파일 라인 이름, 생략가능

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

bind_restart()

파라미터

없음

1. 도메인 네임서버(bind)를 재시작 한다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

모듈 이름

lsmp_mod_mysql

요구사항 번호

1.3.1

요구사항 이름

DB서버 관리 기능

함수명

get()

파라미터

db_user

1. 현재 설정된 DB사용자, DB명, DB용량을 반환한다.

2. 파라미터

- db_user : 특정 DB사용자의 정보를 반환 한다. 값이 없으면 모든 사용자의 정보를 반환한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<db_user>

<name> </name>

<comment> </comment>

<dbs>

<db>

<db_name> </db_name>

<db_size> </db_size>

</db>

............

</dbs>

</db_user>

..........

</result>

함수명

add()

파라미터

db_user, comment, db_user_pw, db_name

1. 새로운 DB사용자를 추가한다. 만약 동일한 사용자가 있으면, DB를 생성하고 권한을 준다.

2. 파라미터

- db_user : DB사용자

- comment : 설명

- db_user_pw : DB사용자 비밀번호

- db_name : DB이름

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

db_user, db_name

1. DB설정 및 DB제거

2. 파라미터

- db_user : DB사용자

- db_name : DB이름, 만약 DB이름이 명시되지 않으면 DB사용자를 제거하고, DB사용자 관련 DB를 모두 삭제한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

db_user, comment, db_user_pw

1. DB사용자의 코멘트 및 비밀번호를 수정한다. DB 사용자의 설명, 비밀번호를 변경하며, 둘 중 하나는 꼭 있어야 한다.

2. 파라미터

- db_user : DB사용자

- comment : 설명 (생략가능)

- db_user_pw : DB사용자 비밀번호 (생략가능)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mysql_flush_privileges()

파라미터

없음

1. MySQL서버의 DB사용자 권한 설정을 적용하기 위해 권한 테이블을 적용한다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

모듈 이름

lsmp_mod_apache_vhost

요구사항 번호

1.4.1

요구사항 이름

웹서버 가상호스트 관리

함수명

get()

파라미터

user_home_dir, domain

1. 현재 설정된 가상호스트 내역을 리턴한다. 파라미터가 입력되지 않으면, 가상호스트 설정 전체를 반환한다.

2. 파라미터

- user_home_dir : 사용자의 홈 디렉토리. (이 파라미터에 값이 있으면, 값과 관련된 DocumentRoot를 가진 가상호스트 설정을 리턴한다.)

- domain : 도메인 이름 ( 이 파라미터에 값이 있으면, 이 값과 관련된 ServerName, ServerAlias를 가진 가상호스트 설정을 리턴한다.)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<vhost>

<head></head>

<records>

<record>

<line_no> </line_no>

<direct> </direct>

<value> </value>

</record>

............

</records>

<tail></tail>

</vhost>

..........

</result>

함수명

add()

파라미터

domain, comment, documentroot, url

1. 새로운 가상호스트를 추가한다.

2. 파라미터

- domain : 도메인 ( 기본적으로 도메인은 ServerAlias로 설정하고, www.도메인을 ServerName으로 설정한다.)

- comment : 설명

- documentroot : 가상웹Root

- url : 이 값이 있으면, documentroot 값이 무시된다. 추가한 도메인으로 접속시 url으로 Redirect 하는 설정을 한다.)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

user_home_dir, domain

1. 가상호스트 설정을 삭제한다.

2. 파라미터

- user_home_dir : 사용자의 홈 디렉토리. (이 파라미터에 값이 있으면, 값과 관련된 DocumentRoot를 가진 가상호스트 설정을 삭제한다.)

- domain : 도메인 이름 ( 이 파라미터에 값이 있으면, 이 값과 관련된 ServerName, ServerAlias를 가진 가상호스트 설정을 삭제한다.

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

line_no, old_value, new_value

1. 도메인, 홈 디렉토리, 별명, Redirect URL을 변경한다.

2. 파라미터

- line_no : 설정파일의 설정 라인 번호

- old_value : 예전 값

- new_value : 새로운 설정 값

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

apache_restart()

파라미터

없음

1. Apache 웹서버를 재시작 한다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

모듈 이름

lsmp_mod_backup

요구사항 번호

1.5.1

요구사항 이름

백업관리 기능

함수명

get()

파라미터

없음

1. 현재 설정된 백업 설정들을 불러 온다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<backup>

<name> </name>

<comment> </comment>

<bk_files>

<file> </file>

..........

</bk_files>

<store_dir></store_dir>

<compress>True|False</compress>

<bk_day> </bk_day>

<bk_hour> </bk_hour>

<bk_minute> </bk_minute>

<bk_save_period> </bk_save_period>

</backup>

..........

</result>

함수명

add()

파라미터

name, comment, bk_files[], store_dir, compress,

bk_day, bk_hour, bk_minute, bk_save_period

1. 새로운 백업 설정을 추가한다.

2. 파라미터

- name : 백업 고유 이름 ( 차 후 변경 할 수 없음 )

- comment : 설명

- bk_files[] : 백업 디렉토리 리스트, 배열

- store_dir : 저장 경로

- compress : 압축 여부 (Treu, False)

- bk_day : 백업 날짜 (월 중 날짜) , cron 형식을 따름 ( * 매일, */2 : 2일에 한번)

- bk_hour : 백업 시 , cron 형식에 따름

- bk_minute : 백업 분

- bk_save_period : 백업 데이터 보관 기간

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

del()

파라미터

name

1. 백업 설정 삭제

2. 파라미터

- name : 백업 고유 이름 ( 차 후 변경 할 수 없음 )

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

mod()

파라미터

name, comment, bk_files[], store_dir, compress,

bk_day, bk_hour, bk_minute, bk_save_period

1. 백업 설정을 변경한다.

2. 파라미터

- name : 백업 고유 이름 ( 변경 불가 )

- comment : 설명

- bk_files[] : 백업 디렉토리 리스트, 배열

- store_dir : 저장 경로

- compress : 압축 여부 (Treu, False)

- bk_day : 백업 날짜 (월 중 날짜) , cron 형식을 따름 ( * 매일, */2 : 2일에 한번)

- bk_hour : 백업 시 , cron 형식에 따름

- bk_minute : 백업 분

- bk_save_period : 백업 데이터 보관 기간

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

옵 션

get_bked_list

파라미터

없음

1. 현재 백업대상 디렉토리에 보관된 백업 내용을 보여준다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<stored_datas>

<data>

<date> </date>

<size> </size>

<dir_name> </dir_name>

</data>

</stored_datas>

</result>

옵 션

del_bked()

파라미터

date, dir_name

1. 백업 저장데이터 삭제

2. 파라미터

- date : 백업된 날짜

- dir_name : 백업된 데이터 저장 경로

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

모듈 이름

lsmp_mod_status

요구사항 번호

1.6.1

요구사항 이름

시스템 현황 모니터링

함수명

get

파라미터

없음

1. 현재 시스템 현황을 리턴한다.

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<cpu> </cpu>

<loadavg> </loadavg>

<disks>

<disk>

<part_name> </part_name>

<total> </total>

<useage> </useage>

</disk>

.........

</disks>

<network>

<in> </in>

<out> </out>

</network>

</result>

모듈 이름

lsmp_mod_service

요구사항 번호

1.7.3

요구사항 이름

서비스 관리

함수명

get()

파라미터

없음

1. 현재 설정된 서비스 리스트를 불러 온다. ( /etc/xinet.d/, /etc/init.d/)

2. 파라미터

- 없음

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<services>

<service>

<name> </name>

<comment> </comment>

<status> </status>

</service>

..............

</services>

</result>

함수명

start()

파라미터

name

1. 정지된 서비스를 시작한다.

2. 파라미터

- name : 서비스 이름(고유 이름)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

함수명

stop()

파라미터

name

1. 실행 중인 서비스를 정지 시킨다.

2. 파라미터

- name : 서비스 이름(고유 이름)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>

함수명

restart()

파라미터

name

1. 실행 중인 서비스를 재 시작 한다.

2. 파라미터

- name : 서비스 이름(고유 이름)

3. 반환 형식 : 클래스의 인스턴트(본 문서는 XML형식으로 표현한다.)

<result>

<ok>True|False</ok>

<message> </message>

</result>