This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

The installation of Open ERP

Whether you're from a small company investigating how Open ERP works, or on the IT staff of a larger organization and have been asked to assess Open ERP's capabilities, your first requirement is to install it or to find a working installation.

В таблице ниже приведена краткая сводка характеристик различных способов установки, которые подробно описаны в последующих разделах.

Comparison of the different methods of installation on Windows or Linux

Способ

Среднее время

Уровень сложности

Примечания

Программа установки Windows все-в-одном

Несколько минут

Простой

Очень полезно для быстрых оценок, так как все компоненты устанавливаются в настроенном состоянии на один компьютер (с использованием клиента GTK).

Раздельная установка на Windows

Полчаса

Средний

Дает вам возможность устанавливать компоненты на разные компьютеры. Может быть использован в реальной эксплуатации.

Пакеты Linux Ubuntu

Несколько минут

Простой

Простая и быстрая установка, но пакеты Ubuntu не всегда самые новые.

Из исходных кодов, для всех систем Linux

Более получаса

От среднего до немного сложного

Этот способ рекомендован для реальной эксплуатации, так как система легко поддерживается в актуальном состоянии.

Each time a new release of Open ERP is made, Tiny supplies a complete Windows auto-installer for it. This contains all of the components you need – the PostgreSQL database server, the Open ERP application server and the GTK application client.

Программа автоматической установки позволяет вам установить всю систему буквально при помощи «нескольких щелчков мыши». Начальная настройка, производимая при установке, позволяет начать использование системы очень быстро, пока вы не вносите изменений в код. Целью является установка всех компонентов на одном и том же ПК, но позже вы сможете также подключиться к системе при помощи клиентских приложений GTK с других ПК, Мак-ов и систем на основе Linux.

The first step is to download the Open ERP installer. At this stage you must choose which version to install – the stable version or the development version. If you're planning to put it straight into production you're strongly advised to choose the stable version.

Примечание

Стабильные версии и версии в разработке

Open ERP development proceeds on two parallel tracks: stable versions and development versions.

Новые функции вносятся в ветку версий в разработке. Эта ветка более продвинутая, чем стабильная версия, но она может содержать не выявленные и не устраненные сбои. Выпуск новой версии в разработке производится примерно один раз в месяц, и Tiny сделала хранилище кода доступным, так что вы можете загрузить самые последние выпуски, если вы хотите.

Стабильная ветка разрабатывается для условий эксплуатации. Выпуски новой функциональности делаются только примерно раз в год после длительного периода тестирования и проверки. На протяжении года в стабильной ветке вносятся только изменения, исправляющие ошибки.

To download the version of Open ERP for Windows, follow these steps:

  1. Перейдите на сайт http://openerp.com.

  2. Нажмите [Загрузки] (Downloads) в меню слева, под Установка для Windows, Все в одном (Windows Installers, All in One), All in One.

  3. Вы увидите программу установки версии для Windows, в настоящее время openerp-allinone-setup-5.0.0-3.

  4. Сохраните файл на вашем ПК - у него довольно внушительный размер, потому что в файле содержится все, включая систему управления базами данных PostgreSQL, так что процесс займет некоторое время.

To install Open ERP and its database you must be signed in as an Administrator on your PC. Double- click the installer file to install it and accept the default parameters on each dialog box as you go.

If you had previously tried to install the all-in-one version of Open ERP, you have to uninstall that first because various elements of a previous installation could interfere with your new installation. Make sure that all Tiny ERP, OpenERP and PostgreSQL applications are removed: you're likely to have to restart your PC to finish removing all traces of them.

The Open ERP client can be opened, ready to use the Open ERP system, once you have completed the all--in-one installation. The next step consists of setting up the database, and is covered in the final section of this chapter Создание базы данных.

Раздельная установка на Windows

У системных администраторов могут быть очень веские причины желать установить различные компоненты установки для Windows раздельно. Например, в вашей компании может не поддерживаться автоматически устанавливаемая версия PostgreSQL или Python, или у вас может уже иметься установленный на вашем используемом сервере PostgreSQL, или вы можете желать установить сервер баз данных, сервер приложений и веб-сервер на различном оборудовании.

