Difference between revisions of "ADempiere Debian Installer"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(ADempiere Debian Installer)
 
(Copied from Original Seed (http://globalqss.com/wiki/index.php/ADempiere_Debian_Installer))
Line 1: Line 1:
You can find information about the ADempiere Debian Installer at the link:
+
{{Breadcrumb|Table of Contents|Getting Started|next=Launching the ADempiere Application}}
 +
[[Category:User documentation]]
 +
[[Category:Documentation]]
 +
[[Category:Projects and Tools]]
 +
[[Category:HowTo]]
 +
[[Category:Installation]]
  
http://globalqss.com/wiki/index.php/ADempiere_Debian_Installer
 
  
''NOTE FROM THE AUTHOR: If you want to copy this page here, you must preserve the text as is (don't edit it, you're just allowed to add text at the end) and leave the three initial lines as a pointer to the original seed.''
+
= ADempiere Debian Installer =
 +
 
 +
== Notice about this article ==
 +
 
 +
Source (original seed): This page was copied from [http://globalqss.com/wiki/index.php/ADempiere_Debian_Installer GlobalQSS Wiki]
 +
 
 +
'''''NOTE FROM THE [http://www.adempiere.com/User:CarlosRuiz AUTHOR]:''' If you want to copy this page here, you must preserve the text as is (don't edit it, you're just allowed to add text at the end) and leave the three initial lines as a pointer to the [http://globalqss.com/wiki/index.php/ADempiere_Debian_Installer original seed].''
 +
 
 +
== Team ==
 +
 
 +
* Developer: [http://www.adempiere.com/User:CarlosRuiz Carlos Ruiz] - GlobalQSS
 +
 
 +
* Sponsor: [http://www.adempiere.com/User:Zeeshanhasan Zeeshan Hasan] - Sysnova
 +
 
 +
== Discussion / Support thread ==
 +
 
 +
http://sourceforge.net/projects/adempiere/forums/forum/610548/topic/3812128
 +
 
 +
== Goal ==
 +
 
 +
* Create an '''automatic''' installer for Debian based systems - tested on Ubuntu
 +
** Emphasis done in the word automatic - the intention is to ask the user the minimum variables required and do all the necessary steps to leave an Adempiere working
 +
 
 +
== Known Restrictions ==
 +
 
 +
* This installer just works if postgresql installed on the same machine (it uses direct connection to postgresql - unix sockets to avoid configuring and asking for a postgres password).
 +
* It requires to be run as root (this is usual with sudo dpkg)
 +
* Still not working with oracle - just postgresql
 +
 
 +
== How to install ==
 +
 
 +
* It DOES NOT require a graphical system - it can be used in servers
 +
* Prerequisites
 +
** Postgresql 8.4
 +
*** <code>sudo apt-get install postgresql-8.4</code>
 +
** Enable partner repository
 +
*** <code>sudo vi /etc/apt/sources.list</code>
 +
*** search and uncomment the line for the partner repository, i.e. for ubuntu 11.04 the line looks like:
 +
*** <code>deb http://archive.canonical.com/ubuntu natty partner</code>
 +
*** after that you must update the indexes
 +
*** <code>sudo apt-get update</code>
 +
** Sun Java JDK 1.6
 +
*** <code>sudo apt-get install sun-java6-jdk</code>
 +
* Download the Debian Installer
 +
** Installer for version maintained by GlobalQSS can be found at the link http://kenai.com/downloads/adempiere361/Adempiere_GlobalQSS_20111114_postgres.deb
 +
** ''Note the installer is not uploaded to the usual sourceforge file repository because an [http://www.adempiere.com/User:Nwessel abusive member of "Community" Council] revoked my permissions to publish files there, but they are fast to copy my work at globalqss361 project - you can find more info about this issue at http://sourceforge.net/projects/adempiere/forums/forum/610548/topic/4805536''
 +
* Execute the installer
 +
** <code>sudo dpkg -i Adempiere_GlobalQSS_20111114_postgres.deb</code>
 +
*** this step check the prerequisites, copy the needed files into /opt/Adempiere and /etc, create adempiere user and group and assign proper permissions to the files, at the end it displays a message to the user "You must run '/etc/init.d/adempiere configure' as the root user to configure the application."
 +
* Configure adempiere as root
 +
** <code>sudo /etc/init.d/adempiere configure</code>
 +
*** this step asks the minimum required user variables, fill them properly or just push enter to get the default in square brackets:
 +
*** <code>HTTP Port [8080]</code>
 +
*** <code>HTTPS Port [8443]</code>
 +
*** <code>adempiere db password</code> (this is mandatory)
 +
*** <code>check adempiere db password</code>
 +
*** <code>postgres password</code> - you can leave the password empty to use the direct connection from postgres user
 +
*** <code>start at boot [y]</code>
 +
** After this the JBoss configuration and deployment is executed (RUN_silentsetup), the import of the database is done (RUN_ImportAdempiere) and the service is installed to start on boot
 +
* To start the server you can reboot the machine or run:
 +
** <code>sudo /etc/init.d/adempiere start</code>
 +
 
 +
== Required changes on ADempiere code ==
 +
 
 +
http://kenai.com/projects/adempiere361/sources/adempiere361/revision/6148
 +
 
 +
== How to create the debian installer ==
 +
 
 +
=== Requirements ===
 +
 
 +
You need to have installed this software on your ubuntu:
 +
 
 +
* <code>tar</code>
 +
* <code>gzip</code>
 +
* <code>ar</code>
 +
 
 +
=== Steps ===
 +
 
 +
* You must create the Adempiere installer the usual way (RUN_build)
 +
* Uncompress the installer to $ADEMPIERE_HOME (preferably an empty folder)
 +
* Navigate to $ADEMPIERE_HOME/utils/unix
 +
* Run <code>createDEBpackage.sh</code> - on success it creates the debian installer file on /tmp folder

Revision as of 18:32, 15 November 2011

Table of Contents{{#if: Getting Started| | Getting Started }}{{#if: | | [[{{{3}}}]] }}{{#if: | | [[{{{4}}}]] }}{{#if: | | [[{{{5}}}]] }} | ADempiere Debian Installer{{#if: Launching the ADempiere Application| | Launching the ADempiere Application }} ⇒


ADempiere Debian Installer

Notice about this article

Source (original seed): This page was copied from GlobalQSS Wiki

NOTE FROM THE AUTHOR: If you want to copy this page here, you must preserve the text as is (don't edit it, you're just allowed to add text at the end) and leave the three initial lines as a pointer to the original seed.

Team

Discussion / Support thread

http://sourceforge.net/projects/adempiere/forums/forum/610548/topic/3812128

Goal

  • Create an automatic installer for Debian based systems - tested on Ubuntu
    • Emphasis done in the word automatic - the intention is to ask the user the minimum variables required and do all the necessary steps to leave an Adempiere working

Known Restrictions

  • This installer just works if postgresql installed on the same machine (it uses direct connection to postgresql - unix sockets to avoid configuring and asking for a postgres password).
  • It requires to be run as root (this is usual with sudo dpkg)
  • Still not working with oracle - just postgresql

How to install

  • It DOES NOT require a graphical system - it can be used in servers
  • Prerequisites
    • Postgresql 8.4
      • sudo apt-get install postgresql-8.4
    • Enable partner repository
      • sudo vi /etc/apt/sources.list
      • search and uncomment the line for the partner repository, i.e. for ubuntu 11.04 the line looks like:
      • deb http://archive.canonical.com/ubuntu natty partner
      • after that you must update the indexes
      • sudo apt-get update
    • Sun Java JDK 1.6
      • sudo apt-get install sun-java6-jdk
  • Download the Debian Installer
  • Execute the installer
    • sudo dpkg -i Adempiere_GlobalQSS_20111114_postgres.deb
      • this step check the prerequisites, copy the needed files into /opt/Adempiere and /etc, create adempiere user and group and assign proper permissions to the files, at the end it displays a message to the user "You must run '/etc/init.d/adempiere configure' as the root user to configure the application."
  • Configure adempiere as root
    • sudo /etc/init.d/adempiere configure
      • this step asks the minimum required user variables, fill them properly or just push enter to get the default in square brackets:
      • HTTP Port [8080]
      • HTTPS Port [8443]
      • adempiere db password (this is mandatory)
      • check adempiere db password
      • postgres password - you can leave the password empty to use the direct connection from postgres user
      • start at boot [y]
    • After this the JBoss configuration and deployment is executed (RUN_silentsetup), the import of the database is done (RUN_ImportAdempiere) and the service is installed to start on boot
  • To start the server you can reboot the machine or run:
    • sudo /etc/init.d/adempiere start

Required changes on ADempiere code

http://kenai.com/projects/adempiere361/sources/adempiere361/revision/6148

How to create the debian installer

Requirements

You need to have installed this software on your ubuntu:

  • tar
  • gzip
  • ar

Steps

  • You must create the Adempiere installer the usual way (RUN_build)
  • Uncompress the installer to $ADEMPIERE_HOME (preferably an empty folder)
  • Navigate to $ADEMPIERE_HOME/utils/unix
  • Run createDEBpackage.sh - on success it creates the debian installer file on /tmp folder