Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

config                                                                  config


NAME
     config - create a configuration file

SYNOPSIS
     config -s AA -c config_file

DESCRIPTION
     Config is an interactive tool for creating configuration files. A confi-
     guration file defines a configuration of software products, that can be
     installed.  Configuration files are used to direct the install tool,
     which performs the actual installation.

   Options
     The config tool has two required command line options.

     -s AA
          The -s option is used to specify the Authorized Area that contains
          the products to be configured.  The config tool uses the release
          indexes for the products in the Authorized Area at AA and any con-
          straints imposed by active override files in the
          AA/install/overrides directory as sources for the configuration
          questions it asks.

     -c config_file
          The -c option is used to specify the pathname of the configuration
          file that config creates or modifies.  The product configuration you
          establish by using config is stored in config_file.  to be created.

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

     abort
          Exit the config tool.  Do not modify the configuration file with
          input from the config session.  Discard your input.

     configure product_name [product_version]
          Configure the product named product_name.  The configure command
          causes the config tool to present configuration questions as defined
          in the product release index, and constrained by the active override
          file if one exists for the product.  The config tool asks only the
          questions not already answered in the configuration file specified
          on the command line.  You can abbreviate your responses to the con-
          figuration questions to the point of uniqueness.

     deselect product_name [product_version]
          Deselect a selected product.  The product named in product_name is
          removed from the configuration.

     exit Exit the config tool, and modify the configuration file named on the
          command line to reflect the results of the config session.  Any
          unanswered questions for selected products are given the default
          answers defined in the release index.

     help Display a summary of the commands accepted at the CONFIG prompt.

     install checking product_name [product_version] type
          Set the type of configuration checking to perform at installation
          time for the product named product_name to type. There are three
          possible values for the type argument:

          none Ignore any customization of the software already installed on
               the target node.

          exist
               Install the constituent objects of the product named
               product_name only if they already exist on the target node.
               Use this type of install checking to prevent replacing objects
               that were deliberately deleted since a previous installation.

          version
               Install an object only if the version in the product named
               product_name differs from the version already installed on the
               node.  This type of install checking implies install checking
               exist.  An object is not installed if the object does not
               already exist on the target node.

     reconfigure product_name [product_version]
          Reconfigure the product named product_name.  Ignore any configura-
          tion information already in the configuration file, or established
          during the config session.  The reconfigure command causes the con-
          fig tool to present all the configuration questions defined in the
          product release index as constrained by the active override file if
          one exists for the product.  You can abbreviate your responses to
          the configuration questions to the point of uniqueness.

     select product_name [product_version]
          Select version product_version of the product named product_name.
          You must select a product with the select command before you can
          configure it with the configure command.  The selected product is
          added to the configuration to be installed.

     select all
          Select the latest version of all products in the Authorized Area at
          AA as displayed by the show available command.

     show available
          Display a list of products available for installation from the
          Authorized Area at AA.  The show available command lists the version
          numbers of each product together with its name.

     show queries product_name [product_version]
          Display all configuration queries for the product named product_name
          together with their current answers.  You can use the configure and
          reconfigure commands to change the answers shown by the show queries
          command.

     show selections
          Display the products selected for installation.  Use the select com-
          mand to add to the list of selected products; use the deselect com-
          mand to remove a product from the list displayed by the show selec-
          tion command.

     update product_name [product_version]
          Deselect all previous versions of the product named product_name,
          and then select the latest version of the same product from the
          Authorized Area.

     update all
          Deselect all previous versions of all available products, and then
          select the latest versions of all products available in the Author-
          ized Area.

     validate product_name [product_version]
          Determine whether installation of the product named product_name
          from the Authorized Area at AA will succeed with the current
          configuration.

EXAMPLES
     config -s //sr10_node  -c //mynode/config_file
     This command begins a configuration session for the products in the
     Authorized Area at //sr10_node.  The config tool will use the configura-
     tion defined in //mynode/config_file as the starting point for the con-
     figure command, or create a configuration file there if one does not
     already exist.

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

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

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

     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.

NOTE
     The config program is invoked by the install++ program during its
     interactive configuration phase.

     See AA/install/help/install++.hlp for more information.

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