For this situation you can get separate installers for the Open ERP server and client from the same location as the all-in-one auto-installer. You'll also have to download and install a suitable version of PostgreSQL independently.

You must install PostgreSQL before the Open ERP server, and you must also set it up with a user and password so that the Open ERP server can connect to it. Tiny's web-based documentation gives full and current details.

Connecting users on other PCs to the Open ERP server

To connect other computers to the Open ERP server you must set the server up so that it's visible to the other PCs, and install a GTK client on each of the those PCs:

  1. Make your Open ERP server visible to other PCs by opening the Windows Firewall in the Control Panel, then asking the firewall to make an exception of the Open ERP server. In the Exceptions tab of Windows Firewall click on Add a program... and choose Open ERP Server in the list provided. This step enables other computers to see the Open ERP application on this server.

  2. Install the Open ERP client (openerp-client-5.X.exe), which you can download in the same way as you downloaded the other Open ERP software, onto the other PCs.

Совет

Соответствие версий

Вы должны убедиться, что версия клиента соответствует версии сервера. Этот номер версии приведен как часть имени загруженного файла. Хотя есть возможность, что некоторые различные выпуски клиента и сервера будут работать совместно, в этом нет уверенности.

Для запуска программы-установщика на каждом ПК, вам потребуются на них права администратора. Установка автоматизирована, так что вам надо просто пройти различные шаги процесса установки.

To test your installation, start by connecting through the Open ERP client on the server machine while you're still logged in as administrator.

Примечание

Зачем регистрироваться на ПК как Администратор (Administrator)?

You'd not usually be signed on as a PC administrator when you're just running the Open ERP client, but if there have been problems in the installation it's easier to remain as an administrator after the installation so that you can make any necessary fixes than to switch user as you alternate between roles as a tester and a software installer.

Start the GTK client on the server through the Windows Start menu there. The main client window appears, identifying the server you're connected to (which is localhost – your own server PC – by default). If the message No database found, you must create one appears then you've successfully connected to an Open ERP server containing, as yet, no databases.

/doc_static/5.0/_images/new_login_dlg.png

Dialog box on connecting a GTK client to a new Open ERP server

Примечание

Режимы соединения (Connection modes)

In its default configuration at the time of writing, the Open ERP client connects to port 8069 on the server using the XML-RPC protocol (from Linux) or port 8070 using the NET-RPC protocol instead (from Windows). You can use either protocol from either operating system. NET-RPC is quite a bit quicker, although you may not notice that on the GTK client in normal use. OpenERP can run XML-RPC, but not NET-RPC, as a secure connection.

Устранение ошибок при установке на Windows

Если у вас не получается добиться работы OpenERP после установки вашей системы на Windows, вы можете найти ниже некоторые идеи по решению проблемы:

  1. Is the Open ERP Server working? Signed in to the server as an administrator, stop and restart the service using Stop Service and Start Service from the menu Start ‣ Programs ‣ OpenERP Server .

  2. Is the Open ERP Server set up correctly? Signed in to the server as Administrator, open the file openerp-server.conf in C:\Program Files\OpenERP AllInOne and check its content. This file is generated during installation with information derived from the database. If you see something strange it's best to entirely reinstall the server from the demonstration installer rather than try to work out what's happening.

    /doc_static/5.0/_images/terp_server_conf.png

    Typical OpenERP configuration file

  3. Is your PostgreSQL running? Signed in as administrator, select Stop Service from the menu Start ‣ Programs ‣ PostgreSQL. If, after a couple of seconds, you can read The PostgreSQL4OpenERP service has stopped then you can be reasonably sure that the database server was working. Restart PostgreSQL.

  4. Is the database accessible? Still in the PostgreSQL menu, start the pgAdmin III application which you can use to explore the database. Double-click on the PostgreSQL4OpenERP connection. You can find the password in the OpenERP server configuration file. If the database server is accessible you'll be able to see some information about the empty database. If it's not then an error message will appear.

  5. Are your client programs correctly installed? If your Open ERP GTK clients haven't started then the swiftest approach is to reinstall them.

  6. Can remote client computers see the server computer at all? Check this by opening a command prompt window (enter cmd in the window Start ‣ Run... ) and enter ping <address of server> there (where <address of server> represents the IP address of the server). The server should respond with a reply.

  7. Изменяли ли вы какие-либо параметры сервера? В этот момент установки номер порта сервера должен быть 8069 с использованием протокола XML-RPC.

  8. Is there anything else in the server's history that can help you identify the problem? Open the file openerp-server.log in C:\Program Files\OpenERP AllInOne(which you can only do when the server is stopped) and scan through the history for ideas. If something looks strange there, contributors to the Open ERP forums can often help identify the reason.

