ADEMPIERE SUPER1S

January 1, 2011

COPYLEFT 1.1.11
Redhuan D. Oon
THIS MANUAL GUIDE
IS ENCLOSED IN THE
INSTALLER. NOT TO
BE USED OUTSIDE
THIS GALAXY.
YOUR WINDOWS
INSTALLER CAN BE
DOWNLOADED
FREELY FROM
www.adempiere.com

THE IMAGE on the

right is from the book
cover of Open Source
ERP written by the
author, sold on
Amazon.com

This New Year 1.1.11 brings magic

Get your free ERP running in 15 mins!
By Redhuan D. Oon
Today, the best free, top class ERP
in the world combines with the
familiarity and ease of a Microsoft
Windows environment allows you
an unforbidden indulgence.
ADempiere works out of the
box via this super-installer created
entirely from Free and Open
Source software.
But free software is useless
without its priceless contributors.
Kai Schaeffer (see next page)
constructed this installer based on
NSIS (nullsoft) in 2009. Today the
installer is upgraded to the latest
version as of January 1st, 2011.
It has the latest source-code
compiled and its migration scripts
applied to give you the latest up-
to-date version, with no 3rd party
licensing restriction barriers.
Your ADempiere once
installed via this installer shall have
a brand new 2011 financial
calendar setup with all its periods
opened so that you can try out the
GardenWorld sample without
hassle.
ADempiere is a proven global
highly customisable and localised
to more than 30 locales around
the world by a growing number of
end-users, system integrators and
big corporations. Yes, it is the
other way round and from the
ground up. Since born of a fork
from Compiere in September of
2006, it has not looked back since,
even though its parent, Compiere
has been sold off by its original
owner and considered closed and
no longer a full fledge FOSS
project.
Right now and here, in front
of your Windows PC, you can
within a few simple clicks and 15
minutes (for a reasonably latest
PC) turn it into a powerful ERP
machine both for your
organisational and business needs.
It has both the powerful Java
client and the web-based Ajax
interface to answer your
performance scalability future
needs. You are indeed joining a
globally growing number of
demanding but satisfied users.

1 Copyleft 1.1.11 Redhuan D. Oon

 Java 6, Postgres 8.3, ADempiere
ADEMPIERE SUPER1S January 1, 2011

360LTS, OSGi and more!

Tested to work right away
The project latest code and database content
upgrade as of January 1st, 2011 is incorporated into
this installer package.
This MS Windows installer has been farm-tested to
work even on normal home PCs to get Java 6,
PostgreSQL 8.3 and ADempiere to be up and
running within a matter of minutes. And we won’t
stop there but jump onto the OSGI boat.
For now, we describe what this manual or guide
seeks to do for you within a single seating. All you
need is just this installer and the OSGI_client_db.zip
from the SourceForge.net project Files Download
section.
With the installer executed, you will have a fully
working ADempiere ERP/CRM/POS system
working with a test client called GardenWorld. You
can if you want, proceed to upgrade to the trial
version of ADempiere-OSGI.
There will also be instructions on how to revert
back to the ADempiere 360LTS version when you
choose to.
Can this ADempiere 360LTS be used in
production? The answer is many thousands of users
worldwide are already using it or variants of it.
You shall be the lucky new ones. This package
not only has the 360LTS version but its latest code
and DB change upgrade. For more information
about what is new, visit the SourceForge project
THIS ADEMPIERE NEW YEAR GUIDE
introduces you to the latest Free ERP,
how to get it up and running and then
upgrade to ADempiere-OSGI. It is
amazing that all this can be done within
one seating. This guide can tell you how
in precise details. For the reason that
the author himself successfully
reviewed and help upgrade both works
and produced them as downloadable
packages online.
trackers and logs or read up the wiki pages in
www.adempiere.com.
What about the OSGI variant? The answer is
its main architect maintainer and developer, Low
Heng Sin is due to announce it as beta with its own
installer in the coming days. For now, this guide
shows to those who are too eager or impatient that
you can have a formidable and well working OSGI
variant which has more cool features to play with.
For a start the OSGI variant can export any
table as a package to be imported by another
ADempiere-OSGI in an easy to remember intuitive
process. It also has a UUID system installed in its
Database. UUID or Universal Unique
IDentification allows multiple instances to talk to
each other without conflicting or overlapping IDs.

