More4Apps Mobile - Installation and Configuration Guide Last updated: 02 October 2017

Table of Contents

1. ................... Overview – Mobile Applications - Installation and Configuration 2

2. ...................................................................... Steps - Installation and Configuration 4

3. ..................................................................... Download the Server Installation Files 5

4. ........................................................................................................... Server Installation 6

4.1 ........................................................................ Server Install - R12 Customers Only 6

4.2 ....................................................................... Server Install - R11i Customers Only 8

5. ................. Install the More4Apps Mobile Applications on your Mobile device 10

6. .............................................................. Configure More4Apps Mobile Applications 11

1. Overview – Mobile Applications - Installation and Configuration

The More4Apps Mobile Applications for Oracle E-Business Suite use a web-based connection to

communicate with the server for all uploads and downloads (not SQL*Net).

The server-side installation consists of a Servlet to be installed in the E-Business Suite mid-tier

framework.

The More4Apps Mobile Android Applications are very secure as they utilize the existing Oracle

Applications security and login mechanisms for user authentication and authorization. Users

connect using their regular E—Business Suite usernames and passwords.

Key Features:

Full integration with the Oracle Applications login and security functionality

Respect for session timeout rules

Single Sign On integration

Supports non-APPS schemas i.e. Oracle On Demand (OOD)

All versions of R11i and R12 supported from 11.5.9 onwards

HTTPS support

Components:

Mobile Device Apps

Each Android or Apple device requires an installation of the individual transaction

Applications. You can download the Apps from either the Google Play or iTunes Store, just

search on More4Apps.

Server packages

There are no database packages or scripts required.

Application Settings

When the App logs into an instance for the first time it will automatically create several

Profile Options. Many of these are for internal use by the applications (e.g. to store the

license key). Some applications have profile options used to enable/disable functionality.

These profile options are documented in the product-specific online documentation.

Note- On some devices the login will fail at first attempt. To fix this just login again.

Mid-Tier Servlet

A mid-tier servlet is installed to facilitate communication between the Android Applications

and the database.

Minimum Software Requirements (anything at or above these versions is fine):

Server:

o E-Business Suite 11.5.9

o J2SE 1.5

o Database 9i

Android device:

o Android 2.1 (Éclair)

XML Communication Technical Description:

The communication protocol between the Mobile Applications and the E-Business database server

is HTML and XML. The Android App authenticates then communicates with the E-Business web tier

in the background, in the same way that an end-user would in an Oracle Self-Service browser-

based product such as Internet Time.

The Mobile App makes HTML calls to the servlet. Parameters are passed using the POST structure.

The servlet verifies the authentication of the calling App. If the calling App has not yet logged in

then the E-Business login screen is presented to the user. (If SSO is enabled then the user is

automatically forwarded to the SSO login screen). The user then logs in with their usual E-

Business username/password. The session will expire if the user logs out or closes the App, or if

they are idle for a long period.

Licensing:

Licensing is done by number of devices per App.

Once you purchase a license for the App you will be issued with a License Key. When the license

key is entered additional device registrations will be allowed.

Support:

If you have any questions regarding the installation steps, please contact us via our website.

http://www.more4apps.com/request-technical-assistance/

Refer to section: Steps - Installation and Configuration

2. Steps - Installation and Configuration

To install and configure the More4Apps Mobile Android Applications you need to complete the

following steps (click on the links to go to the relevant documentation):

1. Download the Server Installation Files

2. Server Installation – These steps are typically undertaken by a DBA

a. Server Install - R12 Customers Only

b. Server Install - R11i Customers Only

3. Install the More4Apps Mobile Applications on your Mobile device

4. Configure More4Apps Mobile Applications

Support:

If you have any questions regarding the installation steps contact us via our website.

http://www.more4apps.com/request-technical-assistance/

3. Download the Server Installation Files

To download the server installation files please go to this URL:

https://horizon.more4apps.com/ssfiles/Mobile_servlet_deployment_files.zip

Refer to section: Steps - Installation and Configuration

4. Server Installation

Follow these steps to install the communication servlet in the mid tier. This servlet is required for

both Release 11i and Release 12:

1. Server Install - R12 Customers Only

2. Server Install - R11i Customers Only

To enable the servlet we modify the server configuration files by implementing a fully supported

Autoconfig customization, as documented in Metalink Note 387859.1.

Attention Windows Users: this document uses UNIX syntax when specifying directories and

operating system commands. Substitute the appropriate Windows syntax where applicable.

If you have multiple mid-tier servers then you must repeat these steps on each server.

4.1 Server Install - R12 Customers Only

The following steps should be completed for R12 customers only.

1. Copy jar files to $JAVA_TOP

Copy the jar files to the mid-tier server and place in $JAVA_TOP.

cp W1Servlet.jar $JAVA_TOP

cp core.jar $JAVA_TOP

cp javase.jar $JAVA_TOP

If you have unzipped the jar files as per our previous instructions please remove the unzipped

files:

rm -rf $JAVA_TOP/com/more4apps/mobile

rm –rf $JAVA_TOP/com/google

2. Edit Autoconfig Templates

Navigate to the template directory:

cd $FND_TOP/admin/template

Create the "custom" directory if it does not already exist.

mkdir custom

If the files orion_application_xml_1013.tmp and orion_web_xml_1013.tmp do not already

exist in the "custom" directory then copy them in. Be careful not to overwrite an existing copy

of these files or you may lose pre-existing customizations.

cp orion_web_xml_1013.tmp custom

cp orion_application_xml_1013.tmp custom

Move into the custom directory and edit the custom template files.

cd custom

vi orion_web_xml_1013.tmp

Paste the following lines just before the TCF alias (approximately line 170).

<!-- More4Apps Mobile servlet -->

<servlet>

<servlet-name>W1Servlet</servlet-name>

<servlet-class>com.more4apps.mobile.W1Servlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>W1Servlet</servlet-name>

