Installing m-Power on a Linux Server

mrc Documentation
michaels, ross & cole, ltd.
http://www.mrc-productivity.com/

Installing m-Power on a Linux Server

In the following example, we will be installing m-Power on Ubuntu, a popular “flavor” of Linux.

1) Install JDK and JRE through Synaptic Package Manager

a. System -> Administration -> Synaptic Package Manager

b. Once in the Synaptic Package Manager, go to Settings -> Repositories

c. Under the Ubuntu Tab, Check the “Software restricted by copyright or legal issues (multiverse)

d. Click Close

e. You should now be back to the Synaptic Package Manager

f. Click the Search Icon

i. Type JDK

ii. Select the sun-java5-jre and the sun-java5-jdk and select the “Mark for Installation”

iii. Other components will also be selected -- this is OK

g. Click the Apply green check button

h. A summary pop up box will appear, click the “Apply” button

i. The appropriate Java tools will now be installed onto your system properly.

j. Once finished, you can verify they have been installed successfully by going to a command line and entering the command “java” and “javac” If many argument options appear for these commands, you have succeed in Step 1.

2) Next we need to tell Ubuntu where your new JDK can be found

i. Hit ALT+F2 to bring up the “Run Application” window, and enter “gksudo nautilus” (allows you “windows explorer” view and full authority on all files and folders)

b. Navigate to /etc, and edit the file profile

c. Enter the following text

d. #Arguments for Tomcat for m-Power

export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun-1.5.0.08

export CATALINA_HOME=/usr/local/tomcat

export PATH=$JAVA_HOME/bin:$PATH

e. Click Save.

3) Getting Tomcat

a. Download and extract m-Power. It can be found at this link: Download m-Power here.

b. Now that you have extracted the .zip file, there should now be an m-Power folder. Within that there is a Tomcat folder. Copy and Paste this directory on your Linux server in the /usr/local directory

i. The easiest way to do this is to hit ALT+F2 and type gksudo nautilus (allows you “windows explorer” view and full authority on all files and folders)

ii. Simply navigate to /usr/local and paste the Tomcat directory there.

c. Within the /usr/local/tomcat/conf directory, edit the server.xml file with text editor. Scroll to the bottom of the document. Notice where it says

Modify the following section to look like this:

<Host name="localhost" appBase="webapps">

<!-- m-power for windows/NT

<Context path="/webapp/mrc" docBase="C:/m-power/mrcwebgui" debug="0" reloadable="true" >

<Logger className="org.apache.catalina.logger.FileLogger"

prefix="mrcps_log" suffix=".txt" timestamp="true"/>

</Context>

-->

<Context path="/webapp/mrc" docBase="/m-power/mrcwebgui" debug="0" reloadable="true" >

<Logger className="org.apache.catalina.logger.FileLogger"

prefix="mrcps_log" suffix=".txt" timestamp="true"/>

</Context>

<Context path="/mrcjava" docBase="/m-power/mrcjava" debug="0" reloadable="true" >

<Logger className="org.apache.catalina.logger.FileLogger"

prefix="mrcjava_log" suffix=".txt" timestamp="true"/>

</Context>

</Host>

d. Click Save.

4) Starting Tomcat

a. Once at a command line, run a cd /

b. CD $CATALINA_HOME/bin

c. Sh Catalina.sh start

5) Accessing m-Power

a. http://999.999.999.999:8011/webapp/mrc/servlet/MRCPS.MRC001 (where 999.999.999.999 is the IP address of your Linux Server).

6) Stopping Tomcat

a. At a command line, run a cd /

b. CD $CATALINA_HOME/bin

c. Sh Catalina.sh stop