ERP Academy iDempiere Release 20201004

• Date: October 04, 2020
• iDempiere Version: 7.1
• Ubuntu: 20.04

Development Environment (and Server)

To help you (a) play with iDempiere, (b) develop plugins and (c) better understand the application, I maintain a VirtualBox iDempiere instance and development environment. You can download the below file and follow the below directions/details to get an iDempiere instance and development environment up and running much more quickly.

• VirtualBox iDempiere Development Environment VDI Image ~8GB (main checksum)
• Verify download using:
  • md5sum -c vbox_id_71_ubuntu20_devenv_20200930.tar.gz.md5
• For those is a slow internet connection, you can download the file in pieces:
  • Create a new directory for the below files pieces.
    • mkdir -p download_iDempiere; cd download_iDempiere
  • copy and paste the following into your linux terminal:
    • VBoxFile=vbox_id_71_ubuntu20_devenv_20200930;
      wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.split.md5; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitaa; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitab; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitac; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitad; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitae; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitaf; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitag; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitah; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitai; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitaj; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitak; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splital; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitam; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitan; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitao; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitap; wget https://s3.amazonaws.com/ChuckBoecking/install/vbox_id_71_ubuntu20_devenv_20200930.tar.gz.splitaq;
      ls;
  • Use the following command to test the individual files:
    • md5sum -c $VBoxFile.tar.gz.split.md5
  • Use the following command to combine the file pieces back into a single file.
    • cat $(find . -name '*splita*' | sort -n) > $VBoxFile.tar.gz
    • Then, use the main checksum to test the combined file.
      • md5sum -c $VBoxFile.tar.gz.md5

VirtualBox details (please read all bullets before getting started):

• I simply made a Virtual Box disk image => vdi (virtual disk) available. This way the image makes no assumptions about networking, cpu, etc...
• Here are the directions for launching your new development environment using the external VDI.
• You will need at least 2GB of RAM (4 is preferred)
• I recommend 30MB+ of video RAM
• The VDI is configured to grow to 60GB.
• You will need at least one CPU (2 is preferred)
• You can use NAT networking (default) if no one needs to access the machine externally. You can use bridged if you want the machine to appear on the LAN just like any other computer. Note that not all wireless cards support bridged. If bridged does not work, just use NAT and port forwarding.
• OS: Ubuntu 20.04.3 64-bit (note: you must have a 64-bit machine)
• Username: ubuntu
• Password: ubuntu -- this can be changed from cli using: sudo passwd ubuntu
• Eclipse version: Java EE 2020-03 (4.15.0)
• Java version: openjdk version 11.0.8 2020-07-14
• Guest Additions Installed: no
  • Normal guest addition additions installations (here)
  • Sometimes this actions fails. Here is an alternative:
    • Can be downloaded from: https://download.virtualbox.org/virtualbox/6.0.14/VBoxGuestAdditions_6.0.14.iso
    • Note: You should update the above version according to your version of virtualbox. The host virtualbox and guest additions versions should match.
    • After downloaded, issue the following commands:
      • sudo mkdir /media/iso
      • sudo mount -o loop path/to/iso/file/YOUR_ISO_FILE.ISO /media/iso
      • run the installation
• Database credentials (used for phppgadmin)
  • Username: adempiere
  • Password: Silly
• Note: I have already materialized iDempiere in eclipse.
• Note: I have already configured iDempiere in eclipse. All you need to do is start iDempiere.
• Note: If you have questions as to what I did or how to use eclipse to run iDempiere, please review the Development Environment Video in the ERP Academy.
• Note: The iDempiere service is disabled when the service is booted. To run iDempiere as a service, start the iDempiere service using "sudo service idempiere start".
• Wishlist for next release:
  • Let me know if you have additional wishlists.

Add Eclipse to Desktop and Application List

• cp ~/dev/launchEclipse.desktop ~/Desktop.
• right-click on the file and choose 'Allow Launch'
• Sudo copy this file to /usr/share/applications/.
• Click the windows/super key and drag Eclipse to the favorites bar to make it easily available

To Install Pop Shell

Pop shell is a tiling window manager for gnome. I use these features extensively in pop_os.

• sudo apt install node-typescript make git
• makdir -p ~/delme/
• cd ~/delme/
• git clone https://github.com/pop-os/shell
• cd shell
• make local-install

Jenkins Automated Build Server

Since 6.2 builds itself with maven, I no longer maintain a jenkins build server. Instead, I use the installation script => chuboe_moveto_s3_maven.sh to push a copy of the build artifacts to an aws s3 bucket that emulates a jenkins server.