KAI SCHAEFFER
Kai is one of the
important contributors
from Berlin, Germany.
He started by
sponsoring ADempiere
very first physical
conference there,
inviting and paying for
the top names of the
project at that time to
meet in a single room.
Prior to that, his
private company
SCHAEFFER AG has
started to use
ADempiere and made
notable contribution,
via one employee,
Karsten Thiemann with
the migration code.
Kai eventually put his
own C skills to work
resulting in the 342
Installer.
Today he sits as the
Chair of ADempiere
e.V, a non-profit body.

2 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011
The 360LTS Release
Laura Edition, born CARLOS ANTONIO RUIZ
June 4th, 2010 GÓMEZ
Has been with the ADempiere project
The
project
trunk
at
SourceForge.net
is
 since inception on 1st September,
a
living,
dynamic,
ongoing
community
 2006.
project.
Its
codebase
never
stops

breathing
even
after
each
official
 As a matter of fact, Carlos first
release. suggested to the project its name to
reflect its history with Compiere
Since
the
Laura
Edition,
the
trunk

which is now sold and closed.
has
attracted
developers
and
users
to

His immense contribution is
review
it
with
upkeeping
done
through
 spread wide and deep into the
an
elaborate
and
accurate
process
of
 codebase, helping in stability and
quality
assurance.
It
is
heavily
tested
all
 backward compatibility. All the
over
the
world
where
bug
and
remedy
 major releases has been captained
patches
are
posted
into
serialised
 by Carlos up to the latest Laura
trackers
for
constant
reference
in
the
 Edition.
project. Carlos Ruiz stays in Colombia
The
subversioning
system
or
SVN
 and actively maintains the Spanish
provided
free
by
SourceForge.net
has
 and Taxation sub-projects, besides
working on the next best release.
30
mirrors
all
over
the
world
to
give

code-on-demand
facility
for
the

worldwide
team
to
work
round-the-clock.
through
its
ADempiere
Best
Practices
 the
maximum.
It
is
a
community-based

Users
particularly
newbies
are

charter.
Furthermore
been
open
in
the
 Open
Source
Software
project
that
is

encouraged
to
submit
bug
reports
into
the

Web
does
not
give
the
project
any
option
 more
conducive
as
compared
to
other

trackers
so
that
they
can
be
monitored

of
restricting
anyone
effectively.
That
is
 commercial-based
Open
Source

and
qualified
by
the
global
volunteer

why
we
also
can
find
poisonous
 Software.
team.
The
participation
process
is
very

behaviour
happening
which
is
left
to
the
 For
example
with
great
contributions

open
where
anyone
with
the
right
skills

wisdom
of
the
majority
to
resolve.
And
 already
made
elsewhere
and
made

and
tools
can
just
go
ahead
to
reply
the

they
usually
do. available
in
the
project,
the
author
could

trackers
with
their
own
solutions
or

There
is
a
saying
among
the
 just
add
onto
the

Kai’s
Windows
Installer

findings.
developers
there,
that
we
make
releases
 which
is
version
342,
and
modify
it

All
this
processes
take
place
in
the

almost
everyday,
where
each
release
can
 further.
The
author
chose
to
upgrade
the

Internet
without
the
interference
of
a

be
checked
out
and
compiled
error
free. trunk
changes
right
into
the
installer
thus

contral
command
head-quarters
or

This
is
due
to
the
marvelous
tools
 making
it
somewhat
a
post-Laura
Edition. 

bureauracy.
The
Project
Management

such
as
Eclipse,
Hudson
build
server
and
 Effectively
everything
you
find
in
the
trunk 

