Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ cfgsa — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

cfgsa                                                                    cfgsa


NAME
     cfgsa - create selection and override files

SYNOPSIS
     cfgsa AA

DESCRIPTION
     The cfgsa tool creates selection files and override files based on the
     release indexes in the Authorized Area at AA.  Selection files are used
     with distaa to load subsets of products from distribution media into an
     Authorized Area.  Override files are used with config or install++ to
     constrain product configurations to a subset of those permitted by the
     product release indexes.

     The cfgsa tool uses the release indexes for the products in the Author-
     ized Area at AA as the source of its configuration questions.  The save
     command to cfgsa places the override file it creates into the
     install/overrides directory of this Authorized Area.

     The cfgsa tool is interactive and accepts the following commands at its
     CFGSA> prompt.

   Commands
     Although they are shown here in lowercase, you can enter cfgsa commands
     in upper, lower, or mixed case.  You can also abbreviate them to the
     point of uniqueness.  The cfgsa tool accepts the following commands at
     its CFGSA> prompt:

     available
          Display a list of all the products in the Authorized Area at AA.
          This is the list of products you can choose from with the select
          command.  The cfgsa tool executes an available command whenever it
          starts up.

     constrain
          Begin a constraint session for the selected product.  (see the
          select command below).  The constrain command causes cfgsa to
          present the series of configuration questions defined by the release
          index, and constrained by the current active override file for the
          product, if one exists.  After displaying each question, cfgsa
          presents three types of possible constraints:

          user Allow the user the full range of choices permitted by the
               release index for the product at configuration time.  This is
               the default constraint type selected by hitting <RETURN> at the
               constraint type prompt.

          limit
               Limit the user to a subset of the choices permitted by the
               release index.  Choosing limit causes cfgsa to display the set
               of responses to the question allowed by the release index.  You
               can then choose a subset of those responses to be presented at
               configuration time.

          answer
               Answer the question for the user.  at configuration time.
               Choosing answer causes cfgsa to display the set of responses to
               the question allowed by the release index.  The response you
               choose becomes the answer to the configuration question posed
               by the release index, and the user will not see the question at
               configuration time.

          The CFGSA> prompt returns after all of the configuration questions
          posed by the release index have been presented for constraint.  A
          constraint session can be terminated early by using the abort com-
          mand.

     exit Exit the cfgsa tool.  If you have not yet saved all the constraints
          you have made, cfgsa asks for confirmation before terminating.

     generate template
          Create a selection file, named aa.template, and a matching override
          file named ov.template, for the selected product in the current
          working directory.

     help Display a summary of the cfgsa commands accepted at the current
          prompt.

     revert
          Remove all constraints imposed on the selected product during the
          current cfgsa session.

     save Save the constraints imposed on the selected product in the active
          override file for the product in the authorized area at AA.  If
          there already is an active override file for the product in the
          Authorized Area, cfgsa will ask you to confirm that you want to
          overwrite the existing active override file.

     select product_name product_version
          Select version product_version of the product named product_name
          from the list of available products.

     show List all of the questions in the release index for the selected pro-
          duct, together with the constraints imposed on the product confi-
          guration by the currently active override file and any choices made
          during the current cfgsa session.

EXAMPLES
     cfgsa //sr10_node/authorized_area
     Begins an interactive configuration session for the products loaded into
     the Authorized Area at //sr10_node/authorized_area.

FILES
     AA/install/tools/cfgsa
          The executable for Domain/OS systems.

     AA/install/tools_sr9/cfgsa
          The executable for pre-SR10 systems.

     AA/install/help/cfgsa.hlp
          The help file for cfgsa.

     AA/install/ri.*/ri.*
          The release indexes for products in the Authorized Area at AA.

     AA/install/overrides/ri.*
          The active override files for products in the Authorized Area at AA,
          or the override file created by the save command.

     The selection file created
          by the generate command.

     The override file created
          by the generate command.

SEE ALSO
     config.hlp, install++.hlp.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026