Установка на Linux (Ubuntu)

This section guides you through installing the Open ERP server and client on Ubuntu, one of the most popular Linux distributions. It assumes that you're using a recent release of Desktop Ubuntu with its graphical user interface on a desktop or laptop PC.

Примечание

Другие дистрибутивы Linux

Установка на другие дистрибутивы Linux очень похожа на установку на Ubuntu. Прочтите данный раздел документации, чтобы понять принципы, и затем воспользуйтесь документацией и форумами для ваших конкретных нужд на другом дистрибутиве.

Для получения информации об установке на другие дистрибутивы Linux, просмотрите раздел документации [Продукт ‣ Документация] (Product ‣ Documentation) на сайте http://www.openerp.com. Приводятся подробные инструкции для различных дистрибутивов и выпусков, и также вы можете проверить, есть ли обновленные инструкции для дистрибутива Ubuntu.

Техническая инструкция: Начальная установка и настройка

Обновите пакеты Ubuntu и установите openerp and pgadmin:

$ sudo apt-get update

$ sudo apt-get upgrade

$ sudo apt-get install openerp-server openerp-client pgadmin3

Чтобы обеспечить наличие переводов некоторых сообщений в клиенте GTK, установите языковый пакет language-pack-gnome-YOURLANG-base. Например, следующая команда установит пакет для испанского языка:

$ sudo apt-get install language-pack-gnome-es-base

Настройка базы данных Postgres:

$ sudo vi /etc/postgresql/8.3/main/pg_hba.conf

Замените следующую строку:

# “local” is for Unix domain socket connections only
local all all ident sameuser

на строку:

#”local” is for Unix domain socket connections only
local all all md5

Перезапустите Postgres:

$ sudo /etc/init.d/postgresql-8.3 restart

* Restarting PostgreSQL 8.3 database server [ OK ]

Две следующие команды служат для предотвращения проблем с INIT скриптом /etc/init.d/openerp-web:

$ sudo mkdir /home/openerp

$ sudo chown openerp.nogroup /home/openerp

Создайте пользовательскую запись «openerp» с паролем «openerp» и с правами создания баз данных Postgres:

$ sudo su postgres

$ createuser openerp -P

Enter password for new role: (openerp)

Enter it again:

Shall the new role be a superuser? (y/n) n

Shall the new role be allowed to create databases? (y/n) y

Shall the new role be allowed to create more new roles? (y/n) n

Выйдите из пользовательской записи postgres:

$ exit

exit

Измените конфигурационный файл OpenERP:

$ sudo vi /etc/openerp-server.conf

Замените две следующие строки (мы не заставляем использовать конкретную базу данных и добавляем требуемый пароль для получения доступа к postgres):

db_name =

db_user = openerp

db_password = openerp

Неисправность, связанная с версией Python: Python 2.6 еще не поддерживается системой OpenERP 5.0, но является версией Python по умолчанию в Ubuntu 9.0.4. Нам необходимо запускать OpenERP 5.0 с Python версии 2.5 или более ранней. Также существует проблема с пакетом python-xml в Ubuntu, так что мы его установим заново.

Установите Python 2.5:

$ sudo apt-get install python2.5 python2.5-dev python-profiler

Переустановите python-xml:

$ wget http://freefr.dl.sourceforge.net/sourceforge/pyxml/PyXML-0.8.4.tar.gz

$ tar xvzf PyXML-0.8.4.tar.gz

$ cd PyXML-0.8.4/

$ sudo python2.5 setup.py install

Сделайте следующую символическую ссылку:

