Graphic Interface on Ubuntu Server.
sudo apt-get update
sudo apt-get upgrade
sudo apt install kubuntu-desktop
sudo apt install gksu
reboot
Install Tomcat7
1-First of all, we are going to install Apache tomcat version 7, alongside its additional
packages on our Ubuntu server using the following command:
# apt-get install tomcat7 tomcat7-docs tomcat7-admin tomcat7-examples
2-Once installed, you can test if its working fine by opening the link below in your
browser, with the default port "8080". If you're using it on a local server, use "localhost".
http://localhost:8080
3-Let’s install the text editor gedit with the following command:
# apt install gedit
4-Now, we let's set up the roles for tomcat manager webapp to enable us access the control
panel in the future.
# gedit /etc/tomcat7/tomcat-users.xml
Clear the contents of the file and paste the following text in there:
<?xml version="1.0" encoding="UTF-8"?>
<tomcat-users>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<role rolename="admin-gui"/>
<role rolename="admin-script"/>
<user username="admin" password="admin" roles="manager-gui,managerscript,manager-jmx,manager-status,admin-gui,admin-script"/>
</tomcat-users>
Install Java
1-To install JDK on Ubuntu 16.04, we will run the following command which installs the
recommended version of OpenJDK 8.
# apt-get install default-jdk
2-Press 'y' to continue installing JDK on Ubuntu, this enables us to develop Java
applications to run on our Tomcat server. Next, we will be installing Apache Ant, which is
used to build Java applications, and a source control system, git, using the command below.
# apt-get install ant git
Install PostgreSQL
1-Now, we need to install and setup PostgreSQL, as the most of openMAINT depends on
it. We'll first install postgresql and it's additional packages by typing the following
command:
# apt-get install postgresql postgresql-contrib
2-This will create a new user on your PC with the name "postgres". Set your password for
this account using the command below and take note of it as you'll need it later in the setup
and also to log in to your postgres user account.
# passwd postgres
3-After that, we will install a web administrator tool to manage PostgreSQL database, and
this can be installed using command:
# apt-get install pgadmin3
4-Use the command below to find more modules i.e PostGIS, procedural languages, client
interfaces, etc to install.
apt-cache search postgres
PostgreSQLDatabase server setup
1-Now we have successfully installed PostgreSQL database server, let's connect to the user
"postgres" and create a database which we'll use to setup openMAINT soon.
# su - postgres
#psql
2-Now let's create a database for openMAINT. In our case, we'll use postgresqldb as our
database name.
# createdb postgresqldb
3-To connect to your database, enter:
psql postgresqldb
4-When you're asked for a password, use the one you set in step 3 above. Now go ahead
and set a password for the postgres database user. Replace "newpassword" with the
password you'll use for the database.
# psql -d template1 -c "ALTER USER postgres WITH PASSWORD 'admin';"
5-Type \q to disconnect from the database and type exit to logout from postgres back to
your normal user account.
Install JDBC
1-Java is platform neutral, it is a simple process of just downloading the appropriate JAR
file and dropping it into your classpath. We will use below command to get the required
JDBC driver.
# wget https://jdbc.postgresql.org/download/postgresql-9.4-1200.jdbc4.jar
2-Next, using below command copy this to the tomcat's 'lib' directory.
# cp postgresql-9.4-1200.jdbc4.jar /usr/share/tomcat7/lib
Download and Install Openmaint
1-The latest version of OpenMaint can be downloaded from their official web page.
# wget https://downloads.sourceforge.net/project/openmaint/1.1/openmaint1.1-2.4.2.zip
2-Once you have downloaded the package, then extract it, enter the directory, and copy the
libraries in 'extras/tomcat-libs' using below commands.
# unzip openmaint-1.1-2.4.2.zip
# cd openmaint-1.1-2.4.2
# cp ./extras/tomcat-libs/6.0\ or\ higher/postgresql-9.4.1207.jar
/usr/share/tomcat7/lib/
3-Then copy openmaint-{version}.war to 'openmaint.war' using below commands.
# cp openmaint-1.1-2.4.2.war /var/lib/tomcat7/webapps/openmaint.war
4-Then we will copy cmdbuild-shark-server-{version}.war to 'shark.war' using below
command.
# cp openmaint-shark-server-1.1-2.4.2.war
/var/lib/tomcat7/webapps/shark.war
5- Now let’s open the aplication Pgadmin3 that we downloaded. Here we are going to click
in connect, like the Image below.
6- After that we are going to fill up our credentials that are going to be the same we
configure when we were setting up the PostgreSQL database server, and is going to be like
I’ll show you below.
Note:
If you can’t connect to the database just do again the step PostgreSQLDatabase
server setup, but now don’t put psql after su – postgres. Just like I did in
the video.
7- Now we have to Restore our database, in order to do that we are going to click on our
server, and then click on database and make a right click on top of our database that’s
POSTGRESQLDB, and then click on restore, and we will restore from our openmaint
databases the one that says empty.backup, and in role name we will select postgres, just like
this:
OpenMaint Web Installation Wizard
1-Now all our files are set, now let’s just configure two more files, the first one that we are
going to put our database. And we will use the following command:
# gedit /var/lib/tomcat7/webapps/shark/META-INF/context.xml
2-Now Let’s set our URL, to have access to our openmaint application. We will use the
following command:
# gedit /var/lib/tomcat7/webapps/shark/conf/Shark.conf
After put the command we will go all the way down and we will change the following line:
3-Now let’s just restart tomcat7 with the following command:
# service tomcat7 restart
4- Now we can go to our website and type the following url:
http://locahost:8080/openmaint
5- now we will see this:
6- after that we just have to configure database settings and test connection, if works, click
on “Finish” and you will be redirected to the login page.
Access to OpenMaint Dashboard
1-After the successful Database connection testion, refresh your page and you will see the
login page like this:
2-After putting the right credentials, we will see our management console.
