Maintenance Mode

Maintenance Mode - A New Feature in 11.5.10

Maintenance Mode is a new mode of operation introduced with Release 11.5.10, in which the
Oracle Applications system is made accessible only for patching activities not allowing the users
to login to any responsibility. This provides optimal performance for AutoPatch sessions, and
minimizes downtime needed.

1. Scheduling System Downtime

Administrators can schedule 'System Downtime' using Oracle Applications Manager (OAM):
Site Map --> Maintenance --> Manage Downtime Schedules
When the System has been scheduled for 'Downtime', Apache should be re-started on Restricted Mode
by using the Script (adaprstctl.sh).  By doing this, users attempting to log on to Oracle Applications will
be automatically redirected to a System Downtime URL showing a message similar to the following one:

Scheduled Downtime Details

Start Time       : 17:30:00 12/11/2012
Expected Up Time : 09:00:00 12/12/2012
For Updates      : sonujha86@gmail.com

The system is currently undergoing a scheduled maintenance.
<Current Status>
This message can be customized with any text message.  If No Downtime has been specified, and the users
try to access the Applications, the following message might also appear:
! Warning
The system has not been taken off maintenance mode completely.
Please contact your System Administrator.

2. Advantages
There are several practical points relating to the use of Maintenance Mode:

• You can toggle Maintenance Mode between Enabled and Disabled using the new Change Maintenance

           Mode menu in AD Administration, or the equivalent function in Oracle Applications Manager.

• Although you can run AutoPatch with Maintenance Mode disabled, there will be a significant

          degradation in performance.

• There is a separate logon page for Restricted Mode access while the system is in Maintenance Mode.

For more Information on Restricted Mode Access

3. Enabling and Disabling Maintenance Mode
Maintenance mode is Enabled or Disabled from adadmin.
When you Enable or Disable 'Maintenance Mode', adadmin will execute the script:
$AD_TOP/patch/115/sql/adsetmmd.sql sending the parameter 'ENABLE' or 'DISABLE' :
sqlplus <APPS_Schema name>/<APPS Password>@adsetmmd.sql ENABLE | DISABLE
    ENABLE  -   Enable Maintenance Mode .
    DISABLE -   Disable Maintenance Mode.
When adsetmmd.sql runs, it sets the Profile Option 'Applications Maintenance Mode'
(APPS_MAINTENANCE_MODE) to 'MAINT' to Enable 'Maintenance Mode' and to 'NORMAL' to Disable it.

4.  Determining if Maintenance Mode is Running

A quick way to verify if the Environment is on Maintenance Mode or not, is by checking the value of this Profile Option as follows:
sqlplus apps/apps

SQL> select fnd_profile.value('APPS_MAINTENANCE_MODE') from dual;

If the query returns 'MAINT', then Maintenance Mode has been Enabled and the Users will not be able to
Login.  If the query returns 'NORMAL' then Maintenance Mode has been De-Activated and the Users will be
able to use the application.
Note:  Maintenance Mode is only needed for AutoPatch Sessions. Other AD utilities do not require
Maintenance Mode to be enabled. Maintenance Mode must be 'Enabled' before running AutoPatch
and 'Disabled' after the patch application was completed.
When Maintenance Mode is disabled, you can still run Autopatch by using options=hotpatch on the
command line, if necessary.  However, doing so can cause a significant degradation of performance.

5. Error Messages
Always remember to Disable Maintenance Mode after any Patch application. If Maintenance Mode is not
Disabled, the Application will not allow the users to use the system.  Take note that Apache must be
re-started in
 normal mode after disabling 'Maintenance Mode' by using the Script adapcctl.sh (or adstrtal.sh)

As explained before, when 'Maintenance Mode' is enabled, a Downtime should be Scheduled from OAM and Apache should be started on Restricted Mode by using the Script (adaprstctl.sh).

If a 'DownTime' is not Scheduled from OAM and Apache has not been re-started on Restricted Mode,
the Application will allow the users to Login, but it might experience unusual behaviors afterwards
depending on the Patch Level.

Here are some examples of the possible error messages:

• When clicking on a Responsibility from the PHP

There are no applications available for this responsibility.  Please click on a different responsibility
link to display the list of available applications.
or
You are not authorized to access the function Applications Home Page.  Please contact your System
Administrator.

• When trying to access to the Application via CGI directly (not supported):

There are no valid navigations for this responsibility
Cause: The menu compilation has failed.
Cause: There is not valid menu defined for this responsibility.
Cause: There are no navigable forms associated with this responsibility.
Action: Contact your system administrator. Ensure that a valid menu,
containing navigable forms, is defined for the responsibility.
Ensure that the menu is correctly compiled.
Note:  In some cases, the behavior is slightly different.  Instead of showing the above messages, the
Application might not show any Responsibilities listed for the user at all.

6. Step by Step Process

1.  Schedule the 'System Downtime' from OAM
OAM: Site Map --> Maintenance --> Manage Downtime Schedules

At the moment of the downtime, do the following: 

2.  Shutdown Apache (on Normal Mode):
   adapcctl.sh stop
   or
   adstpall.sh <apps_user>/<apps_pwd>

3.  Enable 'Maintenance Mode' from adadmin
   adadmin: Options 5, 1

4. Start Apache (on Restricted Mode)
   adaprstctl.sh start

5. Apply the Patch with adpatch

6.  Stop Apache (on Restricted Mode)
  adaprstctl.sh stop

7.  Disable 'Maintenance Mode' from adadmin
   adadmin: Options 5, 2

8.  Start Apache (on Normal Mode):
  adapcctl.sh start
  or
  adstrtal.sh <apps_user>/<apps_pwd>