$ sudo ln -s /usr/lib/python2.6/dist-packages/oldxml/_xmlplus/utils/boolean.so /usr/lib/python2.5/site-packages/oldxml/_xmlplus/utils/

Принудительный запуск openerp-server с Python2.5:

$ cd /usr/bin/

$ sudo cp openerp-server openerp-server.ORIG

$ sudo vi openerp-server

Замените следующую строку:

exec /usr/bin/python ./openerp-server.py $@

на

exec /usr/bin/python2.5 ./openerp-server.py $@

Теперь мы можем перезапустить openerp-server:

$ sudo /etc/init.d/openerp-server restart

Restarting openerp-server: openerp-server.

Проверьте log-файлы:

$ sudo cat /var/log/openerp.log

[2009-06-14 21:06:39,314] INFO:server:version – 5.0.0

[2009-06-14 21:06:39,314] INFO:server:addons_path – /usr/lib/openerp-server/addons

[2009-06-14 21:06:39,314] INFO:server:database hostname – localhost

[2009-06-14 21:06:39,315] INFO:server:database port – 5432

[2009-06-14 21:06:39,315] INFO:server:database user – openerp

[2009-06-14 21:06:39,315] INFO:objects:initialising distributed objects services

[2009-06-14 21:06:39,502] INFO:web-services:starting XML-RPC services, port 8069

[2009-06-14 21:06:39,502] INFO:web-services:starting NET-RPC service, port 8070

[2009-06-14 21:06:39,502] INFO:web-services:the server is running, waiting for connections…

Теперь OpenERP запущен и работает, соединен с базой данных Postgres на порту 5432 и готов к соединениям на портах 8069 и 8070

$ ps uaxww | grep -i openerp

root   2276  0.0  2.3 185576 23708 ?        Sl   13:09   0:00 /usr/bin/python2.5 ./openerp-server.py –config=/etc/openerp-server.conf
$ sudo lsof -i :8069

COMMAND PID USER FD TYPE DEVICE SIZE NODE NAME

python2.5 2276 openerp 3u IPv4 6515 TCP localhost:8069 (LISTEN)
$ sudo lsof -i :8070

COMMAND PID USER FD TYPE DEVICE SIZE NODE NAME

python2.5 2276 openerp 5u IPv4 6520 TCP *:8070 (LISTEN)

Start the OpenERP GTK client by clicking its icon in the Applications menu, or by opening a terminal window and typing tinyerp-client . The OpenERP login dialog box should open and show the message No database found you must create one!.

Although this installation method is simple and therefore an attractive option, it's better to install Open ERP using a version downloaded from http://openerp.com. The downloaded revision is likely to be far more up to date than that available from a Linux distribution.

Примечание

Версии пакетов

Maintaining packages is a process of development, testing and publication that takes time. The releases in Open ERP (or Tiny ERP) packages are therefore not always the latest available. Check the version number from the information on the website before installing a package. If only the third digit group differs (for example 5.0.1 instead of 5.0.2) then you may decide to install it because the differences may be minor – fault fixes rather than functionality changes between the package and the latest version.

Manual installation of the Open ERP server

In this section you'll see how to install Open ERP by downloading it from the site http://openerp.com, and how to install the libraries and packages that Open ERP depends on, onto a desktop version of Ubuntu. Here's a summary of the procedure:

  1. Перейдите в своем браузере на страницу http://openerp.com,

  2. Нажмите на [Загрузки] (Downloads) в левом меню,

  3. Скачайте файлы сервера и клиента из раздела Исходные коды (Sources) (Linux) в вашу домашнюю директорию (или в другое место, если вы определили иное место для скачанных файлов).

