My Oracle Support Banner

How To Implement Mobile Field Service Wireless Without Oracle iAS Wireless Server (Doc ID 758680.1)

Last updated on JULY 02, 2019

Applies to:

Oracle Field Service - Version 11.5.10.2 to 12.1 [Release 11.5 to 12]
Oracle Mobile Field Service - Version 11.5.10.2 to 12.1.1 [Release 11.5 to 12.1]
Information in this document applies to any platform.

Details

Mobile Field Service Wireless runs without Oracle iAS Wireless Server

For Mobile Field Service Wireless, it was required to have Oracle iAS Wireless Server to run the application. Now, one can use new MiniWireless server on existing OC4J or Mobile Server of Oracle Lite Database!

Existing setup of Oracle iAS Wireless Server is also supported and one can choose any option to run MFS Wireless application.

NOTE: Starting from 12.1.2 no Wireless or Mini Wireless server is required anymore. From then on it is a part of OACORE OC4J. But for MFS Voice, a separate Oracle iAS Wireless server installation will still be required.

Benefits of MiniWireless Server:

1. Save in Hardware Resource

MiniWireless server does not require any infrastructure database like Oracle iAS Wireless server. MiniWireless server requires less than 5MB space to install it where as Oracle iAS Wireless requires more than 2GB for installation and more than 500MB for infrastructure database!

Oracle iAS Wireless Server has many other processes, which are not required to run MFS Wireless application. MiniWireless server has been developed specifically for MFS Wireless and hence saves CPU cycles by avoiding unwanted processes.

One can also setup MiniWireless server with Oracle Lite Database Mobile Server to save hardware resources. Oracle Lite Database Mobile Server is required to run Mobile Field Service Store and Forward applications (Laptop and PDA). So, if you are implementing both MFS Wireless and MFS Store and Forward, you will require only one server to serve both!


2. Performance

MiniWireless server only runs the process required for MFS Wireless application and avoids unnecessary processes like Oracle iAS Wireless server and hence performance is better.

Oracle iAS Wireless supports more than 30 devices and so MiniWireless server does. But MiniWireless server loads data for selected devices only and hence saves memory footprint. One can enable more devices based on the requirement.


3. Maintenance

As MiniWireless server does not require any database, it is very easy to take backup and clone the setup. Also, it is possible to deploy it on Mobile Server of Oracle Lite Database and save maintenance efforts of two different servers.

 
4. Save Time

Installing Oracle iAS Wireless server is a tedious job and takes more than one hour to set it up. While one can install and setup MiniWirless server innot more than 5 minutes It takes only 3 clicks if it is deployed on OC4J 10.1.3.x using the Application Server Contro tool.

Actions

To setup MFS Wireless application using,

1. MiniWireless Server¦

please refer below section. OR

2. Oracle iAS Wireless Server

please refer Mobile Field Serice Implementation Guide (R12.0 and R12.1) and Oracle Wireless Option for Service Concepts and Procedures Guide (11.5.10.2)

 

MFS Wireless Using MiniWireless:

One can install MiniWireless Server on OC4J (Part of Oracle Application Server or Standalone) versions,
- 10g Release 3 (10.1.3.x) OR
- 10g Release 2 (10.1.2.x)


One can also use Oracle Lite Database Mobile Server OC4J to run MiniWireless Server.

A) Installing MiniWireless Server on OC4J version 10g R3 and R2 (10.1.3.x and 10.1.2.x)

$OC4J_HOME  Directory where OC4J server is installed

1. Download and apply <Patch:7662676> Patch to run MFS Wireless using MiniWireless Server

2. Download MiniWireless zip file and unzip it to some working directory

3. Download and install OC4J if you don't have one.
    a. To Download OC4J 10g R3/R2: Click here
    b. To Install and configure OC4J 10g R3/R2: Click here

4. Copy mcs.ear file at $OC4J_HOME/j2ee/home/applications directory

5. Open $OC4J_HOME/j2ee/home/config/server.xml file and add below entry after <global-application> tag

For 10.1.3.x 
<application name="mcs" path="../applications/mcs.ear" parent="default" start="true" /> 
For 10.1.2.x 
<application name="mcs" path="../applications/mcs.ear" start="true" />

Note: Please make sure you do not add above tags between any comments tag.

 6. Search for the <web-site> tag in $OC4J_HOME/j2ee/home/config/server.xml file and open the file mentioned as <path> attribute. (Default file is $OC4J_HOME/j2ee/home/config/default-web-site.xml)

7. Open above file and add below entry after <default-web-app> tag 
 

<web-app application="mcs" name="mcs-web" load-on-startup="true" root="/mcs" />

Note: Please make sure you do not add above tags between any comments tag.

8. Start/Restart the OC4J. Please refer OC4J documentation for how to Start/Restart the server.

9. Once OC4J server is up and running, type below URL in Normal Browser to validate your installation.

http(s)://<oc4j_host>:<port>/mcs/

 10. You should get warning message saying 'No Application Found'.

11. Open $OC4J_HOME/j2ee/home/applications/mcs/mcs-web/WEB-INF/classes/oracle/panama/core/admin/Applications.properties file and add URL for your Ebiz Mobile Field Service Wireless Login page.

For example,
Ebiz_Test_Instance=http(s)://<Ebiz_host>:<port>/OA_HTML/csfwlgnm.jsp

12. Refresh the browser window opened in step (9)

13. You should get MFS Wireless Login screen!

Note: You can also use the Application Server Control tool provided in 10.1.3.x to deploy mcs.ear file and can skip steps mentioned above from (3) to (7)

