ADempiere Debian Installer - Revision history

CarlosRuiz: reformat

2014-04-16T17:46:08Z

reformat

CarlosRuiz: IMPORTANT NOTE FROM THE AUTHOR OF THIS PAGE

2011-11-15T03:32:07Z

IMPORTANT NOTE FROM THE AUTHOR OF THIS PAGE

CarlosRuiz: ADempiere Debian Installer

2011-11-15T03:26:56Z

ADempiere Debian Installer

New page

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

← Older revision		Revision as of 03:32, 15 November 2011
Line 1:		Line 1:
		+	''NOTE FROM THE AUTHOR: If you want to copy this page to any other wiki (including Adempiere wiki), you must preserve the text as is here (don't edit it, you're just allowed to add text at the end) and leave a pointer to this page as the original seed.''
		+
	== Team ==		== Team ==

@@ Line 38: / Line 38: @@
 * 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
 * Execute the installer
 ** <code>sudo dpkg -i Adempiere_GlobalQSS_20111114_postgres.deb</code>
@@ Line 54: / Line 53: @@
 * To start the server you can reboot the machine or run:
 ** <code>sudo /etc/init.d/adempiere start</code>
 == Required changes on ADempiere code ==