Team
(PMC)
or
Community
Council
is

SourceForge
facilities
getting
exploited
to
 as
of
New
Year
2011
is
in
it.
very
lenient
and
constantly
guide
users

According to Norbert Wessel,
Who is Laura? ADempiere in Germany lives with the
She is the baby of domination of SAP as a global brand
Tobias Schöneberg (and head-quartered in the same country. He
wife) born around the feels that there is a symbiotic co-existence
time of 360LTS release. of the two, while most German
corporations can afford the expensive
He works for METAS GmBH which SAP, they lacked the deeper
is a leading German localisation customization, versatility and faster
contributor and board member of the maintainance of a good, free and open
ADempiere e.V. ERP.
It is led by the American Metas has actively promotes more
background Germans of Norbert Wessel, users and participators. They are making
Tobias is known by his online handler of Tobi42. and Mark Ostermann, with a newly ADempiere more relevant with better
Why 42? Well that is from the story in the incorporated Romanian branch led by
Hitchhiker’s Guide to the Galaxy. Here seen in refactoring done particularly for the
Metas office, in Bonn, when the author visited Teo Sarca and Christina Ghita. German Localisation engine.
them in June 2009.

3 Copyleft 1.1.11 Redhuan D. Oon

 Getting the ADempiereSuper1s
ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
Go right to Step 9 if you already have the ADempiere1111.exe installer.
1. Login into the Internet
2. Go to the website http://www.adempiere.com

SCREEN BY SCREEN
3. On the bottom right of the screen below the Installer package box
4. Click on the Windows Installer link
http://www.adempiere.com/index.php/Windows_Installer
5. Then click on the Download link
https://sourceforge.net/projects/adempiere/files/WindowsInstaller/

4 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
6. Click on the Download ADempiereSuper1s link

SCREEN BY SCREEN
7. Save the package into your default location
8. Unzip it to your desktop to find a file called ADempiere1111.exe

ADempiere1111.exe

5 Copyleft 1.1.11 Redhuan D. Oon

 ADempiere1111.exe
ADEMPIERE SUPER1S January 1, 2011

Windows-based and fully automated

Here I described in general what you If
it
is
Postgres
of
version
8.3
and
later,
the

should do. If you need to follow the step installer
will
accept
and
use
it.
by step, screen to screen guide then
The
only
necessary
input
during
the

proceed to the next page.
installation
is
the
password
and
you
should
use

The
ADempiere1111.exe
from
the

‘adempiere’
as
a
start.
At
least
until
you
are

ADempiereInstaller1111.zip
package
you

familiar
with
the
ERP
usage,
you
can
change

downloaded
or
received
through
other
means

the
password
later.
contains
a
fully
automated
installer
that
can

If
you
detect
any
issue
during
an

only
run
on
Microsoft
Windows.
It
is
a

installation,
you
can
easily
recover
from
it
by

compressed
size
of
280
Mbytes
and
will

uninstalling
the
hung
Java
or
PG
or
ADempiere

expand
to
above
1
gigabytes
in
total
when
fully

and
running
the
installer
again.
If
you
uninstall

operational.
any
portion,
make
sure
you
delete
the

It
is
best
if
your
PC
is
not
used
for
other

concerned
folder
and
its
contents.
important
applications
so
as
not
to
disrupt

Many
have
used
this
installer
successfully

either
one
in
use.
Ensure
also
that
you
have

without
any
background
experience
in

admin
rights
to
the
PC
before
starting.
ADempiere
nor
Java.
It
should
have
about
5
gigabytes
of

During
the
installation
the
dialog
box
will

diskspace
(though
it
can
work
with
less)
and
of

prompt
its
status
and
logging
lines.
You
can

at
least
1
gigabytes
RAM
or
memory,
preferably

then
follow
what
is
happening.
If
the
installation

2.
The
diskspace
should
be
of
its
own
partition

is
successful,
at
the
end,
an
ADempiere
icon

for
example
in
Drive
D,
even
though
it
can
still

