more4apps mobile - installation and configuration guide · more4apps mobile - installation and...
TRANSCRIPT
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).