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

See the new Odoo user documentation.

See the new Odoo technical documentation.

Установка OpenERP

Работаете ли вы в компании малого бизнеса, и изучаете, как работает OpenERP, или являетесь сотрудником ИТ более крупной компании и получили задание оценить возможности OpenERP, ваше первое требование -- это установка или поиск работающей установленной системы.

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

Comparison of the different methods of installation on Windows or Linux

Способ

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

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

Примечания

OpenERP Demo

Установки нет

Простой

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

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

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

Простой

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

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

Полчаса

Средний

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

Пакеты Linux Ubuntu

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

Простой

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

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

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

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

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

Каждый раз при новом выпуске программного обеспечения, OpenERP предоставляет программу полной автоматической установки версии для Windows. Она содержит все необходимые вам компоненты -- сервер баз данных PostgreSQL, сервер приложения OpenERP и клиентское приложение GTK.

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

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

Примечание

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

Процесс разработки OpenERP идет двумя параллельными потоками: стабильные версии и версии в разработке.

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

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

Чтобы загрузить версию OpenERP для Windows, совершите следующие шаги:

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

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

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

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

Для установки OpenERP и ее баз данных вы должны иметь на компьютере права доступа уровня Администратор (или Administrator). При помощи двойного щелчка запустите программу установки и согласитесь с предложенными по умолчанию значениями в каждом диалоговом окне по мере установки.

Если вы пытались ранее устанавливать версию OpenERP «все-в-одном», вам вначале необходимо удалить ее (де-инсталлировать), потому что различные элементы предыдущей установки могут взаимодействовать с вашей новой установкой. Убедитесь, что все приложения Tiny ERP, OpenERP и PostgreSQL удалены: возможно, вам потребуется перезагрузить компьютер для окончательного удаления их следов.

Когда вы закончите установку «все-в-одном», можно открыть приложение-клиент OpenERP, готовое к использованию системы OpenERP. Следующим шагом является настройка базы данных, и этот шаг описан в заключительном разделе «Создание базы данных» настоящей главы.

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

System administrators can have very good reasons for wanting to install the various components of a Windows installation separately. For example, your company may not support the version of PostgreSQL or Python that is installed automatically, or you may already have PostgreSQL installed on the server you are using, or you may want to install the database server and application server on separate hardware units.

For this situation, you can get a separate installer for the OpenERP server from the same location as the all-in-one auto-installer. You will also have to download and install a suitable version of PostgreSQL independently.

Вы должны установить PostgreSQL до сервера OpenERP, и вы также должны создать пользовательскую запись и пароль, чтобы сервер OpenERP мог соединиться с PostgreSQL. Веб-документация OpenERP дает полное описание и подробные инструкции.

Подключение пользователей к серверу OpenERP с других ПК

Для соединения других компьютеров с сервером OpenERP вы должны настроить сервер таким образом, чтобы он был доступен с других компьютеров, и установить приложение-клиент GTK на каждый из них:

  1. Убедитесь, что ваш сервер OpenERP виден с других ПК путем открытия Брандмауэра Windows (Windows Firewall) в Панели Управления (Control Panel), и внесением в браддмауэр (firewall) исключения для сервера OpenERP. Во вкладке Исключения (Exceptions) Брандмауэра Windows (Windows Firewall) нажмите [Добавить программу...] (Add a program...) и выберите Сервер OpenERP (OpenERP Server) в предложенном списке. Это даст другим компьютерам возможность видеть приложение OpenERP на данном сервере.

  2. Установите приложение-клиент OpenERP (openerp-client-6.X.exe), которое вы можете скачать так же, как вы уже скачали прочее программное обеспечение OpenERP, на пользовательские ПК.

Совет

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

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

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

Для проверки вашей установки, начните с подключения к серверу через клиент OpenERP на машине-сервере, где вы все еще подключены как администратор.

Примечание

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

Обычно вам не требуется быть зарегистрированным как администратор ПК, когда вы пользуетесь клиентом OpenERP, но в случае возникновения проблем в установке будет легче оставаться администратором после установки, так что вы можете произвести все необходимые изменения, чем переключаться между пользовательскими записями тестировщика и установщика программного обеспечения.

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

