Steps to Setup On-Premise IDP

• Open linux terminal using your root profile.
• Locate folder which contains the downloaded on-premise mo-idp-installer.sh script file (mo-idp-installer.sh).



• Run the following command in terminal: sh mo-idp-installer.sh
• You will be prompted to install JAVA. Type "n" if JAVA 8 is already installed, if not type "y". As shown below:



• After pressing "y", JAVA 8 will be installed.
• Once the Java installation is completed, miniOrange Onpremise zip file will be downloaded & extracted from the source



• In case if JAVA 8 is already present, the script will directly download miniOrange onpremise zip and extract it in the same folder.



• In case, some other version of JAVA is already installed, you will receive the message "Java 8 not found". Let the script install JAVA 8 by pressing "y" when requested.
• Once the extraction is completed, IDP server will automatically start up and can be accessed through http://localhost:8080/initialize
• After extraction of the file you can see the folder "mo-idp-server-X as shown below.



• As Tomcat has already started up, you can check the logs in catalina.out file */mo-idp-server-X/logs/catalina.out as shown below:



• Go to http://localhost:8080/initialize and setup your database.

• You can download OpenJDK8 package using apt install openjdk-8-jdk for Debian, Ubuntu, etc. OR yum install java-1.8.0-openjdk for Fedora, Oracle Linux, Red Hat Enterprise Linux, etc.
• If JAVA is already installed and Environment variables are set correcty on your system, then you don't need to follow this step, you can directly go to Install On-Premise Server.

Note:

Once the Java installation is complete, check that the JAVA_HOME environment variable has been set correctly. Open a terminal and type echo $JAVA_HOME and hit Enter. If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly. If nothing is displayed you'll need to set the JAVA_HOME environment variable manually.



• Linux users can use below commands to set JAVA_HOME and JRE_HOME variables using below commands -
export JAVA_HOME=/path/to/jdk export JRE_HOME=/path/to/jre
• You can verify whether above environment variables are set correctly. Execute below commands to verify environment variables -
echo $JAVA_HOME echo $JRE_HOME
• To start the miniOrange server, go to the mo-idp-server-<version>/bin directory of the server distribution (i.e. folder with name similar to mo-idp-server-1.0.3 (version may vary)). Execute the startup file based on your environment.
• Linux/Unix: Execute chmod +x startup.sh to give executable permission to this file. Set relevant permission of mo-idp-server folder to allow the creation of new folder like temp or logs folder – chmod 755.
  $ .../bin/startup.sh

Run Tomcat as a Service for miniOrange IDP

• Install Tomcat as Linux Service from Apache project site.
• Unpack the tomcat folder in opt directory. For this, you will need a terminal and root access.
• Create Tomcat user with restricted permissions:
groupadd tomcat
useradd -s /sbin/nologin -g tomcat -d /opt/mo-idp-server tomcat
passwd tomcat
• Set the tomcat user as the owner of the $CATALINA_HOME folder.
chown -R tomcat.tomcat /opt/mo-idp-server
• Configure Tomcat to run as a Service
Using init.d
• Navigate to /etc/init.d , create a directory named as tomcat and paste the below code.
  #!/bin/bash ## Change the path of mo-idp folder below ### BEGIN INIT INFO # Provides: tomcat # Required-Start: $network $remote_fs $syslog # Required-Stop: $network $remote_fs $syslog # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: Start Tomcat at boot time # Description: Start Tomcat at boot time ### END INIT INFO export JAVA_HOME=/usr/lib/jvm/jre export CATALINA_HOME=/opt/<PATH OF MiniOrange IDP Folder> export JAVA_OPTS="-Xms250m -Xmx1024m" RETVAL=$? case $1 in start) if [ -f $CATALINA_HOME/bin/startup.sh ]; then echo $"Starting Tomcat" su -p -s /bin/sh tomcat $CATALINA_HOME/bin/startup.sh fi ;; stop) if [ -f $CATALINA_HOME/bin/shutdown.sh ]; then echo $"Stopping Tomcat" su -p -s /bin/sh tomcat $CATALINA_HOME/bin/shutdown.sh fi ;; *) echo $"Usage: $0 {start|stop}" exit 1 ;; esac exit $RETVAL
• The script shown above would have a LSB type header to define dependencies and runlevels.
• To make the script executable:
  chmod ug+x /etc/init.d/tomcat
• Configure the system to run the script at boot:
  sudo update-rc.d tomcat defaults # Debian, Ubuntu
sudo chkconfig --add tomcat # Red Hat & co.
• If you want to remove the service:
  sudo update-rc.d -f tomcat remove # Debian, Ubuntu
• To start/stop the script manually:
  service tomcat [start | stop]
• Or the old-fashioned way (Ubuntu):
  /etc/init.d/tomcat [start | stop]