Inventory Forms Files

Installation of the Inventory Forms on Linux Platforms
======================================================

Download files:
forms_install.sql  - script is required to create the database and tables 
forms.war          - web application file
forms-user.sh      - script for user management via CLI (optional)


This instruction has been created based on Ubuntu 20.04.3 

1. Add packages of JDK, Apache Tomcat and MariaDB
-------------------------------------------------

# apt install openjdk-8-jdk
# apt install tomcat9
# apt install mariadb-server-10.3



2. Set Up a Database
--------------------

Example:
localhost:# mysql_secure_installation 


NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!


In order to log into MariaDB to secure it, we'll need the current
password for the root user.  If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.


Enter current password for root (enter for none): 
OK, successfully used password, moving on...


Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.


You already have a root password set, so you can safely answer 'n'.


Change the root password? [Y/n] n
 ... skipping.


By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.


Remove anonymous users? [Y/n] y
 ... Success!


Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.


Disallow root login remotely? [Y/n] y
 ... Success!


By default, MariaDB comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.


Remove test database and access to it? [Y/n] y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!


Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.


Reload privilege tables now? [Y/n] y
 ... Success!


Cleaning up...


All done!  If you've completed all of the above steps, your MariaDB
installation should now be secure.


Thanks for using MariaDB!




3. Add support of a subset of Oracle's PL/SQL language
------------------------------------------------------

Example:
# vi /etc/mysql/mariadb.conf.d/50-server.cnf

[mariadb-10.3]
sql-mode=ORACLE

Restart the database.
Example:
# systemctl restart mariadb



4. Create database and tables using the forms_install.sql script
----------------------------------------------------------------

Example:
# mysql -u root -e "source forms_install.sql"



5. Set up the root password if it has not been done yet
-------------------------------------------------------

Example (password "canlogin"):
# mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'canlogin';"



6. Install MariaDB JDBC Driver
------------------------------

Example:
# cd /var/lib/tomcat9/lib
# wget https://dlm.mariadb.com/1965742/Connectors/java/connector-java-2.7.5/mariadb-java-client-2.7.5.jar
# cd /var/lib/tomcat9/webapps/ROOT
# jar xf /var/lib/tomcat9/lib/mariadb-java-client-2.7.5.jar



7. Install Web Application
--------------------------

Download the forms.war file to /var/lib/tomcat9/webapps/ directory.

Restart the Apache Tomcat
Example:
# systemctl restart tomcat9



8. Open the Homepage
--------------------

http://<Your server IP>:8080/forms/

Initialy login as 'master' user. Please use the database root password (example: 'canlogin').

Enjoy!