B) Installing MiniWireless Server on Oracle Lite Database Mobile Server version 10g R3 and R2 (OC4J versions 10.1.3.x and 10.1.2.x)

$OLITE_HOME  Directory where Oracle Lite Database is installed

1. Download and apply <Patch:7662676> Patch to run MFS Wireless using MiniWireless Server

2. Download MiniWireless zip file and unzip it to some working directory

3. Copy mcs.ear file at $OLITE_HOME/mobile_oc4j/j2ee/mobileserver/applications directory

4. Open $OLITE_HOME/mobile_oc4j/j2ee/mobileserver/config/server.xml file and add below entry after <global-application> tag

For 10.1.3.x
<application name="mcs" path="../applications/mcs.ear" parent="default" start="true" />
For 10.1.2.x
<application name="mcs" path="../applications/mcs.ear" start="true" />

Note: Please make sure you do not add above tags between any comments tag.

5. Search for the <web-site> tag in $OLITE_HOME/mobile_oc4j/j2ee/mobileserver/config/server.xml file and open the file mentioned as <path> attribute. (Default file is $OLITE_HOME/mobile_oc4j/j2ee/mobileserver/config/default-web-site.xml)

6. Open above file and add below entry after <default-web-app> tag 

<web-app application="mcs" name="mcs-web" load-on-startup="true" root="/mcs" />

 

Note: Please make sure you do not add above tags between any comments tag.

7. Start/Restart the Mobile Server. Please refer Oracle Lite Database documentation for how to Start/Restart the server.

8. Once Mobile server is up and running, type below URL in Normal Browser to validate your installation.

http(s)://<mobile_server_host>:<port>/mcs/

9. You should get warning message saying 'No Application Found'.

10. Open $OLITE_HOME/mobile_oc4j/j2ee/mobileserver/applications/mcs/mcs-web/WEB-INF/classes/oracle/panama/core/admin/Applications.properties file and add URL for your Ebiz Mobile Field Service Wireless Login page.

For example,
Ebiz_Test_Instance=http(s)://<Ebiz_host>:<port>/OA_HTML/csfwlgnm.jsp

11. Refresh the browser window opened in step (8)

12. You should get MFS Wireless Login screen!

Migrating from Oracle iAS Wireless Server to MiniWireless Server:

Migrating from Oracle iAS Wireless Server to MiniWireless server is very easy and can be done in below three steps:

1. Download and setup MiniWireless server as mentioned above.

2. Configure Mobile Field Service Wireless login URL to Applications.properties file mentioned above in step A.10 and B.9

3. Start using MFS Wireless application by accessing URL mentioned in above steps A.8 and B.7

Optional Setup:

1. It is possible to deploy multiple environments on single MiniWireless server deployment. One can add multiple entries with different environment names in Applications.properties file mentioned in step A.11 and B.10

2. If you are using HTTPS connection for MFS Wireless application and get below error, please copy below file:

Error:
"java.lang.UnsatisfiedLinkError: no njssl10 in java.library.path"

For 10.1.3.x:

For Windows Env: Copy njssl10.dll file to %OC4J_HOME%/bin/ folder
For UNIX Env: Copy libnjssl10.so file to $OC4J_HOME/lib/ directory

For 10.1.2.x:

For Windows Env: Copy njssl10.dll file to %OC4J_HOME%/j2ee/home/ folder
For UNIX Env: Copy libnjssl10.so file to $OC4J_HOME/lib/ directory

Please Note:

1. You will also need to install below patches to make application run with the MiniWireless server. 

R12.1.x - Patch 7662676:R12.CSF.B
R12.0.6 - Patch 7662676:R12.CSF.A
11.5.10.2 - Patch 7662676.11i

2. Oracle E-Business Suite (11.5.10.2CU to 12.1.0) also has its own OC4J to run middle tier. But it is strongly recommended NOT TO use this OC4J to deploy MiniWireless. Such deployment will not be supported.

3. This document gives two implementation options for setting up the MFS Wireless application using: 

A. MiniWireless Server,
B. Oracle iAS Wireless Server
but it is not obvious which option is preferable, or should be selected .
If OC4J is not installed, should OC4J be installed and take that option, or is it better to go for the OLite Database option?

The preferable choice is to take the MiniWireless Server option.

Oracle 9i Lite has a component called Mobile Server which runs on OC4J on Oracle 9iAS.  
MiniWireless is not supported on this older version (i.e. 9iAS), and so it is recommended to install the standalone OC4J version 10g R3/R2.

While it is possible to upgrade Oracle lite to 10g and then go for option B, this is a not such a good option as it would require an upgrade to existing setups.

Therefore it is advised to go with Option A, which is detailed under the heading:
A) Installing MiniWireless Server on OC4J version 10g R3 and R2 (10.1.3.x and 10.1.2.x)

Contacts

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!


In this Document
Details
 Mobile Field Service Wireless runs without Oracle iAS Wireless Server
 Benefits of MiniWireless Server:
Actions
 MFS Wireless Using MiniWireless:
 A) Installing MiniWireless Server on OC4J version 10g R3 and R2 (10.1.3.x and 10.1.2.x)
 B) Installing MiniWireless Server on Oracle Lite Database Mobile Server version 10g R3 and R2 (OC4J versions 10.1.3.x and 10.1.2.x)
 Migrating from Oracle iAS Wireless Server to MiniWireless Server:
 Optional Setup:
 Please Note:
Contacts
References

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.