APRM(1)                                                                APRM(1)



NAME
       aprm - Automatic Partition Resource Manager

SYNOPSYS
       aprmagent

DESCRIPTION
       APRM  provides  continuous,  automatic  resource  tuning  among  OS/400
       (i5/OS) partitions on LPAR configured iSeries  and  i5  systems.   APRM
       continually  monitors  memory,  processor, and interactive activity, to
       ensure optimal resources are made available to every partition -  with-
       out operator intervention!

       APRM version V5R3M1 also supports Linux partitions' resource management
       to the extent that your version of Linux supports them.

       Thus, your iSeries server works more efficiently and smarter to achieve
       more without upgrading system resources

RESTRICTIONS
       APRM capabilities are limited to the dynamic LPAR functionality allowed
       within Linux partitions on both iSeries and i5 servers.  They are  also
       controlled  by  the  version  of  Linux being used.  Currently, all the
       Linux distributions support  dynamic  changes  to  CPU  power.   Memory
       changes  are  still  "promised"  and, of course, there is no concept in
       Linux of interactive CPW capability.  When setting-up tuning rules  for
       a  Linux  partition, set the upper and lower limit for interactive % at
       zero and, if your Linux distribution does not  support  dynamic  memory
       changes, set the lower and upper limits for memory to the same value as
       the "current" memory in that partition.

       Dynamic changes to I/O slots is not yet defined in a Linux  environment
       and,  as well, Linux does not use an IOP to control IOAs.  If your ver-
       sion of Linux does allow dynamic I/O slot assignments, then you may use
       the  MOVAPRMRSC  command  in an i5/OS partition to move the IOP and its
       attached IOAs to/from a Linux partition but the ACQAPRMDEV command  may
       fail  because  there  is  no mechanism to ask the APRM agent in a Linux
       partition to "let go" of the hardware - this  needs  to  be  done  with
       native Linux commands.



STARTING APRM
       Once you have installed and configured APRM on your Linux partition you
       must start the application. To do so,  you  have  to  be  signed-on  as
       "root" to start APRM.

       To start APRM in a Redhat Linux partition, enter:
       /etc/rc.d/init.d/aprm start

       To start APRM in a SuSE Linux partition, enter:
       /usr/sbin/rcaprm start

       After  APRM is installed, it will start with every system IPL automati-
       cally until APRM is removed from the system.


STOPPING APRM
       Periodically, it may be necessary to end APRM within a Linux partition.
       Use one of the following commands to stop it.

       To end APRM in a Redhat Linux partition, enter:
       /etc/rc.d/init.d/aprm stop

       To end APRM in a SuSE Linux partition, enter:
       /usr/sbin/rcaprm stop



RESTARTING APRM
       If  you reconfigure APRM, restart APRM to force it to take the new con-
       figuration information:

       To restart APRM in a Redhat Linux partition, enter:
       /etc/rc.d/init.d/aprm restart

       To restart APRM in a SuSE Linux partition, enter:
       /usr/sbin/rcaprm restart


CONFIGURING APRM
       For information about configuring APRM, see aprm.conf(1)


SEE ALSO
       aprm.conf(1) - Information about configuring APRM




                                   Aprmagent                           APRM(1)