/doc_static/6.1/_images/new_login_dlg.png

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

Примечание

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

При настройке по умолчанию в момент написания, клиент OpenERP соединяется с портом 8069 сервера, используя протокол XML-RPC (под Linux), или с портом 8070, используя протокол NET-RPC (под Windows). Вы можете использовать любой из протоколов под любой из операционных систем. NET-RPC несколько быстрее, однако вы можете этого не заметить при нормальном использовании клиента GTK. OpenERP может использовать XML-RPC, но не NET-RPC, как безопасное соединение.

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

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

  1. Работает ли серверное приложение OpenERP? Будучи зарегистрированным на сервере как администратор, остановите и перезапустите сервис при помощи [Остановить сервис] (Stop Service) и [Запустить сервис] (Start Service) из меню [Пуск ‣ Программы ‣ Сервер OpenERP] (Start ‣ Programs ‣ OpenERP Server).

  2. Is the OpenERP 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 is best to entirely reinstall the server from the demonstration installer rather than try to work out what is happening.

    /doc_static/6.1/_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 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 the PostgreSQL4OpenERP connection. You can find the password in the OpenERP server configuration file. If the database server is accessible you will be able to see some information about the empty database. If it is not, an error message will appear.

  5. Правильно ли установлены ваши клиентские программы? Если ваш клиент GTK OpenERP не запускается, простейшим решением будет его полная переустановка.

  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 OpenERP forums can often help identify the reason.

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

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

Примечание

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

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

Для получения информации об установке на другие дистрибутивы Linux, просмотрите раздел документации [Услуги ‣ Документация] (Services ‣ 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

Во время написания данного текста использовался PostgreSQL версии 8.4. От вас может потребоваться изменить номер версии в приведенных ниже командах, если версия вашего PostgreSQL отличается. Установка конфигурации базы данных Postgres:

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

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

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

на строку:

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

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

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

* Restarting PostgreSQL 8.4 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

Теперь мы можем перезапустить 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 – 6.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

openerp      5686  0.0  1.2  84688 26584 pts/7    Sl+  12:36   0:03 /usr/bin/python ./openerp-server.py
$ sudo lsof -i :8069

COMMAND  PID USER    FD   TYPE DEVICE SIZE/OFF NODE NAME

python  5686 openerp 3u  IPv4 116555      0t0  TCP *:8069 (LISTEN)
$ sudo lsof -i :8070

COMMAND  PID USER    FD   TYPE DEVICE SIZE/OFF NODE NAME

python  5686 openerp 5u  IPv4 116563      0t0  TCP *:8070 (LISTEN)

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

Хотя этот способ установки прост, и следовательно, является привлекательным вариантом, лучше установить OpenERP с использованием версии, скачанной с сайта http://openerp.com. Такая версия скорее всего более современна, чем доступная из дистрибутива Linux.

Примечание

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

Сопровождение пакетов -- это процесс разработки, тестирования и выпуска, что требует времени. Выпуски пакетов OpenERP (или Tiny ERP), следовательно, не всегда самые последние. Проверьте номер версии по информации на веб-сайте перед установкой пакета. Если различается только третья группа цифр (например, 6.0.1 вместо of 6.0.2), тогда вы можете решить установить ее, потому что отличия между пакетом и самой свежей версией будут небольшими -- устранение сбоев, а не функциональные изменения.

Установка сервера OpenERP вручную

В данном разделе вы узнаете, как установить OpenERP, полученную с сайта http://openerp.com, и как установить библиотеки и пакеты, от которых зависит OpenERP, на версию Ubuntu Desktop. Краткая сводка по процедуре:

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

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

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

Для скачивания базы данных PostgreSQL и всех других зависимостей для OpenERP из пакетов:

  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.4 then select it for installation along with its dependencies.

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

Примечание

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

Python -- это язык программирования, который был использован для разработки OpenERP. Это динамический, не типизированный язык, который является объектно-ориентированным, процедурным и функциональным. К нему имеется множество библиотек, которые предоставляют интерфейсы к другим языкам и его колоссальное преимущество в том, что его можно изучить всего за несколько дней. Этот язык выбрали многие разработчики NASA, Google, и многих других больших компаний.

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

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

Откройте окно терминала для запуска сервера командой openerp-server, которая должна привести к последовательности протокольных сообщений (log messages) по мере запуска сервера. Если сервер установлен правильно, по истечении примерно 30 секунд должно появиться сообщение [...] waiting for connections..., которое показывает, что сервер ждет соединения от клиента.

/doc_static/6.1/_images/terps_startup_log.png

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

Установка клиента OpenERP GTK вручную

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

/doc_static/6.1/_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 will 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 ).

