Odoo文档——安装

Odoo文档——安装

下载和安装

下载地址：
https://www.odoo.com/zh_CN/page/download

安装文档地址：
https://www.odoo.com/documentation/12.0/setup/install.html

有四种方式来安装Odoo，可以部分安装，取决于你的需求。下面介绍着四种安装方式：

• 在线——在odoo官网上在线体验
• 打包好的安装器——适用于测试Odoo，开发模块，可用于长期生产使用，以及额外的部署和维护工作。
• 源代码安装——提供更大的灵活性:例如，允许在同一系统上运行多个Odoo版本。适合开发模块，可作为生产部署的基础。
• Docker——如果您通常使用docker进行开发或部署，则可以使用正式的docker基本映像。

在线体验

Demo

为了快速了解Odoo，可以使用Demo。它们是只存在几个小时的共享实例，可以用来浏览和尝试一些没有承诺的东西。

演示实例不需要本地安装，只需要一个web浏览器。

Saas

一开始很简单，完全由Odoo S.A.管理和迁移， Odoo的SaaS提供私有实例，而且一开始是免费的。它可以用于发现和测试Odoo，并进行非代码定制(即与定制模块或Odoo应用程序商店不兼容)，而无需在本地安装它。

可用于测试Odoo和长期生产使用。

与Demo一样，SaaS实例不需要本地安装，web浏览器就足够了。

打包好的安装器

Odoo为社区和企业版本的Windows、基于deb的发行版(Debian, Ubuntu，…)和基于rpm的发行版(Fedora, CentOS, RHEL，…)提供了打包安装程序。

这些包自动设置所有依赖项(针对社区版本)，但可能难以保持最新。

我们的夜间服务器上提供了所有相关依赖需求的官方社区包。Communtiy和企业包都可以从我们的下载页面下载(您必须作为付费客户或合作伙伴登录才能下载企业包)。

Windows

• 从我们的夜间服务器(仅适用于社区)或下载页面(任何版本)下载安装程序
• 执行下载的文件

Odoo将自动的执行余下的安装。

Linux

Debian/Ubuntu

Odoo 12.0 ’ deb '包目前支持Debian Stretch, Ubuntu 18.04或以上版本。

准备

Odoo需要一个PostgreSQL服务器才能正常运行。Odoo ’ deb '包的默认配置是在与Odoo实例相同的主机上使用PostgreSQL服务器。以root用户身份执行以下命令，安装PostgreSQL server:

#apt-get install postgresql -y

为了打印PDF报告，您必须自己安装wkhtmltopdf: Debian存储库中可用的wkhtmltopdf版本不支持页眉和页脚，因此不作为直接依赖项使用。推荐的版本是0.12.5，可以在wkhtmltopdf下载页面的存档部分获得。以前推荐的版本0.12.1是一个不错的选择。更多关于各种版本的详细信息和它们各自的怪癖可以在我们的wiki中找到。

仓库

Odoo S.A.提供了一个可以与Debian和Ubuntu发行版一起使用的存储库。它可以用来安装Odoo社区版，通过root执行以下命令：

# wget -O - https://nightly.odoo.com/odoo.key | apt-key add -
# echo "deb http://nightly.odoo.com/12.0/nightly/deb/ ./" >> /etc/apt/sources.list.d/odoo.list
# apt-get update && apt-get install odoo

然后可以使用常用的apt-get upgrade命令来更新安装。

当前，还没有企业版的存储库。

Deb包

你可在此下载“deb”软件包，而不是使用上述的资料库:

• 社区版本: nightly
• 企业版本：Download

然后你可以使用gdebi:

# gdebi 

或者dpkg:

# dpkg -i  # this probably fails with missing dependencies
# apt-get install -f # should install the missing dependencies
# dpkg -i 

这将安装Odoo作为服务，创建必要的PostgreSQL用户并自动启动服务器。

警告
下面的三个python包只建议在Debian包上安装。这3个包在Ubuntu Xenial(16.04)中并不可用。

• python3-vobject：用于日历中以生成ical文件。
• python3-pyldap:用于用LDAP对用户进行身份验证。
• python -qrcode:用于ESC/POS的硬件驱动程序

如果您需要上述警告中提到的一个或所有包，您可以手动安装它们。一种方法是，像这样简单地使用pip3:

$ sudo pip3 install vobject qrcode
$ sudo apt install libldap2-dev libsasl2-dev
$ sudo pip3 install pyldap

警告
Debian 9和Ubuntu没有为python模块num2words提供包。Odoo不会呈现文本量，这可能会导致“l10n_mx_edi”模块出现问题。
如果你需要这个功能，你可以像这样安装python模块:

$ sudo pip3 install num2words

Fedora

Odoo 12.0 ’ rpm '包支持Fedora 26。截至2017年，CentOS没有对Odoo 12.0的最低Python需求(3.5)。

此间省略，我不用Fedora

源代码安装

源代码“安装”实际上是关于不安装Odoo，而是直接从源代码运行它。

这对于模块开发人员来说更方便，因为Odoo源代码比打包安装更容易访问(用于获取信息或构建此文档并使其脱机可用)。

它还使启动和停止Odoo比打包安装所设置的服务更加灵活和明确，并且允许使用命令行参数覆盖设置，而不需要编辑配置文件。

最后，它提供了对系统设置的更大控制，并允许更容易地同时保持(和运行)多个Odoo版本。

准备

源代码安装需要手动安装依赖：