<url-pattern>/W1Servlet/*</url-pattern>

</servlet-mapping>

Save the file.

Now edit orion_application_xml_1013.tmp.

vi orion_application_xml_1013.tmp

Paste the following lines just after <library path="%s_javatop%" /> (approximately line 62).

<library path="%s_javatop%/W1Servlet.jar" />

<library path=”%s_javatop%/javase.jar” />

<library path=”%s_javatop%/core.jar” />

Save the file.

3. Run Autoconfig (as described in Note 387859.1 )

cd $ADMIN_SCRIPTS_HOME

adautocfg.sh

4. Bounce Apache

adapcctl.sh stop

adoacorectl.sh stop

adoacorectl.sh start

adapcctl.sh start

5. Test the Servlet

To test whether the servlet has been installed correctly, first get the value of profile option

"Apps Servlet Agent".

Then enter the following URL in your browser:

<<value of profile option>>/W1Servlet/hello

The full URL will look something like this:

http://tornado.more4apps.com:8000/OA_HTML/W1Servlet/hello

If the servlet has been installed correctly a simple information page will render.

Refer to section: Install the More4Apps Mobile Applications on your Mobile device

4.2 Server Install - R11i Customers Only

The following steps should be completed for customers on R11i only.

1. Copy jar files to $JAVA_TOP

Copy the jar files to the mid-tier server and place in $JAVA_TOP.

cp W1Servlet.jar $JAVA_TOP

cp core.jar $JAVA_TOP

cp javase.jar $JAVA_TOP

If you have unzipped the jar files as per our previous instructions please remove the unzipped

files:

rm -rf $JAVA_TOP/com/more4apps/mobile

rm –rf $JAVA_TOP/com/google

2. Edit Autoconfig Templates

Navigate to the template directory:

cd $FND_TOP/admin/template

Create the “custom” directory if it does not already exist.

mkdir custom

If the files jserv_ux_ias1022.properties and zone_ias1022.properties do not already exist in

the “custom” directory then copy them in. Be careful not to overwrite an existing copy of these

files or you may lose pre-existing customizations.

cp jserv_ux_ias1022.properties custom

cp zone_ias1022.properties custom

Move into the custom directory and edit the custom template files.

cd custom

vi jserv_ux_ias1022.properties

Paste the following lines just after wrapper.classpath=%s_javatop% classpath entry

(approximately line 211).

#--- More4Apps ---

wrapper.classpath=%s_javatop%/W1Servlet.jar

wrapper.classpath=%s_javatop%/core.jar

wrapper.classpath=%s_javatop%/javase.jar

#--------

Save the file.

Now edit zone_ias1022.properties

vi zone_ias1022.properties

Paste the following lines at the very end of the file, after Oracle Web Agent.

#------ More4Apps Mobile Servlet ------

servlet.W1Servlet.code=com.more4apps.mobile.W1Servlet

#-------------------------------------

Save the file.

3. Run Autoconfig (as described in Note 387859.1)

cd $APPLCSF/scripts/$CONTEXT_NAME

adautocfg.sh

4. Bounce Apache

cd $APPLCSF/scripts/$CONTEXT_NAME

adapcctl.sh stop

adapcctl.sh start

5. Test the Servlet

To test whether the servlet has been installed correctly, first get the value of profile option

"Apps Servlet Agent".

Then enter the following URL in your browser:

<<value of profile option>>/W1Servlet/hello

The full URL will look something like this:

http://xxxx.more4apps.com:8000/oa_servlets/W1Servlet/hello

If the servlet has been installed correctly a simple information page will render.

Refer to section: Install the More4Apps Mobile Applications on your Mobile device

5. Install the More4Apps Mobile Applications on your Mobile device

Once the server-side installation is complete you need to install the More4Apps Mobile

Applications on your mobile device from the Google Play Store for Android or the iTunes store

for Apple.

More4Apps Mobile Product App Installation

You can now install the desired product applications. Currently we have three Applications

available:

More4Apps Mobile Receiving

More4Apps Mobile Inventory

More4Apps Mobile Work In Process

Search for "More4Apps Mobile" or "Oracle eBusiness" in Google Play to find these Apps.

6. Configure More4Apps Mobile Applications

Once the installation has been completed you need to configure the More4Apps Mobile

Application.

Please Note: The servlet must have been installed and tested as per the previous section or an

error will occur when attempting to connect.

1. Connecting to an E-Business Instance

Select one of your More4Apps Mobile applications. You will be presented with a screen for

Oracle E-Business connections. Click on the “Add Connection” button. You will see the

connection registration screen. At this point you will need the value of the “Apps Servlet

Agent” profile option from the instance. To get this value login in to Oracle e-Business Suite

as a System Administrator and find the “Apps Servlet Agent” profile option at the site level.

To enter the required value, you can either type it manually (not straightforward on an

Android device) or use your built-in barcode scanner.

a) Scanner Method

Enter the following URL on your normal computer (not your Android device):

<<Apps Servlet Agent>>/W1Servlet?p_action=qr

For example:

http://xxxx.more4apps.com:8000/OA_HTML/W1Servlet?p_action=qr

This will display a QR barcode on your screen. You can now long-hold in the servlet URL

field on your Android device, which will start the bar code reader. Scan the barcode on

your computer and the URL will be scanned to your device.

b) Manual Method

Enter the URL exactly as show in the Profile Option into the servlet URL field.

Once the URL has been entered, press the “Register” button on your Android device.

If the registration is successful then you will see the Instance name in the list of

Connections. You can click on the Instance name to proceed.

2. Logging In and Security

Click on the “Login” button to connect to your E-Business instance. You should see your usual E-

Business login page appear on the device. Log in using your Oracle username and password.

You will be prompted whether you want to “remember” this username and password. It is a

good idea to do this as it makes it easy to log in next time. To clear out the “remembered”

details, click on the “Refresh” button in the ActionBar at the top of the page.

You will be next be prompted for your Responsibility then your Inventory Org. Once these are

chosen you will be able to proceed with the More4Apps Mobile App functionality.

The next time you log in to this App it will also remember and default your previously chosen

Responsibility and Inventory Org. If you want to switch to a different one then press the menu

button from the App home screen.

3. Logging Out

Click on the back button on your device until the More4Apps Mobile Launcher is shown. (We are

working on a better approach to logging out and will issue new App versions shortly to address

this).