ODOO Setup

安装依赖项

源代码安装需要手工安装依赖项。

Python 2.7

Linux 和 MacOS缺省已安装 Python 2.7；
Windows 使用官方的 Python 2.7.9 版本；
- 安装过程中，选择将 Python 的安装路径添加到系统搜索路径 PATH 中，安装后确认路径已经生效；
- 确保使用 2.7.9 版本，之前版本不稳定，而 3.X版本目前还不兼容；

PostgreSQL

安装后需要创建用户账号，缺省情况下只有一个 postgres 帐户，ODOO禁止使用 postgres账户进行连接操作。

Linux，使用安装包安装，然后创建帐户，由于登录帐号与登录Unix帐号一致，可以不用输入口令；
```
$ sudo su - postgres -c "createuser -s $USER"
```
MacOS，使用 postgres.app 是最简单的方法（app版本提供postgres 、当前登录用户和template1三个数据库和帐号，可以直接登录。app版本不提供图形化管理界面，只能使用psql或者第三方的工具管理和维护）；
Windows，使用 PostgreSQL for windows 安装：
- 添加 PostgreSQL 的 bin 路径（默认：C:\Program Files\PostgreSQL\9.6\bin）到系统的搜索路径PATH中；
- 使用 pgAdmin 图形界面创建帐户。双击服务器图标，创建一个连接，选择 Edit -> New Object -> New Login Role，在 Role文本框输入用户名（例如：odoo ），然后打开 Definition 标签输入口令（例如：odoo ），点击确定。
创建的用户和口令，在启动ODOO时通过 -w 参数和 -r 参数或者配置文件传递给ODOO。

Python依赖项

Python的依赖项在罗列在 requirements.txt 文件中。

Linux，Python依赖项可以使用系统包管理器或者 pip 安装；

$ pip install -r requirements.txt

MacOS，需要安装命令行工具（xcode-select --install ），然后下载和安装包管理器，你可以选者 homebrew 或者 macports 安装 non-Python 依赖项。pip 可以用来安装 Python 依赖项。

$ pip install -r requirements.txt

# 使用Postgres.app 安装 requirements.txt 中的 psycopg2 时报错
# 方法是删除 requirements.txt 中的 psycopg2 那一行 
# 然后直接使用 pip install psycopg2 安装通过

Windows，可能需要根据requirements.txt文件中罗列的依赖项手工安装。使用 http://www.stickpeople.com/projects/python/win-psycopg/ 安装 psycopg 。然后编辑requirements.txt 文件
- 删除 psycopy，因为已通过上述方法安装；
- 删除python-ldap、gevent、psutil 因为这些依赖项需要编译；
- 添加 pypiwin32，因为在Windows环境下是必须的；

C:\> cd \YourOdooPath
C:\YourOdooPath> C:\Python27\Scripts\pip.exe install -r requirements.txt

Less CSS

通过NodeJS安装LESS CSS。

Linux，通过包管理器安装NodeJS 和 NPM，然后再安装LESS；

# debian wheezy 和 Ubuntu 13.10 及以前版本需要手工安装
$ wget -qO- https://deb.nodesource.com/setup | bash -
$ apt-get install -y nodejs

# debian (>jessie) 和 ubuntu (>14.04) 需要为 NodeJS（debian称之为NodeJS）添加 symlinks 称为 Node，以便NPM调用
$ apt-get install -y npm
$ sudo ln -s /usr/bin/nodejs /usr/bin/node

#安装好NPM后，安装LESS
$ sudo npm install -g less

MacOS，通过你习惯的包管理器 (homebrew、macports) 安装NodeJS，然后安装LESS；；

$ sudo mpn install -g less

Windows，下载NodeJS安装包，安装NodeJS，注意要更新PATH以便于能够自动寻找到Node，然后安装LESS；

> npm install -g less

运行和停止ODOO

安装成功所有依赖项后，就可以通过运行 odoo-bin 来启动ODOO，默认站点端口是8069；

For the Enterprise edition, you must specify the enterprise addons folder when starting your server. 
You can do so by providing the path to your enterprise folder in the addons-path parameter. 
Please note that the enterprise folder must come before the default addons folder in the list 
for the addons to be loaded correctly.

配置信息可以通过命令行参数或者通过配置文件来设置ODOO的启动信息。一般来说，基本的配置信息包括：

PostgreSQL 主机、端口、用户和密码；

Odoo 没有默认的配置信息，psycopg2's 默认配置：在 UNIX 平台使用 5432 端口，并且使用当前的系统登录用户（不用口令）登录。缺省情况下，在 Linux 和 OS X 平台上能够正常运行，但是在 Windows 平台上不支持 UNIX 套接字；
addons-path 缺省模块安装目录；

在 Windows 平台上，典型的运行方法是：

# 参数说明：
# odoo/odoo：     PostgresSQL登录用户和口令
# ../mymodules：  附加的模块路径
# mydb：          缺省的数据库
C:\YourOdooPath> python odoo-bin -w odoo -r odoo --addons-path=addons,../mymodules --db-filter=mydb$

在 Unix 和 MacOS 平台，典型的运行方法是：

# 参数说明
# ../mymodules：  附加的模块路径
# mydb：          缺省的数据库
$ ./odoo-bin --addons-path=addons,../mymodules --db-filter=mydb$

# Mac启动（本机）
$ ./odoo-bin --addons-path=addons;

在终端中按两次 Ctrl-C 停止ODOO服务。

例外情况：

在MacOS上安装完所有依赖项，启动ODOO提示错误，重新安装一遍 requirements.txt 文件中的依赖项（psycopg2除外），最后再安装一次 psycopg2 ，然后启动ODOO成功。

在ODOO环境安装 Slides App时，处理时间有些长，不知是何原因。

安装ODOO