• Python 3.5+
• PostgreSQL 本地的数据库
  • 安装之后，需要创建一个postgres用户:默认情况下，惟一的用户是postgres, Odoo禁止以postgres连接。
    • 在Linux上使用发行版的包管理器来安装，然后创建一个用户来登录:

      $ sudo su - postgres -c “createuser -s $USER”
      因为角色login与您的unix login相同，所以unix套接字可以在没有密码的情况下使用。\

    • 在OS X上，postgres.app是最简单的入门方式，然后像在Linux上一样创建一个postgres用户。
    • 在Windows上，使用PostgreSQL for windows 然后：
      • 添加PostgreSQL的bin目录(默认值:C:\Program Files\PostgreSQL\9.4\本)到PATH
      • 创建一个postgres用户与密码使用pg管理gui:打开pgAdminIII,双击服务器创建一个连接,选择编辑‣新对象‣新的登录角色,进入usename角色名称字段(如odoo),然后打开定义选项卡并输入密码(如odoo),然后单击OK。
        必须使用-w和-r选项或配置文件将用户和密码传递给Odoo
• 在requirements.txt文件中列出的Python依赖
  • 在Linux上，python依赖项可以通过系统的包管理器或使用pip安装。
    对于使用本地代码的库(Pillow、lxml、greenlet、gevent、psycopg2、ldap)，在pip能够安装依赖项本身之前，可能需要安装开发工具和本地依赖项。这些包可以在-dev或-devel包中用于Python、Postgres、libxml2、libxslt、libevent、libsasl2和libldap2。然后Python dependecies可以自己安装:

    pip3 install -r requirements.txt

  • 在OS X上，您将需要安装命令行工具(xcode-select—install)，然后下载并安装您选择的包管理器(homebrew、macports)来安装非python依赖项。然后可以使用pip在Linux上安装Python依赖项:

    pip3 install -r requirements.txt

  • 在Windows上，您需要手动安装一些依赖项，调整requirements.txt文件，然后运行pip来安装剩余的依赖项。
    使用这里的安装程序安装psycopg:
    http://www.stickpeople.com/projects/python/win-psycopg/
    然后使用pip安装依赖项，使用cmd.exe提示符中的以下命令(用下载Odoo的实际路径替换\YourOdooPath):

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

• 来自nodejs的RTLCSS
  对于具有从右到左界面的语言(如阿拉伯语或希伯来语)，需要使用包rtlcss。
  我用不着，这里略过。

获取源代码

有两种渠道来获取Odoo的源代码: zip或者git。

• Odoo zip可以从我们的nightly服务器或下载页面下载，然后需要解压zip文件才能使用它的内容
• git允许更简单的更新和更容易地在Odoo的不同版本之间切换。它还简化了维护非模块补丁和贡献。git的主要缺点是它比tarball大得多，因为它包含了Odoo项目的整个历史。

社区版本

git存储库是https://github.com/odoo/odoo.git，用于社区版本。
下载它需要一个git客户机(可以通过linux上的发行版获得)，可以使用以下命令执行:

$ git clone https://github.com/odoo/odoo.git

企业版本

不用，略过

执行Odoo

一旦所有依赖项都设置好了，Odoo就可以通过运行odo-bin启动了。
可以通过命令行参数或配置文件提供配置。
一般需要下列的配置：

• PostSQL的地址、端口、用户名和密码。
  除了psycopg2的缺省值之外，Odoo没有其他缺省值:通过端口5432上的UNIX套接字连接当前用户，并且没有密码。默认情况下，这应该适用于Linux和OS X，但它不会适用于windows，因为它不支持UNIX套接字。
• 自定义插件路径，以加载自己的模块。

在Windows下执行odoo的典型方式是:

C:\YourOdooPath> python3 odoo-bin -w odoo -r odoo --addons-path=addons,…/mymodules --db-filter=mydb$

其中odoo, odoo是postgresql的登录名和密码，…/mymodules包含附加插件的目录，mydb是本地主机上的默认db:8069

Virtualenv

Virtualenv是一个创建Python隔离环境的工具，因为有时最好不要将发行版Python模块包与全局安装的带有pip的Python模块混合使用。
本节将解释如何在这样一个隔离的Python环境中运行Odoo。
这里我们将使用virtualenvwrapper，它是一组shell脚本，使virtualenv的使用更加容易。
下面的示例基于Debian 9发行版，但是可以在virtualenvwrapper和virtualenv能够运行的任何平台上进行调整。
本节假设您从zip文件或git存储库中获得了Odoo源代码，如上所述。postgresql的安装和配置也是如此。\

安装virtualenvwrapper

$ sudo apt install virtualenvwrapper
$ source /usr/share/virtualenvwrapper/virtualenvwrapper.sh

这将安装virtualenvwrapper并立即激活它。现在，让我们安装必要的工具，以建立Odoo依赖关系:

$ sudo apt install build-essential python3-dev libxslt-dev libzip-dev libldap2-dev libsasl2-dev

创建一个隔离的环境

现在我们可以像这样为Odoo创建一个虚拟环境:

$ mkvirtualenv -p /usr/bin/python3 odoo-venv

使用这个命令，我们需要一个名为“odo -env”的独立Python3环境。如果命令如预期的那样工作，那么您的shell现在正在使用这个环境。您的提示符应该已经更改，以提醒您正在使用一个隔离的环境。你可以用这个命令来验证:

$ which python3

这个命令应该向您显示位于隔离环境目录中的Python解释器的路径。

现在让我们安装Odoo所需的python包:

$ cd your_odoo_sources_path
$ pip install -r requirements.txt

过一会儿，您应该准备好从上面解释的命令行运行odoo。

当您想离开虚拟环境时，只需发出以下命令:

$ deactivate

当你想再次与你的“odo-venv”环境工作:

$ workon odoo-venv

Docker

关于如何与Docker一起使用Odoo的完整文档可以在官方的Odoo Docker镜像页面上找到。