Oracle Mobile Application Server Changes in Release 12: Administrators Guide

An Oracle White Paper January 2007

Contents

CONTENTS ......................................................................................................................................................................................1 1. INTRODUCTION ....................................................................................................................................................................3 1.1 2. 3. 4. 5. 6. 7. OVERVIEW ...........................................................................................................................................................................3

NEW ENVIRONMENT VARIABLES IN R12......................................................................................................................4 CHANGED DIRECTORY STRUCTURE IN R12................................................................................................................5 DETAILS OF CHANGES DIRECTORY STRUCTURE..................................................................................................6 DETAILS OF CHANGES SECURITY ...............................................................................................................................8 DETAILS OF CHANGES AUTOCONFIG ENGINE......................................................................................................10 DOCUMENT REFERENCE .................................................................................................................................................11 7.1 CURRENT DOCUMENT REFERENCES ..................................................................................................................................11

8.

FAQ..........................................................................................................................................................................................12

1. Introduction
1.1 Overview
This document details the changes made to the Mobile Application Server (MWA) configuration for Release 12 (R12). The following changes were made: o o o Changes to R12 directory structure Changes for Security Changes for Autoconfig Engine

2. New Environment Variables in R12

The following is the new environment variable introduced in R12. o $INST_TOP

The following are the new directories that the MWA server uses: o o $INST_TOP/admin/scripts $INST_TOP/admin/install

3. Changed Directory Structure in R12

Prior to R12: o o The MWA server startup files were located under $MWA_TOP/bin directory The MWA server configuration files were located under $MWA_TOP/secure directory

In R12, these files are available under $INST_TOP/admin/scripts and $INST_TOP/admin/install directories, and the MWA server use the files only from these directories. Note: Though the directories under $MWA_TOP continue to exist, the MWA server no longer uses those files. The only exception is the MWA Dispatcher. The MWA Dispatcher startup file continues to reside under $MWA_TOP/bin directory and MWA server uses the same file.

Directories used by MWA server prior to R12

Directories used by MWA server in R12 for the same purposes $INST_TOP/admin/scripts $INST_TOP/admin/install

$MWA_TOP/bin $MWA_TOP/secure

4. Details of Changes Directory Structure

The following table provides the following details: o o o o Functionality Name of the file Location and Usage in 11i Location and Usage in R12

11i
Functionality Name of the file Location Usage Location

R12
Usage

Startup the MWA Server

mwactl.sh/cmd

mwactl.sh/cmd start $MWA_TOP/bin <port_number> mwactl.sh/cmd -login adminuid/pwd stop<port_number>

mwactl.sh start $INST_TOP/admin/scripts <port_number

Shutdown the MWA Server

mwactl.sh/cmd

mwactl.sh login mwactl.sh/cmd -login adminuid/pwd adminuid/pwd stop_force stop_force $MWA_TOP/bin <port_number> $INST_TOP/admin/scripts <port_number> mwactl.sh login adminuid/pwd mwactl.sh/cmd -login killsession adminuid/pwd killsession <session_nam <session_name> e> $MWA_TOP/bin <port_number> $INST_TOP/admin/scripts <port_number> mwactl.sh mwactl.sh/cmd start_dispatche $MWA_TOP/bin start_dispatcher $INST_TOP/admin/scripts r mwactl.sh mwactl.sh/cmd stop_dispatche $MWA_TOP/bin stop_dispatcher $INST_TOP/admin/scripts r

Kill a user's MWA Session Startup MWA Dispatcher Shutdown MWA Dispatcher

mwactl.sh/cmd

mwactl.sh/cmd

mwactl.sh/cmd

Note: mwactl.sh/cmd means that the value applies to both the mwactl.sh (UNIX Shell) and the mwactl.cmd (Win NT) scripts. (Continued in next page)

11i
Functionality Name of the file Location Usage Location Modify configuration parameters like: a) DBC File location b) Log level and Log files location c) Default Telnet ports d) Dispatcher configuration etc. mwa.cfg

R12
Usage

$MWA_TOP/sec Modify the corresponding ure parameters in the file $INST_TOP/admin/install

Modify the corresponding parameters in the file Modify the corresponding parameters in the file $INST_TOP/admin/install Modify the corresponding parameters in the file $INST_TOP/admin/install mwamscasv.sh /cmd username/pass word $INST_TOP/admin/install

Modify Device Key configuration mapping deviceIP.ini

$MWA_TOP/sec Modify the corresponding ure parameters in the file

Modify MWA Device Profile options

default_key.ini,gui $MWA_TOP/sec Modify the corresponding _key.ini ure parameters in the file $APPL_TOP/pro dcomn/admin/ins mwamscasvc.sh/c tall/<s_contextna mwamscasv.sh/cmd md me>/ username/password

Register MWA Services with GSM Framework

5. Details of Changes Security