To download the PostgreSQL database and all of the other dependencies for Open ERP from packages:

  1. Запустите менеджер пакетов Synaptic (Synaptic Package Manager), и введите требуемый пароль.

  2. Check that the repositories main universe and restricted are enabled.

  3. Search for a recent version of PostgreSQL (such as postgresql-8.3 then select it for installation along with its dependencies.

  4. Выберите все зависимости OpenERP, обновленный список должен иметься в документации по установке на веб-сайте Tiny, затем нажмите кнопку [Обновить сейчас] (Update Now) для их установки.

Примечание

Язык программирования Python

Python is the programming language that's been used to develop Open ERP. It's a dynamic, non-typed language that is object-oriented, procedural and functional. It comes with numerous libraries that provide interfaces to other languages and has the great advantage that it can be learnt in only a few days. It's the language of choice for large parts of NASA's, Google's and many other enterprises' code.

Чтобы получить дальнейшую информацию о Python, изучите сайт http://www.python.org.

После того, как все зависимости и база данных установлены, установите сам сервер, используя инструкции на веб-сайте.

Open a terminal window to start the server with the command sudo -i -u postgres openerp-server , which should result in a series of log messages as the server starts up. If the server is correctly installed, the message [...] waiting for connections... should show within 30 seconds or so, which indicates that the server is waiting for a client to connect to it.

/doc_static/5.0/_images/terps_startup_log.png

Протокол запуска OpenERP в консоли

Manual installation of Open ERP GTK clients

To install an Open ERP GTK client, follow the steps outline on the website installation document for your particular operating system.

Совет

Опрос: Не нажимайте кнопку [Отмена] (Cancel)!

Когда вы запустите приложение-клиент GTK в первый раз, появится диалоговое окно, запрашивающее различную информацию, предназначенную помочь компании Tiny в оценке перспективной клиентской базы для ее программного обеспечения.

If you click the Cancel button, the window goes away – but Open ERP will ask the same questions again next time you start the client. It's best to click OK, even if you choose to enter no data, to prevent that window reappearing next time.

/doc_static/5.0/_images/terp_client_startup.png

Клиент OpenERP при запуске

Open a terminal window to start the client using the command openerp-client. When you start the client on the same Linux PC as the server you'll find that the default connection parameters will just work without needing any change. The message No database found, you must create one! shows you that the connection to the server has been successful and you need to create a database on the server.

Создание базы данных

You can connect other GTK clients over the network to your Linux server. Before you leave your server, make sure you know its network address – either by its name (such as mycomputer.mycompany.net ) or its IP address (such as 192.168.0.123 ).

Примечание

Различные сети

Communications between an Open ERP client and server are based on standard protocols. You can connect Windows clients to a Linux server, or vice versa, without problems. It's the same for Mac versions of Open ERP – you can connect Windows and Linux clients and servers to them.

To install an Open ERP client on a computer under Linux, repeat the procedure shown earlier in this section. You can connect different clients to the Open ERP server by modifying the connection parameters on each client. To do that, click the Change button on the connection dialog and set the following field as needed:

  • Server : name or IP address of the server over the network,

  • Port : the port, whose default is 8069 or 8070,

  • Connection protocol : XML-RPC or NET-RPC .

/doc_static/5.0/_images/terp_client_server.png

Диалоговое окно для определения параметров соединения с сервером

Возможно также соединиться из сервера к клиенту, используя безопасный протокол, не дающий возможности остальным пользователям сети перехватывать сетевой трафик, однако описанная здесь установка дана для прямого не зашифрованного соединения.

If your Linux server is protected by a firewall you'll have to provide access to port

8069or 8070for users on other computers with Open ERP GTK clients.

Установка веб-сервера OpenERP

Just as you installed a GTK client on a Linux server, you can also install the OpenERP client-web server. You can install it from sources after installing its dependencies from packages as you did with the Open ERP server, but Tiny have provided a simpler way to do this for eTiny – using a system known as ez_setup.

Before proceeding, confirm that your Open ERP installation is functioning correctly with a GTK client. If it's not you'll need to go back now and fix it, because you need to be able to use it fully for the next stages.

Для установки клиент-веб сервера следуйте обновленным инструкциям, данным в документах по установке на веб-сайте.

Примечание

Инструмент Ez (Ez tool)

Ez -- это система подготовки пакетов, используемая Python. Она дает возможность установки программ в соответствии с требованиями сходным с установкой пакетов дистрибутива Linux образом. Программное обеспечение загружается по сети и устанавливается на ваш компьютер программой ez_install.

ez_setup -- это небольшая программа, которая автоматически устанавливает ez_install.

The OpenERP Web server connects to the Open ERP server in the same way as an Open ERP client using the NET-RPC protocol. Its default setup corresponds to that of the Open ERP server you've just installed, so should connect directly at startup.

  1. В той же консоли, которую вы только что использовали, перейдите в директорию веб-сервера, набрав команду cd openerp-web-5.X.

  2. В терминальном окне наберите команду start-openerp-web для запуска веб-сервера OpenERP.

/doc_static/5.0/_images/web_welcome.png

Запуск веб-клиента OpenERP при старте машины

Вы можете проверить работу установленного веб-клиента, запустив браузер на сервере и перейдя на страницу http://localhost:8080 для соединения с eTiny, как показано на иллюстрации «Запуск веб-клиента OpenERP при старте машины». Вы также можете проверить соединение с другого компьютера, подключенного к той же сети, если вы знаете имя или IP адрес сервера в сети -- для этого при помощи вашего браузера нужно перейти на страницу http://<server_address>:8080.

Проверка вашей установки Linux

Пока что в процессе установки различных компонентов вы использовали параметры по умолчанию. Если вы встретили проблемы, или просто хотите настроить систему иным образом, ниже приведены некоторые пункты, дающие дополнительную информацию о том, как еще вы можете настроить систему.

Совет

Средства psql и pgAdmin

psql is a simple client, executed from the command line, that's delivered with PostgreSQL. It enables you to execute SQL commands on your Open ERP database.

Если вы предпочитаете графическую утилиту для прямой работы с вашей базой данных, вы можете установить pgAdmin III (который часто устанавливается автоматически с PostgreSQL, но также может быть получен с сайта http://www.pgadmin.org/).

  1. The PostgreSQL database starts automatically and listens locally on port 5432 as standard: check this by entering sudo netstat -anpt at a terminal to see if port 5432 is visible there.

  2. The database system has a default role of postgres accessible by running under the Linux postgres user: check this by entering sudo su postgres -c psql at a terminal to see the psql startup message – then type \q to quit the program.

  3. Start the Open ERP server from the postgres user (which enables it to access the PostgreSQL database) by typing sudo su postgres -c tinyerp-server.

  4. If you try to start the Open ERP server from a terminal but get the message socket.error: (98, 'Address already in use') then you might be trying to start Open ERP while an instance of Open ERP is already running and using the sockets that you've defined (by default 8069 and 8070). If that's a surprise to you then you may be coming up against a previous installation of Open ERP or Tiny ERP, or something else using one or both of those ports.

    Type sudo netstat -anpt to discover what is running there, and record the PID. You can check that the PID orresponds to a program you can dispense with by typing ps aux | grep <PID> and you can then stop the program from running by typing sudo kill <PID>. You need additional measures to stop it from restarting when you restart the server.

  5. The Open ERP server has a large number of configuration options. You can see what they are by starting the server with the argument –help By efault the server configuration is stored in the file .terp_serverrc in the user's home directory (and for the postgres user that directory is /var/lib/postgresql .

  6. You can delete the configuration file to be quite sure that the Open ERP server is starting with just the default options. It is quite common for an upgraded system to behave badly because a new version server cannot work with options from a previous version. When the server starts without a configuration file it will write a new one once there is something non-default to write to it – it will operate using defaults until then.

  7. To verify that the system works, without becoming entangled in firewall problems, you can start the Open ERP client from a second terminal window on the server computer (which doesn't pass through the firewall). Connect using the XML-RPC protocol on port 8069 or NET-RPC on port 8070. The server can use both ports simultaneously. The window displays the log file when the client is started this way.

  8. The client setup is stored in the file .terprc in the user's home directory. Since a GTK client can be started by any user, each user would have their setup defined in a configuration file in their own home directory.

  9. You can delete the configuration file to be quite sure that the Open ERP client is starting with just the default options. When the client starts without a configuration file it will write a new one for itself.

  10. The web server uses the NET-RPC protocol. If a GTK client works but the web server doesn't then the problem is either with the NET-RPC port or with the web server itself, and not with the Open ERP server.

Подсказка

Один сервер для нескольких компаний

You can start several Open ERP application servers on one physical computer server by using different ports. If you have defined multiple database roles in PostgreSQL, each connected through an Open ERP instance to a different port, you can simultaneously serve many companies from one physical server at one time.