with
a
shortcut
will
appear
on
your
Desktop

work
within
a
single
Drive
C.
screen.
Ok
once
you
are
ready
we
may
start.
It
is

Double-click
on
the
icon
and
the

best
to
right
click
on
the
ADempiere1111.exe

ADempiere
splash
screen
shall
appear
in
the

installer
and
select
‘Run
as
administrator
in

middle
of
the
desktop.
Within
a
few
seconds
the

order
to
ensure
the
Windows
admin
restriction

login
box
will
appear
for
your
acceptance.
The

does
not
block
the
installer
from
doing
its
work.
User/Password
is
often
defaulted
to
either

When
the
installer
is
in
full
swing,
it
disallow

SuperUser/System
or
GardernAdmin/
cancellation
until
it
has
gone
through
the
whole

GardenAdmin.
process.
It
can
be
as
quick
as
15
minutes.
If
it
detects
a
database
connection
error,
click

If
your
PC
already
has
a
competing
Java
6,

on
the
DB
connection
icon
and
check
if
your
DB

then
it
will
be
detected
and
the
installer
will
set

host
and
name
is
correct.
Usually
they
are

the
JAVA_HOME
properties
to
yours
without

‘localhost’
and
‘adempiere’
respectfully.
you
doing
a
thing.
Likewise
for
your
Database.


6 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011
SCREEN BY SCREEN
9. Right click on the icon
10. Select Run as administrator

ADempiere1111.exe

SCREEN BY SCREEN
11. The image below may appear to verify if the file is intact and not broken
12. Then you select your preferred language during installation. I cover many languages I
hope to speak in.

7 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
13. The above by right should be called ADempiere SUPER1s Wizard. Just click on Next
14. You will be asked to accept the locations of the 3 packages within
15. It is advisable to follow what I am filling in below. Press Next again
16. Ensure the sound speakers are on and at full blast or it won’t work that well

8 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
17. Now it is starts by installing Java 6 SDK first. If it reaches the next screen you are in luck.
18. You don’t have to do anything from here on
19. The Back, Close and Cancel buttons have been disabled to make sure of that
20. Just listen to the song in the background and stare at our picture
21. The song is an original composed by me with Toki of Malaysia and Mellow Mark of
Germany. It is also copyleft and free to download from www.red1.org

9 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
22. Then it will proceed to the PostgreSQL 8.3 installation
23. Another window will pop up as shown above
24. By now you will have been listening till the end of the song
25. When it finishes it will start extracting the ADempiere package.
26. You would have listened to the song for the second time

10 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
27. ADempiere will began its building of the jars and signs the papers
28. When you see the percentile reaching 773 don’t panic.
29. No, you are not going nuts. It has nothing to do with the song.
30. Do not turn off the speakers. It will abort the process.

11 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
31. By the 3rd repeat of the song, you should see the above Importing Database prompts
32. Not long now.
33. By the time the song begins its 5th round you should see the screen below
34. No, you are not dreaming. The close button can work now. Press it and the agony, i
mean the song will end.

12 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
35. You can notice the 3 installed packages from your Control Panel above
36. Find the launch icon on the desktop and double click it
37. The login box will appear.
38. You can now sell the SAP guy in your office on eBay.

LET’S RECAP WHAT JUST HAPPENED. YOU HAVE SUCCESFULLY INSTALLED

JAVA 6, POSTGRESQL 8.3 AND THE SUPER1s, WHICH IS ADEMPIERE 360LTS
WITH THE LATEST TRUNK CHANGES AS OF JANUARY 1ST., 2011. YOU HAVE
NOT DOWNLOADED NOR INSTALLED THE OSGi VERSION YET. YOU PROBABLY
WANT MORE MUSIC TO THE EARS. BEFORE THAT, LET’S PLAY AROUND WITH
THIS NEW ADEMPIERE

13 Copyleft 1.1.11 Redhuan D. Oon

 Launching ADempiere
ADEMPIERE SUPER1S January 1, 2011