Примечание

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

Связь между клиентом и сервером OpenERP базируется на стандартных протоколах. Вы можете соединиться из клиента под Windows с сервером под Linux, или наоборот, без проблем. То же самое относится и к версиям OpenERP для Mac -- вы можете соединяться с серверами из клиентов и под Windows и под Linux.

Для установки клиента OpenERP на компьютер под Linux, повторите ранее описанные в данном разделе шаги. Вы можете соединяться с сервером OpenERP из различных клиентов, изменяя параметры соединения для каждого клиента. Для этого нажмите кнопку [Изменить] (Change) на диалоговом окне параметров соединения и установите следующие поля, в соответствии с требованиями:

  • 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/6.1/_images/terp_client_server.png

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

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

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

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

/doc_static/6.1/_images/web_welcome.png

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

You can verify the installation by opening a web browser on the server and navigating to http://localhost:8069 to connect to the OpenERP web version as shown in the figure Запуск веб-клиента OpenERP при старте машины. You can also test this from another computer connected to the same network if you know the name or IP address of the server over the network – your browser should be set to http://<server_address>:8069 for this.

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

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

Совет

Средства psql и pgAdmin

psql -- это простой клиент, запускаемый из командной строки, который поставляется вместе с PostgreSQL. Он дает вам возможность исполнять команды SQL на вашей базе данных OpenERP.

Если вы предпочитаете графическую утилиту для прямой работы с вашей базой данных, вы можете установить 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. Если вы пытаетесь запустить сервер OpenERP из терминала, но получаете сообщение socket.error: (98, 'Address already in use'), это может означать, что вы пытаетесь запустить сервер OpenERP, в то время, как экземпляр OpenERP уже выполняется и использует порты, которые вы определили (по умолчанию 8069 и 8070). Если вы этого не ожидали, то возможно, что-то осталось от предыдущих установок OpenERP или Tiny ERP, либо какая-то иная программа использует один или оба этих порта.

    Type sudo netstat -anpt to discover what is running there, and record the PID. You can check that the PID corresponds 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.

  4. The OpenERP server has a large number of configuration options. You can see what they are by starting the server with the argument –help. By default 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 .

  5. Вы можете удалить конфигурационный файл, чтобы быть уверенным, что сервер OpenERP запускается только с опциями, установленными по умолчанию. Для обновленной системы часто встречается ситуация, когда система плохо работает вследствие того, что новая версия сервера не может работать с настройками от предыдущей версии. Когда сервер запущен без конфигурационного файла, он создаст новый файл, так что если что-то требуется изменить в фале, это можно сделать -- до внесения изменений сервер будет работать с настройками по умолчанию.

  6. Чтобы убедиться, что система работает, без путаницы в проблемах с брандмауэром (firewall), вы можете запустить клиента OpenERP во втором окне терминала на компьютере-сервере (такое соединение не проходит через брандмауэр (firewall)). Соединитесь с сервером, используя протокол XML-RPC на порту 8069 или NET-RPC на порту 8070. Сервер может работать по обоим портам одновременно. Откроется окно, показывающее протокол выполнения (log) клиента, запущенного таким путем.

  7. 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.

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

  9. Веб-сервер использует протокол NET-RPC. Если клиент GTK работает, а веб-сервер -- не работает, тогда проблема либо с портом NET-RPC, либо с самим веб-сервером, но не с сервером OpenERP.

Подсказка

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

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