chkcomp

PURPOSE

     Checks compatability between a code server and an active-
     service client.

SYNOPSIS
     chkcomp -n node -w directory


DESCRIPTION

     The chkcomp  command checks compatibility between  a code
     server  and  an  active-service  client  before  allowing
     active service.   Generally, this  command is run  by the
     chngstate command.   You must be  a member of  the system
     group or  operating with superuser authority  to run this
     command.

      When the command runs,  it compares one or more programs
     installed  at the  code server  to a  program or  program
     subset installed  at the client and  identifies incompat-
     ibilities
      between version,  release, or level.  If  the client and
     server are  compatible, chkcomp ends.  If  the client and
     server are not compatible, chkcomp writes a comprehensive
     set of install and update orders to a cs.compat file.

     There are two types of incompatibilities.  Incompatibili-
     ties that can  be fixed by the  system and incompatibili-
     ties that  require manual  intervention.  These  types of
     incompatibilities are handled in the following manner:

     o   If the  incompatibilities can be fixed  by the system
         and the  upgrade mode is automatic,  the system auto-
         matically initiates  the required install  and update
         orders.
     o   If the  incompatibilities can be fixed  by the system
         and the  upgrade mode is manual,  the system displays
         the list of required manual actions.
     o   If  the  incompatibilities  cannot be  fixed  by  the
         system, the  client defaults to stand-alone  mode and
         the user  is responsible for initiating  the required
         install and  update actions (orders in  the cs.compat
         file) to resolve the incompatibilities.

     The upgrade  mode is set  by a value in  the serverattach
     file or  by -m flag  to the chngstate command.   For more
     information on the compatibility rules and which types of
     incompatibilities can  be fixed  by the system,  see Man-
     aging the AIX Operating System.

FLAGS

     -n node        Specifies the  node id or nickname  of the
                    code  server.   This  flag  and  node  are
                    required and must be specified.
     -w directory   Specifies  the  directory  on  the  client
                    where the  code server's root  file system
                    is  mounted.   This  mount  must  be  done
                    before chkcomp is run.   If chkcomp is run
                    from the  chngstate command, the  mount is
                    done for you.  If  you want to run chkcomp
                    directly, you  must run the  mount command
                    before you run  the chkcomp command.  This
                    flag and  directory are required  and must
                    be specified.

EXAMPLE

         To create and mount a directory where a code server's
         root file  system can  reside on  your system  and to
         check compatibility between the  code server and your
         system:

           mkdir /tmp/nick
           mount -n darlene / /tmp/nick
           chkcomp -n darlene -w /tmp/nick

         This makes  the directory  "/tmp/nick", mounts  the /
         (root) directory of the code server "darlene" on this
         directory, and  then checks the compatibility  of the
         code server and your system.

FILES

     /etc/codeserve/cs.compat       Contains   information  on
                                    client and  server compat-
                                    ibility.
     /etc/codeserve/serverattach    Contains    code   service
                                    attribute information.
     /usr/lpp/lpp_name/lpp.hist     Contains history files for
                                    both  the code  server and
                                    the client
     /vrm/lpp/lpp_name/lpp.hist     Contains history files for
                                    both  the code  server and
                                    the client systems.

RELATED INFORMATION

     The following command:  "chngstate."

     The  /etc/codeserve/servattach  file   in  AIX  Operating
     System Technical Reference.

     The    discussion    of     code    service    and    the
     /etc/codeserve/cs.compat file  in Managing the  AIX Oper-
     ating System.