In 11i, the system received the UserName and Password as command line arguments from the respective scripts. These were used to connect to the applications database. Passing the UserName and Password as command line arguments has the disadvantage of allowing them to be visible in the process table of the environment. In R12, all the scripts that previously accepted the input parameters in the command line now accept these parameters in the following ways: o o Existing format: <script_name> <command> username/password Secure format (for UNIX shell scripts): o o o o <script_name> <command> <Enter key> <username> <Enter key> <password> <Enter key>

Secure format (for NT scripts): o o <script_name> <command> <Enter key> <username>/<password> <Enter key>

This applies to all scripts that accepted the Username and Password instead of command lines as well. Note: These enhancements do not affect the existing use of the scripts. The following table provides the details.

Functionality Valid usage in 11i

Valid usage(s) in R12

a) mwactl.sh/cmd -login adminuser/password stop_force <port_number> b) mwactl.sh stop_force <port_number> <Enter> username <Enter> password <Enter> mwactl.sh/cmd -login adminuser/password stop_force <port_number> c) mwactl.cmd stop_force <port_number> <Enter> username/password <Enter> a) mwactl.sh/cmd -login adminuser/password stop <port_number> b) mwactl.sh stop <port_number> <Enter> username <Enter> password <Enter> Shutting down mwactl.sh/cmd -login adminuser/password c) mwactl.cmd stop <port_number> <Enter> the MWA stop <port_number> username/password <Enter> Server (Continued in next page)

Functionality Valid usage in 11i

Valid usage(s) in R12 a) mwactl.sh/cmd -login adminuser/password killsession <session_name> <port_number> b) mwactl.sh killsession <session_name> <port_number> <Enter> username <Enter> password <Enter>

Kill a user's MWA Session

mwactl.sh/cmd -login adminuid/password killsession <session_name> <port_number>

c) mwactl.cmd killsession <session_name> <port_number> <Enter> username/password <Enter> a) mwamscasvc.sh/cmd username password b) mwamscasvc.sh -nopromptmsg <Enter> username <Enter> password <Enter> c ) mwamscasvc.cmd -nopromptmsg <Enter> username/password <Enter>

Register MWA Services with GSM Framework mwamscasvc.sh/cmd username password

6. Details of Changes Autoconfig Engine

Autoconfig Wrapper Scripts In R12, Autoconfig manages all MWA services. Because the Autoconfig engine cannot directly use the existing scripts, wrapper scripts were created for the Autoconfig engine to use. The wrapper scripts use the existing MWA scripts to manage services.

The Autoconfig engine uses the following wrapper scripts: o o $INST_TOP/admin/scripts/mwactlwrpr.sh $INST_TOP/admin/scripts/mwactlwrpr.cmd

These scripts are to be used only by the Autoconfig engine. These scripts do not change the existing use of any other scripts. Autoconfig Scripts The Autoconfig scripts stopall (adstpall.sh) and startall (adstrtal.sh) manage MWA services when the following configuration parameters are set to enabled in the environment context file (<APPL_TOP>/admin/<CONTEXT_NAME>.xml): o o s_other_service_group_status s_mwastatus

The default value of these parameters is disabled. Set the parameters to enabled prior to running Autoconfig. See Oracle Applications Maintenance Utilities and Oracle Applications Maintenance Procedures for detailed instructions on managing configuration parameters and server processes using Autoconfig.

10

7. Document Reference
7.1 Document References

Document Name Oracle Applications Upgrade Guide: Upgrading from Release 11i to Release 12

Comments See: Post-Upgrade Tasks for Supply Chain Management

Using AutoConfig to Manage System Configurations with Oracle Applications 11i Note: This document is also valid for Oracle Applications Release 12.

OracleMetalink note 165195.1

11

8. FAQ
In R12, where do I find the scripts for startup and shutdown of the MWA server? Script files for MWA server admin activities are available under $INST_TOP/admin/scripts directory. The names of the files remain unchanged from 11i.

I want to change a few configuration parameters in mwa.cfg. I also want to make some device related changes in default_key.ini. Where do I find these files? All configuration and parameter files are available in the $INST_TOP/admin/install directory.

Are there any changes to the MWA Dispatcher in R12? The MWA Dispatcher location and use has not changed in R12.

Will the enhancements made for security and Autoconfig engine change the existing use of MWA-related scripts? No, the enhancements provided do not change the existing use of these scripts. These changes introduced improved ways of using these scripts.

12

White Paper: Mobile Application Server Changes in R12: Administrators Guide January 2007 Author: Ashwin Kumar Chandrasekaran Reviewers: Wilson Lau, Ben Chihaoui OracleMetaLink note 394495.1 Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores, CA 94065 U.S.A. Worldwide Inquiries: Phone: +1.650.506.7000125 Fax: +1.650.506.7200 www.oracle.com Oracle Corporation provides the software that powers the internet. Oracle is a registered trademark of Oracle Corporation. Various product and service names referenced herein may be trademarks of Oracle Corporation. All other product and service names mentioned may be trademarks of their respective owners. Copyright 2000 Oracle Corporation All rights reserved.

13