Automating your operations

Today, ADempiere is not only very It
has
a
webstore
interface
that
is
simple

tough, with many bugs that commonly HTML
based
for
easy
modifications
by
anyone

plaqued the earlier Compiere project
later.
gone, but it is growing in all directions.
ADempiere
can
also
run
on
Oracle
or

MySQL
(whats
the
difference?
They
now
have


After
four
good
years
of
the
ADempiere
 a
single
parent
with
no
mums)
which
means

bazaar,
the
sourcecode
has
undergone
alot
of
 you
can
plan
a
resource
team
that
has
suitable

refactoring,
completion
of
unfinished
features
 and
compatible
skill-sets
to
work
and
maintain

and
enjoying
a
glowing
growing
community
 it.
worldwide
stretching
from
Brazil
in
Latin
 The
power
of
the
Application
Dictionary
to

America
to
England,
to
Japan
and
Indonesia,
 configure
your
whole
look
and
feel
starting
from

probably
every
country
in
the
world.
The
only
 the
Menu
panel
lifts
a
big
burden
from
your

locale
that
I
personally
did
not
come
across
are
 technical
people
as
now
even
simple
clerks
can

the
Koreans.
Both
North
and
South.
My
last
 do
configuration
changes.
year’s
personal
letter
to
Kim-dashians
of
the
 Finally
the
output
part
is
thrown
wide
open.

communistic
north
remains
unreplied. You
can
export
your
data
and
files
in
Excel,

With
ADempiere,
you
can
import
your
 PDF,
HTML,
XML
and
the
now
powerful
2Pack.
legacy
documents
and
system
via
the
Import
 2Pack
which
came
from
a
long
line
of

Loaders.
Then
you
can
tune
a
typical
role
 mothers
starting
with
Marco
Lombardo
from

access
account
for
your
users
to
work
on
 Italy
to
Trifon
from
Bugaria,
Carlos
Ruiz,
Robert

specific
functions
of
the
ERP.
Typical
ones
will
 Klein
of
USA,
is
now
refactored
by
Low
Heng

be
Sales
Order
taking,
processing
into
 Sin.
Shipments
and
Invoice
Settlement
(via
 You
can
export
out
a
whole
module
by

Allocation
Payment). selecting
its
Menu
item
and
all
its
cascading

You
can
use
the
attractive
POS
window
 Windows,
sub
windows,
tables
and
fields
and

that
can
work
with
touchscreen
displays
and
 its
associated
references
and
dynamic

barcode
scanners
and
of
course
the
cash
 validators
get
thrown
into
a
single
package.

drawers. Then
you
can
reimport
that
package
in
another

This
ERP
has
zoom
through
one
click
 place
using
ADempiere.
That
goes
for
data
too.

buttons
where
you
can
trace
matching
 But
there
was
an
issue
of
conflict
of
IDs.
With

documents
without
thinking
where
you
kept
 the
OSGi
version
that
conflict
is
resolved.
Now

them.
You
can
view
the
performance
of
your
 you
can
merge
multiple
remote
instances
of

customers
or
suppliers
(that
will
be
your
 ADempiere
that
has
different
record
basis

performance
in
paying
out)
in
a
single
display
of
 without
worrying
of
IDs
conflicting.
all
the
associated
orders,
receipts
or
shipments,
 True
automation
on
a
global
scale
has

and
their
aging
analysis.
 finally
arrived.
Let’s
unleash
this
power
of

ADempiere
is
also
a
pretty
good
CRM
with
 freedom
now.
trouble-ticketing
and
integraton
via
email
to

send
out
to
concerned
parties.

14 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
1. Continue from the login box, click on the connection icon on its top left, and the above
shall appear
2. Check that your DB Host and Name are correct
3. Click on the Test Database
4. If it shows a green sign as above, then it is the Oracle guy’s turn to leave
5. You can select the Role: GardenWorld Admin

