설치 가이드 · 5 min read · Oct 12, 2025

Debian 10에 OCS 자산 관리 도구 설치하기

OCS는 “Open Computers and Software Inventory”의 약자로, 무료 및 오픈 소스 자산 관리 솔루션입니다. 이는 OCS 에이전트를 실행하는 원격 시스템의 하드웨어 및 소프트웨어 정보를 수집하는 클라이언트-서버 모델을 기반으로 합니다. OCS는 SNMP 프로토콜을 사용하여 프린터, 스캐너, 라우터 및 컴퓨터와 같은 네트워크 장치를 발견합니다. 웹 인터페이스를 통해 인벤토리를 시각화할 수 있는 간단하고 사용자 친화적인 인터페이스를 제공합니다. 자세한 정보를 수집하려면 클라이언트 머신에 OCS 클라이언트를 설치해야 합니다. OCS 클라이언트 에이전트는 Windows, Linux, Mac OS, IBM AIX, FreeBSD, Android 및 Sun Solaris를 포함한 여러 운영 체제에서 사용할 수 있습니다.

이 튜토리얼에서는 Debian 10 서버에 OCS 자산 관리 도구를 설치하는 방법을 보여줍니다.

전제 조건

  • 최소 2GB RAM이 있는 Debian 10 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

시작하기

시작하기 전에 시스템을 최신 버전으로 업데이트하는 것이 좋습니다. 다음 명령어로 시스템을 업데이트할 수 있습니다:

apt-get update -y  
apt-get upgrade -y

시스템을 업데이트한 후 변경 사항을 적용하기 위해 시스템을 재시작합니다.

다음으로, 시스템에 OCS에서 필요한 몇 가지 종속성을 설치해야 합니다. 다음 명령어로 설치할 수 있습니다:

apt-get install git curl make cmake gcc make build-essential -y

모든 패키지가 설치되면 다음 단계로 진행할 수 있습니다.

LAMP 서버 설치

먼저, 시스템에 Apache 웹 서버, MariaDB 데이터베이스 서버, PHP 및 기타 PHP 확장을 설치해야 합니다. 다음 명령어를 실행하여 모두 설치할 수 있습니다:

apt-get install apache2 mariadb-server php libapache-db-perl libapache2-mod-php php-soap php-curl php-json php-xml php-mbstring php-zip php-pclzip php-gd php-mysql -y

모든 패키지를 설치한 후, 시스템에 Perl 및 필요한 모듈을 설치해야 합니다.

다음 명령어로 Perl 및 모든 모듈을 설치합니다:

apt-get install perl libnet-ip-perl libxml-simple-perl libarchive-zip-perl libxml-simple-perl libcompress-zlib-perl libdbi-perl libapache-dbi-perl libapache2-mod-perl2 libapache2-mod-perl2-dev libdbd-mysql-perl libdbd-mysql-perl libnet-ip-perl libsoap-lite-perl libio-compress-perl -y

모든 패키지가 설치되면, 다음 명령어로 Perl 모듈을 활성화합니다:

perl -MCPAN -e 'install Apache2::SOAP'  
perl -MCPAN -e 'install XML::Entities'  
perl -MCPAN -e 'install Net::IP'  
perl -MCPAN -e 'install Apache::DBI'  
perl -MCPAN -e 'install Mojolicious'  
perl -MCPAN -e 'install Switch'  
perl -MCPAN -e 'install Plack::Handler'

작업이 완료되면 php.ini 파일을 편집하고, 시간대, 메모리 한도, 최대 파일 크기, 최대 실행 시간 등의 설정을 수정해야 합니다.

다음 명령어로 수행할 수 있습니다:

nano /etc/php/7.3/apache2/php.ini

다음 값을 변경합니다:

memory_limit = 256M
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = Asia/Kolkata

작업이 완료되면 파일을 저장하고 닫습니다. 그런 다음, 변경 사항을 적용하기 위해 Apache 서비스를 재시작합니다:

systemctl restart apache2

참고: 위의 PHP 값을 요구 사항에 따라 변경할 수 있습니다.

이 시점에서 LAMP 서버가 설치되었습니다. 이제 다음 단계로 진행할 수 있습니다.

MariaDB 데이터베이스 구성

기본적으로, Debian 10에서는 MariaDB 루트 비밀번호가 설정되어 있지 않습니다. 보안상의 이유로 비밀번호를 설정해야 합니다.

먼저, 다음 명령어로 MariaDB 셸에 로그인합니다:

mysql

로그인 후, 다음 명령어로 MariaDB 루트 사용자 비밀번호를 설정합니다:

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("yournewpassword");

다음으로, 다음 명령어로 OCS용 데이터베이스와 사용자를 생성합니다:

MariaDB [(none)]> CREATE DATABASE ocs;  
MariaDB [(none)]> GRANT ALL PRIVILEGES ON ocs.* TO ocs@localhost IDENTIFIED BY "password";

다음으로, 권한을 플러시하고 다음 명령어로 MariaDB 셸에서 나옵니다:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

MariaDB 데이터베이스 구성이 완료되면 다음 단계로 진행할 수 있습니다.

OCS 서버 설치

먼저, Git 리포지토리에서 OCE 서버의 최신 버전을 다운로드해야 합니다. 다음과 같이 git 명령어를 사용하여 다운로드할 수 있습니다:

git clone https://github.com/OCSInventory-NG/OCSInventory-Server.git

다음과 같은 출력이 표시됩니다:

Cloning into 'OCSInventory-Server'...
remote: Enumerating objects: 80, done.
remote: Counting objects: 100% (80/80), done.
remote: Compressing objects: 100% (57/57), done.
remote: Total 7563 (delta 28), reused 45 (delta 16), pack-reused 7483
Receiving objects: 100% (7563/7563), 52.63 MiB | 32.78 MiB/s, done.
Resolving deltas: 100% (5348/5348), done.

다운로드가 완료되면 OCSInventory-Server 디렉토리로 변경하고, 다음 명령어로 Git 리포지토리에서 ocsreport 프로젝트를 다운로드합니다:

cd OCSInventory-Server  
git clone https://github.com/OCSInventory-NG/OCSInventory-ocsreports.git ocsreports

다음으로, 다음 명령어로 ocsreports 디렉토리로 변경합니다:

cd ocsreports

다음으로, OCS 서버에 필요한 PHP 종속성을 설치하기 위해 Composer 패키지를 설치합니다:

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

설치가 완료되면 다음과 같은 출력이 표시됩니다:

All settings correct for using Composer
Downloading...

Composer (version 1.9.2) successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

다음으로, 다음 명령어로 모든 필수 PHP 종속성을 설치합니다:

composer install

모든 종속성이 설치되면 OCSInventory-Server 디렉토리로 변경하고 setup.sh 파일을 편집합니다:

cd ..  
nano setup.sh

다음과 같이 데이터베이스 설정을 정의합니다:

DB_SERVER_HOST="localhost"
DB_SERVER_PORT="3306"
DB_SERVER_USER="ocs"
DB_SERVER_PWD="password"

작업이 완료되면 파일을 저장하고 닫습니다. 그런 다음, 설치를 시작하기 위해 setup.sh 스크립트를 실행합니다:

./setup.sh

설치 중 여러 질문이 표시되며, 기본 설정을 선택하고 모든 질문에 대해 y를 입력합니다. 설치가 성공적으로 완료되면 다음과 같은 출력이 표시됩니다:

+----------------------------------------------------------------------+
|       OK, Communication server setup successfully finished ;-)       |
|                                                                      |
| Please, review /etc/apache2/conf-available/z-ocsinventory-server.conf |
|         to ensure all is good. Then restart Apache daemon.           |
+----------------------------------------------------------------------+

+----------------------------------------------------------------------+
|        OK, Administration server installation finished ;-)           |
|                                                                      |
| Please, review /etc/apache2/conf-available/ocsinventory-reports.conf
|          to ensure all is good and restart Apache daemon.            |
|                                                                      |
| Then, point your browser to http://server//ocsreports
|        to configure database server and create/update schema.        |
+----------------------------------------------------------------------+


Setup has created a log file /root/OCSInventory-Server/ocs_server_setup.log. Please, save this file.
If you encounter error while running OCS Inventory NG Management server,
we can ask you to show us its content !

DON'T FORGET TO RESTART APACHE DAEMON !

Enjoy OCS Inventory NG ;-)

이 시점에서 OCS 서버가 설치되었습니다. 이제 다음 단계로 진행할 수 있습니다.

OCS 서버 구성

OCS 서버를 설치한 후, Apache에 대한 OCS 서버 구성 파일을 활성화해야 합니다. 다음 명령어로 활성화할 수 있습니다:

ln -s /etc/apache2/conf-available/ocsinventory-reports.conf /etc/apache2/conf-enabled/ocsinventory-reports.conf  
ln -s /etc/apache2/conf-available/z-ocsinventory-server.conf /etc/apache2/conf-enabled/z-ocsinventory-server.conf  
ln -s /etc/apache2/conf-available/zz-ocsinventory-restapi.conf /etc/apache2/conf-enabled/zz-ocsinventory-restapi.conf

다음으로, 다음 명령어로 OCS 서버 디렉토리에 적절한 권한을 설정합니다:

chown -R www-data:www-data /var/lib/ocsinventory-reports  
chmod -R 775 /var/lib/ocsinventory-reports

마지막으로, 다음 명령어로 변경 사항을 적용하기 위해 Apache 서비스를 재시작합니다:

systemctl restart apache2

이 시점에서 OCS 서버가 설치되고 구성되었습니다. 이제 웹 인터페이스에 접근할 시간입니다.

OCS 서버 웹 인터페이스 접근

웹 브라우저를 열고 URL http://your-server-ip/ocsreports/install.php를 입력합니다. 다음 페이지로 리디렉션됩니다:

이제 OCS 데이터베이스 이름, 데이터베이스 사용자 이름, 비밀번호를 입력하고 전송 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

다음으로, “ OCS-NG GUI에 들어가려면 여기를 클릭하세요 “ 링크를 클릭합니다. 다음 페이지가 표시됩니다:

업데이트 수행 버튼을 클릭하여 데이터베이스를 업데이트합니다. 업데이트가 완료되면 다음 페이지가 표시됩니다:

이제 “OCS-NG GUI에 들어가려면 여기를 클릭하세요“ 링크를 클릭합니다. 다음과 같이 OCS 로그인 페이지로 리디렉션됩니다:

기본 사용자 이름과 비밀번호를 admin/admin으로 입력하고 전송 버튼을 클릭합니다. 다음과 같이 OCS 대시보드로 리디렉션됩니다:

다음으로, 보안상의 이유로 설치 파일을 제거하는 것이 좋습니다. 다음 명령어로 제거할 수 있습니다:

rm -rf /usr/share/ocsinventory-reports/ocsreports/install.php

결론

축하합니다! Debian 10에 OCS 서버를 성공적으로 설치하고 구성했습니다. 이제 OCS 대시보드를 탐색하고 IT 인프라 인벤토리를 관리할 수 있습니다. 질문이 있으면 언제든지 문의하세요.

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.