010 Initial Client Setup
For every ADempiere implementation, we must first define the Client, Organization, Users, etc. These are the initial parameter for the system.
Let’s look at the definition for each terms above:
- Client is the highest level of an independent business entity. It’s like a tenant who rent your building (the ADempiere system). So, in one ADempiere implementation you could have one or more Client.
- Each Client may have one or more Organizations reporting to it.
- Each Client defines the accounting parameters (Acconting Schema, Tree Definition, Non Monetary Unit of Measure/ UOM, etc)
- Each Client may have more than one Users account
At the first time of the implementation, ADempiere provides you two default Clients, System Client and Garden Client.
System Client is used to create other Clients, and Garden Client is for evaluating purpose, which already contains some sample data of Business Partners, Products, Users, accounting parameters, etc.
Starting the Implementation
Start the ADempiere client program which will show up a dialog box like this:
The dialog will show GardenAdmin User ID at the beginning. We must change it to System (note the case) and use the password System for it. Click Ok button. A dialog like this will show up:
Please note that the Role is System Administrator and the Client is System. Click Ok button. Next the ADempire main menu will show up like this.
On the menu, browse the tree menu to System Admin – Client Rules – Initial Client Setup to open the Initial Client Setup Form like this:
You must fill the fields with your datas. The fields that we need to fill are:
- Client: is the name of your company name or other company that we are going to setup, for example Dijexi.
- Organization: is often a legal entity or sub-unit for which documents and transactions are processed. By example, we filled with Head Quarter (HQ), and you may define others organization in a later time. Often, in small companies the Client and the Organization are the same.
- User/Contact Client and User/Contact Organization are the initial users that will be enabled to login into the system, in this example: dijexiAdmin and dijexiUser.
- Leave the Business Partner and the Product checkboxes checked and the others unchecked. Those selection will be used to define the Accounting Schema. Afterwards, if you want, you can change these settings, for example to add Sales Region, Projects, etc.
Please, note the Ok button is still disabled. Before you can continue, you must select the Load Accounting Values Format button to load the sample chart of account data.
Select a comma separated file, for example we will use AccountingUS.csv which is a US sample of Chart of Accounts (COA).
You can define your own COA based on that sample and load that instead. The COA is required by ADempiere for its Financial Integration operations. After that, the Ok button will be enabled and now the path to the accounts file is displayed with your choosed. Press the Ok button to continue…
and wait for the process to finish, it will take several minutes depending on your computer specifications.
When it finished, then a new window is opened like this:
which show you the Users, Roles and all the standard entities that were created. Click the Ok button, your Client initialization setup is complete.
Re-Check the Client Setup
Next thing you should do is to check the Client setup that you have just done before. To do this, logout from the system now. Then log in again but this time with your client-level Role you have just created (dijexiAdmin in the example).
The initial password to your client-level Role is same as your client-level role name.
Click Ok button.
Then make sure that you are able to login and see the ADempiere main menu like this.
Very good! (a.k.a Mantabb! )
Then we’ll go to the Initial Client Setup Review workflow to continue.
Akhmad Daniel Sembiring
vITraining.com – Qualified IT Products, Outsourcing, and Services
Ligarwangi.com – Linux, E-book, Coffee, Gift, etc



Thanks for all details here. They are very helpful.
-ric
Thanks ric for visiting.
very good