15 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
6. You will see the above with its KPI Dashboard, which are all configurable
7. For your convenience, I have activated calendar 2011’s periods and made some POS
sales with its Accounts Posting set to Queue.
8. Click on the Menu tab and select Sales Order
9. Click on the Search button as shown below. Accept OK to get all records. A POS order
80004 i made will appear.
10. Click on its Zoom Across button
11. Select Invoice Customer

9
10

16 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
12. Note the Invoice window where its Posting Status shows Not Posted
13. Click on it, and it shall show Posted.
14. Click on it again and it will pop up the accounts posting below.
15. You can ask the Accounts clerk to leave. Unless she is not really hired for accounting.

CHECK IT OUT
You can also go to the File item on the top menu bar of the Invoice and try to Export it. You
will notice that there is only one Excel type for you to select. Take note of that for the next
exercise.

17 Copyleft 1.1.11 Redhuan D. Oon

 ADempiere on OSGi
ADEMPIERE SUPER1S January 1, 2011

The power of open bundles is here

Now we begin to go further than any Some
of
us
liked
the
idea
and
so
again
the

other ERP Software has even dreamt of power
of
the
far
flinging
bazaar
comes
into
play.

doing. We tap into the power of loose
Starting
from
a
small
but
pioneering
effort
by

coupling and componentisation of
Andreas
Schmidt
of
Hungary
trying
to
use
the

OSGi. Whatever that means.
Felix
flavour
of
OSGi,
it
was
tried
out
in
Equinox

OSGi
stands
for
Open
Standards
Gateway
 by
Joerg
Viola
of

Germany
and
later
taken
up

Initiative
or
Interface
or
Inception
(I
am
not
sure
 very
seriously
by
Low
Heng
Sin,
our
highly

now.) experienced
Java
architect
from
Kuala
Lumpur,

Whatever
it
is,
is
not
important.
What
it
 Malaysia.
promises,
is.
For
a
long
time
we
in
the
 It
is
now
quite
ready
for
action
and
I
have

ADempiere
project
worry
over
many
things.
No,
 quite
thoroughly
tested
it
myself
without
finding
a

not
about
who
to
eat
for
breakfast,
but
what
to
 reason
to
hate
it.
do
when
we
have
too
many
components
and
 I
have
documented
all
the
things
you
can
do

add-ons
from
the
business
world.
How
would
we
 with
it
in
our
wiki.
Please
read
it
and
its

integrate
all
of
them?
What
if
we
have
to
remove
 underlying
links
at
http://www.adempiere.com/
some
of
them
in
order
for
others
that
get
in
the
 index.php/OSGI_HengSin.



way?
The
answer,
for
now,
seems
to
be
from
a
 For
now,
here,
I
will
show
you
how
to
get
the

full
blown
IBM
initiative
called
the
Equinox
OSGi
 OSGi
power
into
your
freshly
baked
ADempiere

project.
It
is
how
the
Ecilpse
IDE
is
based
on
 instance.
Again
we
shall
go
screen
by
screen
to

today.
It
is
an
idea
of
a
framework
made
for
any
 demonstrate
not
only
it
is
working
well
but
how

application
but
no
application
in
particular. easy
is
it
to
switch
to
it.
(Caveat
been
if
you
are

a
new
instance.
For
legacy
old
Compiere/
ADempiere
there
needs
to
be
a
special

migration
effort).
The
important
use
of
OSGi
is
that
future

components
can
be
built
according
to
more

standard
interfacing
and
the
bundles
or

components
within
the
application
has
a
chance

to
breathe
better.
They
won’t
be
coupled
tightly

within
the
codings.
They
can
be
separated
and

talk
via
specific
imports
of
other
plugins
(another

name
to
call
such
bundles
in
the
OSGi
world).

Decoupling
is
easy
and
maintenance
thus

should
be
lower
and
clear-cut.
LOW HENG SIN is the informal master
architect today of the ADempire project, This
maintenance
of
expansion
and
coupling

having masterminded its proper porting from with
more
plugins
as
an
ERP
progresses
is
the

