Difference between revisions of "Odoo"

From ArchWiki
Jump to: navigation, search
(Installing and Configuring PostgreSQL: adding postgresql to /etc/rc.conf)
m (Configuring PostgreSQL for local use on your own machine: Change to iproute2 ss command.)
(30 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category: Office]]
+
[[Category:Office]]
 
{{stub}}
 
{{stub}}
  
 
=Introduction=
 
=Introduction=
  
This introduction briefly describes [http://openerp.com/en/home.html Open ERP], its philosophy, and community. The rest of this wikipage details installing and configuring Open ERP on Arch Linux, and also provides additional information about Open ERP documentation, community, and development.
+
This introduction briefly describes [http://openerp.com/ Open ERP], its basic design, and its community. The rest of this wikipage details installing and configuring Open ERP on Arch Linux. It also provides additional information about Open ERP documentation, community, and development.
  
Open ERP is Enterprise Resource Planning software, released under the GPL v3 license, and written in the Python programming language. It features an application server which uses PostgreSQL for its database, along with a standalone GTK-based client, as well as a web-based client. Its design is highly modular, allowing the rapid development of new modules through the Open Object RAD, which extends its functionality.
+
Open ERP is Enterprise Resource Planning software. It provides a complete, integrated ERP solution for small and medium sized businesses and organizations. Open ERP includes financial and analytic accounting, warehouse and inventory management, sales and purchase management, customer and supplier relations management, association management, tasks automation, human resource management, marketing campaign, document management, help desk, e-commerce integration, and point of sale functionality.
  
Open ERP provides a complete integrated ERP solution for small and medium sized business and organizations. It includes financial and analytic accounting, warehouse and inventory management, sales and purchase management, customer and supplier relations management, association management, tasks automation, human resource management, marketing campaign, document management, help desk, e-commerce integration, and point of sale functionality.
+
Open ERP features an application server which uses PostgreSQL for its database, along with a standalone GTK-based client, as well as a web-based client. It is written in the Python programming language, with a highly modular design which allows for the rapid development of new modules through Open Object RAD. Open ERP developers have a strong committment to free software.
  
All software released by Open ERP is free software. Additionally, Open ERP provides very complete documentation in various electronic formats, as well as hardcopy. A strong support and development community has grown up around Open ERP, providing free technical support, bugfixing, new development, and support services. The company responsible for development of Open ERP earns profits by providing support, training, software development and quality testing, hosting services, and through partnership services with Open ERP consultants.
+
A thriving support and development community has grown up around Open ERP, providing free technical support, bugfixing, new development, and support services. Open ERP provides extensive documentation in various electronic formats, as well as hardcopy. The company responsible for development of Open ERP earns profits through partnership services with Open ERP consultants, and by providing support, training, hosting services, software development, and software quality testing and verification.
  
 
=Before Installing Open ERP=
 
=Before Installing Open ERP=
  
Open ERP requires a special configuration of PostgreSQL, as well as installation of Python 2.5.4. The following sections provide detailed step-by-step instructions on installing and configuring these packages. For those seeking a shortcut on package installation, execute the following command from the CLI:
+
The following instructions assume that you have installed the 'sudo' command on your Arch Linux system. If you have not already done so, go to the [[sudo]] Arch Wikipage for more information.
  
yaourt -Sy openerp-client
+
===Installing PostgreSQL===
  
It will still be necessary to configure PostgreSQL as detailed below, but this command should install all necessary packages and dependencies.
+
Open ERP uses the PostgreSQL database, which should be installed and configured before installing Open ERP. Follow the instructions in the "Installing PostgreSQL" section of the [https://wiki.archlinux.org/index.php/PostgreSQL#Installing_PostgreSQL Arch PostgreSQL Wikipage]. Complete these installation instructions, but do '''not''' perform any other configuration from that page. Return to this page for additional configuration steps.
  
==Installing and Configuring PostgreSQL==
+
===Configuring PostgreSQL for local use on your own machine===
  
The following instructions assume that you have already installed the 'sudo' command on your Arch Linux system. If you have not already done so, go to the [[sudo]] Arch Wikipage for more information.
+
If you plan to use PostgreSQL and Open ERP on the same machine, you will need to configure PostgreSQL to listen on the localhost's 5432 TCP port. As root, open the following configuration file with a text editor:
 
+
Open ERP uses the PostgreSQL database, which should be installed and configured before installing Open ERP. Follow the instructions in the "Installing PostgreSQL" section of the [http://wiki.archlinux.org/index.php/PostgreSQL#Installing_PostgreSQL Arch PostgreSQL Wikipage]. Complete these installation instructions, but do '''not''' perform any additional configuration from that page. Return to this page for additional configuration steps.
+
 
+
Assuming that you plan to use PostgreSQL and Open ERP on the same machine, you will need to configure PostgreSQL to listen on the localhost machine's 5432 TCP port. (If you need remote access to PostgreSQL over a network, read the following section from the [http://wiki.archlinux.org/index.php/PostgreSQL#Configure_PostgreSQL_to_be_accessible_from_remote PostgreSQL Arch Wikipage].) As root, open the following configuration file with a text editor:
+
  
 
  /var/lib/postgres/data/postgresql.conf
 
  /var/lib/postgres/data/postgresql.conf
Line 64: Line 60:
 
Verify that PostgreSQL is listening on the localhost port 5432 by executing the following command:
 
Verify that PostgreSQL is listening on the localhost port 5432 by executing the following command:
  
  sudo netstat -anpt
+
  # ss -anpt
  
 
Within the output from this command, you should find the following line of text, except for the PID number which will very likely be different:
 
Within the output from this command, you should find the following line of text, except for the PID number which will very likely be different:
Line 70: Line 66:
 
  tcp        0      0 127.0.0.1:5432          0.0.0.0:*              LISTEN      13420/postgres
 
  tcp        0      0 127.0.0.1:5432          0.0.0.0:*              LISTEN      13420/postgres
  
Next, it is necessary to create a new PostgreSQL user for Open ERP. In this example, the user is 'openerp', but you may create any user name you wish. First, log in as the default PostgreSQL superuser, 'postgres', by executing the following command from the CLI:
+
===Configuring PostgreSQL for remote use over a network===
 +
 
 +
If you need remote access to PostgreSQL over a network, read the following section from the [https://wiki.archlinux.org/index.php/PostgreSQL#Configure_PostgreSQL_to_be_accessible_from_remote PostgreSQL Arch Wikipage].
 +
 
 +
===Setting up PostgreSQL to run with Open ERP===
 +
 
 +
Next, it is necessary to create a new PostgreSQL user for Open ERP. In this example, the user is 'yourusername', but you should replace this with your Arch system login username. First, log in as the default PostgreSQL superuser, 'postgres', by executing the following command from the CLI:
  
 
  sudo su - postgres
 
  sudo su - postgres
  
Once logged in as postgres, begin the process of creating the 'openerp' user, with the folowing command:
+
Once logged in as postgres, begin the process of creating the 'yourusername' user, with the folowing command:
  
  createuser openerp -P
+
  createuser yourusername -P
  
 
You will first be asked for a password. For highly secure yet easy to remember passwords, consider using a [http://world.std.com/~reinhold/diceware.html Diceware Passphrase]. Re-enter the password as requested. The next three questions should be answered in sequence with n, y, and n. Shall the new role be a superuser? n Shall the new role be allowed to create database? y Shall the new role be allowed to create more new roles? n
 
You will first be asked for a password. For highly secure yet easy to remember passwords, consider using a [http://world.std.com/~reinhold/diceware.html Diceware Passphrase]. Re-enter the password as requested. The next three questions should be answered in sequence with n, y, and n. Shall the new role be a superuser? n Shall the new role be allowed to create database? y Shall the new role be allowed to create more new roles? n
Line 85: Line 87:
  
 
This completes the installation and setup of PostgreSQL for use with Open ERP under Arch Linux. Additional detailed information about PostgreSQL configuration may be found on the Arch Wikipage for [[PostgreSQL]], and the [http://www.postgresql.org/docs/manuals/ PostgreSQL Manuals webpage]. Also, there is a powerful GUI PostgreSQL Admin tool, [http://www.pgadmin.org/ pgAdmin], which is available in the Arch repositories.
 
This completes the installation and setup of PostgreSQL for use with Open ERP under Arch Linux. Additional detailed information about PostgreSQL configuration may be found on the Arch Wikipage for [[PostgreSQL]], and the [http://www.postgresql.org/docs/manuals/ PostgreSQL Manuals webpage]. Also, there is a powerful GUI PostgreSQL Admin tool, [http://www.pgadmin.org/ pgAdmin], which is available in the Arch repositories.
 
==Installing Python 2.5.4, Python libraries, and other dependencies==
 
 
Open ERP requires Python 2.5. Since only later versions of Python are provided by the Arch extra repository, Python 2.5.4 must be installed from the Arch User Repository. [[Yaourt]] is the simplest tool to use when installing packages from AUR. From the command line interface, execute the following command:
 
 
yaourt -Sy python25
 
 
Open ERP requires various Python libraries compiled specifically against Python 2.5. In order to install these packages, from the command line interface, execute the following command:
 
 
yaourt -Sy python25-psycopg2 python25-reportlab python25-pychart python25-pydot
 
python25-egenix-mx-base python25-libxml2 python25-libxslt python25-lxml python25-pyxml
 
python25-pytz python25-pil
 
  
 
=Installing Open ERP from AUR=
 
=Installing Open ERP from AUR=
  
'''Open ERP Server'''
+
Open ERP requires the installation of the Open ERP Server, and either the Open ERP GTK-Client or the Open ERP Web-Client. Currently, Open ERP is not available in the main repositories of Arch Linux, but it is available through the Arch User Repository. Open ERP requires Python 2.5, various libraries compiled with Python 2.5, and a few other dependencies not found in the Arch repositories. All of these packages are provided through AUR. The best tool for downloading, compiling, and installing AUR packages is [[yaourt]]. The following instructions assume that yaourt has been installed and configured on the user's system.
  
'''Open ERP Client'''
+
===Open ERP GTK-Client===
  
'''Open ERP Web'''
+
To install the Open ERP standalone GTK-based client, from the CLI, execute the following command:
  
=Installing Open ERP from Source=
+
yaourt -S openerp-client
 
+
'''Open ERP Server'''
+
 
+
'''Open ERP Client'''
+
 
+
'''Open ERP Web'''
+
 
+
=Configuring Open ERP=
+
  
 
=Additional Open ERP Documentation=
 
=Additional Open ERP Documentation=
  
There are various sources of Open ERP documentation. The best place to start is the [http://doc.openerp.com/ Open ERP Documentation webpage]. This page links to different online documents, including [http://doc.openerp.com/install/index.html detailed installation instructions]. Additionally, there is an online copy of the book, [http://doc.openerp.com/book/index.html "Open ERP for Retail and Industrial Management"]. This copy is also available as a [http://www.openerp.com/en/buy/e-book.html PDF file], and can be purchased in [http://www.openerp.com/buy.html?page=shop.product_details&flypage=openerp.tpl&product_id=36&category_id=8 hardcopy form from Open ERP] or from [http://www.amazon.com/Open-ERP-Retail-Industrial-Management/dp/2960087607/ref=sr_1_1?ie=UTF8&s=books&qid=1248879333&sr=8-1 Amazon.com]. While Open ERP documentation, such as "Open ERP for Retail and Industrial Management" is freely downloadable, it does not come with a free documentation license. Further details about this issue are found on the [http://doc.openerp.com/documentation_license.html Open ERP website].
+
There are various sources of Open ERP documentation. The best place to start is the [http://doc.openerp.com/ Open ERP Documentation webpage]. This page links to different online documents, including [http://doc.openerp.com/install/index.html detailed installation instructions]. Additionally, there is an online copy of the book, [http://doc.openerp.com/book/index.html "Open ERP for Retail and Industrial Management"]. This copy is also available as a [http://www.openerp.com/en/buy/e-book.html PDF file]{{Linkrot|2011|09|06}}, and can be purchased in [http://www.openerp.com/buy.html?page=shop.product_details&flypage=openerp.tpl&product_id=36&category_id=8 hardcopy form from Open ERP]{{Linkrot|2011|09|06}} or from [http://www.amazon.com/Open-ERP-Retail-Industrial-Management/dp/2960087607/ Amazon.com]. While Open ERP documentation, such as "Open ERP for Retail and Industrial Management" is freely downloadable, it does not come with a free documentation license. Further details about this issue are found on the [http://doc.openerp.com/documentation_license.html Open ERP website]{{Linkrot|2011|09|06}}. Finally, [http://www.openerp.tv/ Open ERP TV] provides screencasts, some of which document various features and procedures of the software.
  
 
=Open ERP Community=
 
=Open ERP Community=
  
The Open ERP Community is centered upon the [http://openobject.com/ Open Object website]. Open Object is the Python-based Rapid Application Development framework for developing Open ERP modules. Free technical support for Open ERP may be found in the [http://openobject.com/forum/index.php webforums], a [http://tiny.be/mailman/listinfo/tinyerp-users mailing list] which is linked to the webforums, an [http://openobject.com/irc/ IRC channel] on freenode.net, an [http://www.openobject.com/wiki/index.php/Main_Page Open ERP wiki], and the [http://doc.openerp.com/ Official ERP Documentation webpage.] The latest news may be found on [http://openerp.com/planet/ Open ERP Planet], while various Open ERP screencasts are provided on [http://www.openerp.tv/ Open ERP TV].
+
The Open ERP Community is centered upon the [http://openobject.com/ Open Object website]. Free technical support for Open ERP may be found in the [http://openobject.com/forum/index.php webforums], a [http://tiny.be/mailman/listinfo/tinyerp-users mailing list]{{Linkrot|2011|09|06}} which is linked to the webforums, an [http://openobject.com/irc/ IRC channel] on freenode.net, an [http://www.openobject.com/wiki/index.php/Main_Page Open ERP wiki], and the [http://doc.openerp.com/ Official ERP Documentation webpage.] The latest news may be found on [http://openerp.com/planet/ Open ERP Planet], while various Open ERP screencasts are provided on [http://www.openerp.tv/ Open ERP TV]. Fee-based support services are provided by [http://openerp.com/en/partners.html Open ERP Partners]{{Linkrot|2011|09|06}}.
  
Development work is centered upon the [https://launchpad.net/openobject Open Object Launchpad page]. Developer news and blogs are published on [http://openobject.com/planet/ Open Object Planet]. There are pages for [http://www.openerp.com/index.php?option=com_content&view=article&id=18&Itemid=28 software downloads], [http://doc.openerp.com/modindex.html Open ERP module downloads], and [http://openobject.com/index.php?option=com_content&view=article&id=53&Itemid=61 development source code downloads].
+
=Open Object RAD=
  
=Open Object RAD=
+
Open Object is the Python-based [http://openobject.com/index.php?option=com_content&view=article&id=46&Itemid=53 Rapid Application Development framework] for developing Open ERP modules. It allows developers and businesses to customize Open ERP for specific needs. Open Object RAD development work is centered upon the [https://launchpad.net/openobject Open Object Launchpad page]. Developer news and blogs are published on [http://openobject.com/planet/ Open Object Planet]. There are pages for [http://www.openerp.com/index.php?option=com_content&view=article&id=18&Itemid=28 software downloads], [http://doc.openerp.com/modindex.html Open ERP module downloads]{{Linkrot|2011|09|06}}, and [http://openobject.com/index.php?option=com_content&view=article&id=53&Itemid=61 development source code downloads].

Revision as of 03:32, 4 March 2013

Tango-document-new.pngThis article is a stub.Tango-document-new.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Odoo#)

Introduction

This introduction briefly describes Open ERP, its basic design, and its community. The rest of this wikipage details installing and configuring Open ERP on Arch Linux. It also provides additional information about Open ERP documentation, community, and development.

Open ERP is Enterprise Resource Planning software. It provides a complete, integrated ERP solution for small and medium sized businesses and organizations. Open ERP includes financial and analytic accounting, warehouse and inventory management, sales and purchase management, customer and supplier relations management, association management, tasks automation, human resource management, marketing campaign, document management, help desk, e-commerce integration, and point of sale functionality.

Open ERP features an application server which uses PostgreSQL for its database, along with a standalone GTK-based client, as well as a web-based client. It is written in the Python programming language, with a highly modular design which allows for the rapid development of new modules through Open Object RAD. Open ERP developers have a strong committment to free software.

A thriving support and development community has grown up around Open ERP, providing free technical support, bugfixing, new development, and support services. Open ERP provides extensive documentation in various electronic formats, as well as hardcopy. The company responsible for development of Open ERP earns profits through partnership services with Open ERP consultants, and by providing support, training, hosting services, software development, and software quality testing and verification.

Before Installing Open ERP

The following instructions assume that you have installed the 'sudo' command on your Arch Linux system. If you have not already done so, go to the sudo Arch Wikipage for more information.

Installing PostgreSQL

Open ERP uses the PostgreSQL database, which should be installed and configured before installing Open ERP. Follow the instructions in the "Installing PostgreSQL" section of the Arch PostgreSQL Wikipage. Complete these installation instructions, but do not perform any other configuration from that page. Return to this page for additional configuration steps.

Configuring PostgreSQL for local use on your own machine

If you plan to use PostgreSQL and Open ERP on the same machine, you will need to configure PostgreSQL to listen on the localhost's 5432 TCP port. As root, open the following configuration file with a text editor:

/var/lib/postgres/data/postgresql.conf

Search for the following section within the postgresql.conf file:

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

#listen_addresses = 'localhost'         # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost', '*' = all
                                        # (change requires restart)
#port = 5432                            # (change requires restart)

Uncomment the #listen_addresses line, and replace the text 'localhost' with '127.0.0.1'. Also, uncomment the #port line. Save the file. When complete, the file should appear as follows:

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

listen_addresses = '127.0.0.1'          # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost', '*' = all
                                        # (change requires restart)
port = 5432                             # (change requires restart)

Restart PostgreSQL so that it uses the newly changed conf file, by executing the following command:

sudo /etc/rc.d/postgresql restart

Verify that PostgreSQL is listening on the localhost port 5432 by executing the following command:

# ss -anpt

Within the output from this command, you should find the following line of text, except for the PID number which will very likely be different:

tcp        0      0 127.0.0.1:5432          0.0.0.0:*               LISTEN      13420/postgres

Configuring PostgreSQL for remote use over a network

If you need remote access to PostgreSQL over a network, read the following section from the PostgreSQL Arch Wikipage.

Setting up PostgreSQL to run with Open ERP

Next, it is necessary to create a new PostgreSQL user for Open ERP. In this example, the user is 'yourusername', but you should replace this with your Arch system login username. First, log in as the default PostgreSQL superuser, 'postgres', by executing the following command from the CLI:

sudo su - postgres

Once logged in as postgres, begin the process of creating the 'yourusername' user, with the folowing command:

createuser yourusername -P

You will first be asked for a password. For highly secure yet easy to remember passwords, consider using a Diceware Passphrase. Re-enter the password as requested. The next three questions should be answered in sequence with n, y, and n. Shall the new role be a superuser? n Shall the new role be allowed to create database? y Shall the new role be allowed to create more new roles? n

Once you are finished answering these questions, type the word 'exit' to log out from PostgreSQL as the postgres superuser.

You may want to edit your /etc/rc.conf file by adding postgresql to the Daemons list, so that PostgreSQL will automatically start up when you boot up your computer.

This completes the installation and setup of PostgreSQL for use with Open ERP under Arch Linux. Additional detailed information about PostgreSQL configuration may be found on the Arch Wikipage for PostgreSQL, and the PostgreSQL Manuals webpage. Also, there is a powerful GUI PostgreSQL Admin tool, pgAdmin, which is available in the Arch repositories.

Installing Open ERP from AUR

Open ERP requires the installation of the Open ERP Server, and either the Open ERP GTK-Client or the Open ERP Web-Client. Currently, Open ERP is not available in the main repositories of Arch Linux, but it is available through the Arch User Repository. Open ERP requires Python 2.5, various libraries compiled with Python 2.5, and a few other dependencies not found in the Arch repositories. All of these packages are provided through AUR. The best tool for downloading, compiling, and installing AUR packages is yaourt. The following instructions assume that yaourt has been installed and configured on the user's system.

Open ERP GTK-Client

To install the Open ERP standalone GTK-based client, from the CLI, execute the following command:

yaourt -S openerp-client

Additional Open ERP Documentation

There are various sources of Open ERP documentation. The best place to start is the Open ERP Documentation webpage. This page links to different online documents, including detailed installation instructions. Additionally, there is an online copy of the book, "Open ERP for Retail and Industrial Management". This copy is also available as a PDF fileTemplate:Linkrot, and can be purchased in hardcopy form from Open ERPTemplate:Linkrot or from Amazon.com. While Open ERP documentation, such as "Open ERP for Retail and Industrial Management" is freely downloadable, it does not come with a free documentation license. Further details about this issue are found on the Open ERP websiteTemplate:Linkrot. Finally, Open ERP TV provides screencasts, some of which document various features and procedures of the software.

Open ERP Community

The Open ERP Community is centered upon the Open Object website. Free technical support for Open ERP may be found in the webforums, a mailing listTemplate:Linkrot which is linked to the webforums, an IRC channel on freenode.net, an Open ERP wiki, and the Official ERP Documentation webpage. The latest news may be found on Open ERP Planet, while various Open ERP screencasts are provided on Open ERP TV. Fee-based support services are provided by Open ERP PartnersTemplate:Linkrot.

Open Object RAD

Open Object is the Python-based Rapid Application Development framework for developing Open ERP modules. It allows developers and businesses to customize Open ERP for specific needs. Open Object RAD development work is centered upon the Open Object Launchpad page. Developer news and blogs are published on Open Object Planet. There are pages for software downloads, Open ERP module downloadsTemplate:Linkrot, and development source code downloads.