Maintenance Mode - A New Feature in 11.5.

10
Print this post
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/2004
Expected Up Time : 09:00:00 12/12/2004
For Updates      : famy2u@hotmail.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>
Posted by Famy Rasheed at 10:07 PM 
Labels: 11i