Oracle to PostgreSQL, from HTML to Ajax UI
and now the OSGi adoption. He is only 20 main
motivation
of
starting
early
rather
than
late

minutes away from my farm home and a very on
OSGi.
Now
you
have
a
chance
to
do
just
that

nice person but dead serious about quality. and
I
advice
you
do
that.
No,
you
do
not
have
to

listten
to
the
song
ever
again.
You
done
well.

18 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
1. Go to the Files link of http://sf.net/projects/adempiere
2. Find the OSGI folder and download only OSGI_client_db.zip (has both adempiere-
client.zip and ExpDatOSGI.zip), Africa.zip and AfricaData.zip
3. Unzip into one of your drives as shown below (note i did have the adempiere-server.zip
but I won’t be showing anything on it for this guide.)

SCREEN BY SCREEN
4. Get all the zipped files unzipped.
5. The OSGI DB (ExpDatOSGIv2.jar) has to be unjar with a DOS command:
6. jar -xvf ExpDatOSGIv2.jar
7. It will unjar as ExpDat.dmp
8. Ctrl-C on it to copy it

19 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011
SCREEN BY SCREEN
9. Go to the location of your earlier ADempiere Home and go to its Data folder
10. Note that there is already an ExpDat.dmp in there. Rename it to ExpDat1111.dmp
11. Put your copied file into the same folder
12. It will now looked like in the screen below. Remember this step to revert back later.

SCREEN BY SCREEN
15. Go to the utils folder
16. Look for RUN_DBRestore batch file
17. Double-click on it to launch it. It will now import from your OSGI DB (ExpDat.dmp)
18. NOTE: You must shut down any ADempiere instance before restoring

20 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
19. You are already set to go! Go into the earlier adempiere-client folder
20. You will find adempiere-client batch file shown above. Double click to launch it.
21. While the DOS prompt window is opening, quickly click into it and type ss, press ENTER
22. You will see the bundles display. Congratulations! Your ADempiere is now all plugins.

21 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

SCREEN BY SCREEN
23. You will find the ADempiere launched and all seem the same. It is a good sign really. As a
matter of fact most of the functionals and features are backward compatible.
24. But there are some enhancements with OSGi version.
25. Go to the Sales Order window again and you see that the former SO is gone to confirm
you did restore another ExpDat.dmp.
26. Click on the File>Export button we talked about earlier.
27. You will notice you can export the records as a 2Pack format.
28. You can try it out from the guide given here http://www.adempiere.com/index.php/
OSGI_HengSin/File2PackZip

22 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011 SCREEN BY SCREEN
29. Now we will import the externally packed package called Africa.zip and its data to see
how well the newly refactored 2Pack is working.
30. At the menu look for PackIn and click on it.
31. You will see the screen below. Browse for your Africa.zip as the Package Source
32. Package Directory can be anywhere to save the Package log for rollback when needed

SCREEN BY SCREEN
33. You will notice the
status at the bottom
of the screen shows
successful Processed
34. You can check in the
Package
Maintenance window
on the right to see the
objects imported
35. Now we return to the
above again this time
to PackIn
AfricaData.zip
36. Upon success relogin
as GardenAdmin, see
the new Menu called
Afrikiya as seen on
the next page.

23 Copyleft 1.1.11 Redhuan D. Oon

 SCREEN BY SCREEN
34. What you have now is a completely new Menu Module with sub-windows and tables
35. Open the Schedule window to see the AfricaData details. Note the Origin and
Destination fields.
36. Now go to the Booking window and create a new record and select an Origin and then a
Destination. Note how they are been dynamically validated. This shows that such
properties are easily migrated from another instance.
37. Also note that the lower row of Origin and Destination gets populated. This is due to an
earlier Rule which i already tested and migrated into this ExpDat.
38. This Rule handling is something I enhanced easily from the OSGI project. See http://
www.adempiere.com/index.php/2Pack/RuleElementHandler

