upserver(8)

NAME

   upserver - Initializes the server portion of the Update Server

SYNOPSIS

   upserver [<directory>+] [-crypt <directory>+]
       [-clear <directory>+] [-auth <directory>+] [-help]

DESCRIPTION

   The upserver command initializes the server portion of the Update
   Server (the "upserver" process). In the conventional configuration, its
   binary file is located in the /usr/lib/openafs directory on a file
   server machine.

   The upserver command is not normally issued at the command shell prompt
   but rather placed into a file server machine's /etc/openafs/BosConfig
   file with the bos create command. If it is ever issued at the command
   shell prompt, the issuer must be logged onto a database server machine
   as the local superuser "root".

   The upserver command specifies which of the directories on the local
   disk are eligible for distribution in response to requests from the
   client portion of the Update Server (the upclient process) running on
   other machines. If no directories are specified, the upserver process
   distributes the contents of any directory on its local disk.

   The upserver process can distribute a directory's contents in encrypted
   or unencrypted form. By default, it does not use encryption unless an
   upclient process requests it (this default is equivalent to setting the
   -clear flag). When the -crypt flag is provided, the upserver process
   only fulfills requests for encrypted transfer.

   The upclient and upserver processes always mutually authenticate,
   whether or not the data they pass is encrypted; they use the key with
   the highest key version number in the /etc/openafs/server/KeyFile file
   to construct a server ticket for mutual authentication.

   This command does not use the syntax conventions of the AFS command
   suites. Provide the command name and all option names in full.

CAUTIONS

   Do not use the Update Server to distribute the contents of the
   /etc/openafs/server directory without the -crypt flag.  The contents of
   this directory are sensitive.

OPTIONS

   <directory>+
       Names each directory to distribute in unencrypted form (because
       they appear before the first -crypt or -clear flag on the command
       line). If this argument is omitted, all directories on the
       machine's local disk are eligible for distribution.

   -crypt <directory>+
       Precedes a list of one or more directories that the upserver
       process distributes only in encrypted form.

   -clear <directory>+
       Precedes a list of one or more directories that the upserver
       process distributes in unencrypted form unless the upclient process
       requests them in encrypted form. Use this argument only if a list
       of directories headed by the -crypt flag precedes it on the command
       line.

   -auth <directory>+
       Precedes a list of one or more directories which the upserver
       process distributes using a form of encryption that is intermediate
       in complexity and security between the unencrypted and encrypted
       levels set by the -clear and -crypt arguments. Do not use this
       argument, because the upclient process does not have a
       corresponding argument that it can use to request data transfer at
       this level.

   -help
       Prints the online help for this command. All other valid options
       are ignored.

EXAMPLES

   The following example bos create command defines and starts an upserver
   process on the host machine "fs1.abc.com". The last parameter (enclosed
   in quotes) instructs the upserver process to distribute the contents of
   the /usr/lib/openafs directory in unencrypted form and the contents of
   the /etc/openafs/server directory in encrypted form.

      % bos create  -server fs1.abc.com -instance upserver -type simple \
          -cmd "/usr/lib/openafs/upserver /usr/lib/openafs -crypt /etc/openafs/server"

PRIVILEGE REQUIRED

   The issuer must be logged in as the superuser "root" on a file server
   machine to issue the command at a command shell prompt. It is
   conventional instead to create and start the process by issuing the bos
   create command.

SEE ALSO

   BosConfig(5), bos_create(8), upclient(8)

COPYRIGHT

   IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

   This documentation is covered by the IBM Public License Version 1.0.
   It was converted from HTML to POD by software written by Chas Williams
   and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.