소스 설치¶
소스 ‘설치’는 Odoo를 설치하는 것이 아니라 소스에서 직접 실행하는 것입니다.
Odoo 소스를 사용하면 모듈 개발자가 더욱 쉽게 액세스할 수 있으므로 패키지 설치 프로그램보다 더 편리하게 사용할 수 있습니다.
패키지 설치 프로그램으로 서비스를 설정하는 것보다 Odoo를 더욱 유연하고 명확하게 시작 및 중지할 수 있습니다. 또한 환경 설정 파일을 편집할 필요 없이 명령줄 매개변수 를 사용하여 설정을 재지정할 수 있습니다.
마지막으로, 시스템 설정에 대해 더욱 양호하게 컨트롤 할 수 있게 되며 여러 버전의 Odoo를 함께 유지 (및 실행)하기가 더욱 쉬워집니다.
소스 가져오기¶
Odoo의 소스 코드를 받는 방법에는 ZIP 아카이브 또는 Git 을 통하는 두 가지 방법이 있습니다.
보관¶
커뮤니티 에디션:
엔터프라이즈 에디션:
Git¶
참고
Git 이 설치되어 있어야 하며, Git 명령어에 대한 기본 지식을 가지고 진행하는 것이 좋습니다.
To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
참고
엔터프라이즈 git 저장소에는 전체 Odoo 소스 코드가 포함되어 있지 않습니다. 이는 추가 애드온을 모아놓은 것에 불과합니다. 메인 서버 코드는 커뮤니티 버전에 있습니다. 엔터프라이즈 버전을 실행한다는 것은, 커뮤니티 버전에서 서버를 실행하고 addons-path 옵션을 엔터프라이즈 버전이 있는 폴더로 설정하는 것을 의미합니다. Odoo 엔터프라이즈 설치를 제대로 동작하도록 실행하기 위해서는 커뮤니티 및 엔터프라이즈 저장소를 모두 복제해야 합니다.
준비하기¶
파이선¶
Odoo requires Python 3.7 or later to run.
필요한 경우 패키지 관리자를 사용하여 Python 3을 다운로드하고 설치하세요.
최신 버전으로 Python 3를 다운로드 하여 설치하세요.
설치하려면 PATH에 Python 3 추가 에 표시한 다음 사용자 지정 설치 를 클릭하고 **pip**이 선택되어 있는지 확인합니다.
참고
If Python 3 is already installed, make sure that the version is 3.7 or above, as previous versions are not compatible with Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
이 버전에 pip 설치되어 있는지 여부도 확인합니다.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo는 PostgreSQL을 데이터베이스 관리 시스템으로 사용하고 있습니다.
패키지 관리자를 사용하여 PostgreSQL을 다운로드하여 설치합니다 (지원되는 버전: 12.0 이상). 다음과 같이 설치할 수 있습니다:
$ sudo apt install postgresql postgresql-client
PostgreSQL 다운로드 (지원 버전: 12.0 이상) 후 설치합니다.
Postgres.앱 을 사용하여 PostgreSQL (지원 버전: 12.0 이상)을 다운로드하여 설치합니다.
팁
Postgres.app에 번들로 제공되는 명령줄 도구를 사용하려면 Postgres.app CLI 도구 지침 에 따라 $PATH 변수를 설정해야 합니다.
기본값으로 사용자는 postgres 로만 되어 있습니다. Odoo는 ‘postgres’로 연결하는 것은 금지하고 있으므로 새로운 PostgreSQL 사용자를 생성하세요.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
참고
PostgreSQL 사용자 이름 정보는 Unix 로그인 정보와 동일하므로 비밀번호 없이 데이터베이스에 접속할 수 있습니다.
PostgreSQL의
bin디렉토리 (기본값C:\Program Files\PostgreSQL\<version>\bin) 를 `PATH`에 추가합니다.pg admin gui를 사용하여 비밀번호로 postgres 사용자를 생성합니다.
pgAdmin 을 엽니다.
서버를 더블 클릭하여 접속합니다.
을 선택합니다.
역할명 필드에 사용자 이름을 입력합니다 (예:
odoo).정의 탭을 열고 비밀번호 (예:
odoo)를 입력한 후 저장 을 클릭합니다.권한 탭을 열고 로그인 가능? 을 ‘예’로, 데이터베이스 생성? 을 ‘예’로 전환합니다.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
참고
PostgreSQL 사용자 이름 정보는 Unix 로그인 정보와 동일하므로 비밀번호 없이 데이터베이스에 접속할 수 있습니다.
의존성¶
종속 요소 설치 방법에는 배포 패키지 를 사용하는 것을 선호합니다. 또는 pip 을 사용하여 Python 종속 요소를 설치합니다.
Debian/Ubuntu에서는 다음 명령어를 사용하여 필수 패키지를 설치해야 합니다.
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh script will parse the debian/control file and install the found packages.
경고
pip를 사용할 경우 보안 문제가 발생하고 종속성이 손상될 수 있으므로, 작업 내용에 대해 정확히 파악한 후 작업을 수행할 수 있도록 합니다.
일부 Python 패키지에는 컴파일 단계가 있어야 하므로 시스템 라이브러리를 설치해야 합니다.
Debian/Ubuntu에서는 다음 명령어를 사용하여 필수 라이브러리를 설치해야 합니다.
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo의 종속 요소는 Odoo 커뮤니티 디렉토리 루트에 있는 requirements.txt 파일에 표시되어 있습니다.
참고
요구 사항.txt 에 있는 Python 패키지는 Odoo 릴리스 시점에 해당하는 안정적/LTS Debian/Ubuntu 버전을 기반으로 합니다. 예를 들어 Odoo 15.0의 경우 ‘python3-babel’ 패키지 버전은 Debian Bullseye에서는 2.8.0이고 Ubuntu Focal에서는 2.6.0입니다. 그러면 요구 사항.txt 에서 가장 낮은 버전이 선택됩니다.
팁
Python 모듈 패키지를 Odoo의 여러 가지 인스턴스 혹은 시스템과 혼합하지 않는 것이 바람직합니다. 다만 virtualenv 를 사용하여 격리된 Python 환경을 만들 수 있습니다.
Odoo 커뮤니티 설치 경로 (CommunityPath)로 이동하여 요구 사항 파일에서 pip 를 실행하여 현재 사용자에 대한 요구 사항을 설치합니다.
$ cd /CommunityPath
$ pip install -r requirements.txt
종속 요소를 설치하기 전에 ‘Visual Studio용 빌드 도구 <https://visualstudio.microsoft.com/downloads/>`_ 를 다운로드하여 설치합니다. 워크로드 탭에서 C++ 빌드 도구 를 선택한 후 메시지가 표시되면 설치합니다.
Odoo 종속 요소는 Odoo 커뮤니티 디렉토리의 루트에 있는 requirements.txt 파일에 표시되어 있습니다.
팁
Python 모듈 패키지를 Odoo의 여러 가지 인스턴스 혹은 시스템과 혼합하지 않는 것이 바람직합니다. 다만 virtualenv 를 사용하여 격리된 Python 환경을 만들 수 있습니다.
Odoo 커뮤니티 설치 경로 (CommunityPath)로 이동하여 터미널의 요구 사항 파일에서 관리자 권한**으로 **pip 를 실행합니다.
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo 종속 요소는 Odoo 커뮤니티 디렉토리의 루트에 있는 requirements.txt 파일에 표시되어 있습니다.
팁
Python 모듈 패키지를 Odoo의 여러 가지 인스턴스 혹은 시스템과 혼합하지 않는 것이 바람직합니다. 다만 virtualenv 를 사용하여 격리된 Python 환경을 만들 수 있습니다.
Odoo 커뮤니티 설치 경로 (CommunityPath)로 이동하여 요청 파일에서 pip 를 실행합니다.
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
참고
오른쪽에서 왼쪽 방향으로 입력하는 인터페이스 (예: 아랍어 또는 히브리어)를 사용하는 언어의 경우 rtlcss 패키지가 필요합니다.
패키지 관리자를 이용하여 nodejs 및 npm 을 다운로드하여 설치합니다.
rtlcss를 설치합니다:$ sudo npm install -g rtlcss
nodejs 를 다운로드하여 설치합니다.
rtlcss를 설치합니다:C:\> npm install -g rtlcss시스템 환경 변수 ‘PATH’를 편집하여
rtlcss.cmd`가 위치하고 있는 폴더를 추가합니다 (일반적으로 :file:`C:\Users\<user>\AppData\Roaming\npm\).
경고
wkhtmltopdf 는 pip 를 통해 설치되지 않으며 머리글과 바닥글을 지원하려면 반드시 버전 0.12.6 에서 수동으로 설치해야 합니다. 다양한 버전에 대한 내용은 wkhtmltopdf wiki 에서 자세하게 확인할 수 있습니다.
Odoo 실행하기¶
모든 종속 요소 설정이 완료되면 서버의 명령줄 인터페이스인 ‘odoo-bin’을 실행하여 Odoo를 실행할 수 있습니다. 이 위치는 Odoo 커뮤니티 디렉토리의 루트에서 확인할 수 있습니다.
서버를 설정하려면 명령 인자 또는 환경 설정 파일 을 지정합니다.
팁
엔터프라이즈 에디션의 경우 addons-path 인수에 enterprise 추가 기능에 대한 경로가 추가됩니다. 추가 기능이 제대로 로드되려면 반드시 addons-path 가 다른 경로보다 앞에 와야 합니다.
일반적으로 필요한 환경 설정 항목은:
PostgreSQL 사용자 및 비밀번호
사용자 지정 모듈을 로드하기 위해 기본값 외 사용자 지정된 애드온 경로
일반적인 방법은 서버 실행 방법은 다음과 같습니다:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
여기에서 CommunityPath 는 Odoo 커뮤니티 설치 경로이고 mydb 는 PostgreSQL 데이터베이스의 이름입니다.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
여기서 CommunityPath 는 Odoo 커뮤니티 설치 경로이고, dbuser 는 PostgreSQL 로그인 정보이며, dbpassword 는 PostgreSQL 비밀번호, `mydb`는 PostgreSQL 데이터베이스의 이름입니다.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
여기에서 CommunityPath 는 Odoo 커뮤니티 설치 경로이고 mydb 는 PostgreSQL 데이터베이스의 이름입니다.
서버가 시작된 후 (INFO 로그 odoo.modules.loading: Modules loaded.` 이 인쇄됨) 웹 브라우저에서 http://localhost:8069 를 열고 기본 관리자 계정으로 Odoo 데이터베이스에 로그인하며, 이메일은 admin, 비밀번호도 `admin`을 입력합니다.