LET’S RECAP AGAIN. NOW, YOU GOT THE ADEMPIERE-OSGI VERSION

RUNNING. YOU CAN LATER REVERT BACK TO THE SUPER1S VERSION BY
BACKTRACKING TO PAGE 20 AND RENAMING THE EXPDAT.DMP TO
EXPDATOSGI.DMP AND THE EXPDAT1111.DMP TO EXPDAT.DMP. THEN
RUN_DBRESTORE.BAT. ANYWAY EITHER VERSIONS ARE AMAZING. WDYT?

24 Copyleft 1.1.11 Redhuan D. Oon

ADEMPIERE SUPER1S January 1, 2011

OTHER ENHANCEMENTS FROM OSGI VERSION

39. Above you can see the 2Pack xml is more cleanly arranged and utilises UUID. Note the
corresponding <AD_Menu_UU> and <Parent_IF reference=”uuid” .. > tags
40. Below is one workflow display that is more UML like done in the OSGi version

25 Copyleft 1.1.11 Redhuan D. Oon


ADEMPIERE SUPER1S January 1, 2011
I often lazed, I mean worked from my farm home, with monkeys running noisily on my roof
top. I worked mostly on local and foreign projects. I particularly love to work with
Universities and Colleges because building the next generation is my passion. Learning to
compose music is a backup plan.
26
Copyleft 1.1.11 Redhuan D. Oon
What if you want to go live with
this baby?
Now that you have fired the SAP and
Oracle guys.
The real challenge of an ERP is not in the software
but in its people implementing it. That means no matter
how fantastic ADempiere is, it is not the song anymore. In
fact all well known ERP software are good.
92% of ERP implementations failed due to the poor
planning of its human resources doing the
Where do we go from here?
Presently, the OSGi is awaiting its own fuller set of
installer, and I am planning to do a Windows installer for it
also in due time. The community is in discussion when to
bring out the OSGi as a main release for the trunk. There
are also many other branch projects such as from
eEVolution and Adaxa particularly the Libero
Manufacturing and new Cost Engine.
The path between ADempiere to its OSGi cousin is
not just a technical one, as what is more important is the
full participation of the global community in using and
giving feedback of what works and what does not.
This is the main reason why some of us pay alot of
attention to documentation and uploading it freely. Much
implementation. Many projects do not hire and keep the
right skill-sets with the right and long experience needed
for a successful and surefire implementation. So do not
depend on the software too much but look at whether that
software has its own expertise to back it up. (That means
you can recall back your SAP and Oracle guys).
There are experienced ADempiere community
members worldwide which you can check out easily online
to assist you either for consulting, skills-transfer, coaching,
outsourcing or hand-holding. Be sure to plan it out in
small bites before going for the bigger bang.
of our work is not paid for directly but often Karma has its
own way of paying us back, and I enjoy the mystery of life
where Providence always find its way in ingenious fashion.
As promised.
I sincerely hope our humble work together with all
those great contributors in our community does help bring
more meaning to the masses and productivity among
poorer nations’ industry and automation. I can think of
reasons ranging from ‘trying to change the world’ to
‘saving the world from excessive carbon emission’ rather
than trying to merely see food on the table. If anything,
what is truly a reward to me is to see ADempiere been
used freely and effectively. That I think will make a world
worthy enough to live in. Meanwhile I look forward to
more amazing participation and surprises.
INFORMATION IS FREE, PEOPLE
ARE NOT, CONTRIBUTORS ARE
PRICELESS
More often than not, Free Software seems the
Holy Grail but not entirely true
Most people approach FOSS with open
arms and fingers but to download and not
upload back. By doing so, they are not
learning it the way it should be. Today
university grads in ICT or software
engineering fields are not finding it easy
taking in theory without the practice. By
involving in Open Source particularly ERP
such as ADempiere will throw a whole new
world of practice steep in actual community
and real world problems to solve. I would
easily hire a person from the community
rather from the cut-paste resumes i often find
strewn on JobStreet.com.