Preface

The Software Release Bulletin: VOS Samba Release 3.0 (R470) describes how to install and configure version 3.0 of the Samba file server for VOS Release 15.1.0 or a later release. It documents the system requirements for running this software and the procedures for installing it.

This manual is intended for system administrators who will install this product as well as people who will use it.

Manual Version

This manual is a revision. Change bars, which appear in the margin, note the specific changes to text since the previous publication of this manual.

In this revision, the following information has been updated.

  • the release number and release contents
  • supported features
  • the number of required free disk blocks
  • how you obtain VOS Samba as well as how you install and configure it

Note that the sample commands for starting the Samba daemons have changed so that you can use them with either Samba Release 2.1 or Samba Release 3.0.

  • the list of documentation

In addition, a new appendix, Appendix B, describes how to rebuild SAMBA 3.0 for VOS from the source code.

Manual Organization

This manual contains the following chapters and appendixes.

Chapter 1 provides an overview of the VOS Samba product.

Chapter 2 describes installation and configuration procedures.

Chapter 3 provides references to Samba documentation.

Appendix A contains usage notes for VOS Samba.

Appendix B describes how to rebuild Samba 3.0 for VOS from the source code.

Appendix C contains the GNU General Public License.

Related Manuals

See the following Stratus manuals for information about basic VOS administrative procedures.

  • VOS System Administration: Administering and Customizing a System 
  • VOS System Administration: Starting Up and Shutting Down a Module or System 
  • VOS System Administration: Registration and Security 
  • VOS System Administration: Disk and Tape Administration 
  • VOS System Administration: Backing Up and Restoring Data 
  • VOS System Administration: Administering the Spooler Facility 
  • VOS System Administration: Configuring a System 

See the following Stratus manuals for additional VOS information.

  • VOS Commands Reference Manual 
  • VOS Standard C Reference Manual 
  • VOS Installation Guide 

See the VOS STREAMS TCP/IP Administrator's Guide  for information about configuring STCP on your module.

Notation Conventions

This manual uses the following notation conventions.

Warnings, Cautions, and Notes

Warnings, cautions, and notes provide special information and have the following meanings:

Warning: A warning indicates a situation where failure to take or avoid a specified action could cause bodily harm or loss of life.
Caution: A caution indicates a situation where failure to take or avoid a specified action could damage a hardware device, program, system, or data.
Note: A note provides important information about the operation of a Stratus system.

Typographical Conventions

This manual uses the following typographical conventions.

  • Italics introduces or defines new terms. For example:

The master disk is the name of the member disk from which the module was booted.

  • Boldface emphasizes words in text. For example:

Every module must have a copy of the module_start_up.cm file.

  • Monospace represents text that would appear on your terminal's screen (such as commands, subroutines, code fragments, and names of files and directories). For example:
change_current_dir (master_disk)>system>doc
  • Monospace italic represents terms that are to be replaced by literal values. In the following example, the user must replace the monospace-italic term with a literal value.
list_users -module module_name
  • Monospace bold represents user input in examples and figures that contain both user input and system output (which appears in monospace). For example:
display_access_list system_default 

%dev#m1>system>acl>system_default

w  *.*

Key Mappings for VOS Functions

VOS provides several command-line and display-form functions. Each function is mapped to a particular key or combination of keys on the terminal keyboard. To perform a function, you press the appropriate key(s) from the command-line or display form. For an explanation of the command-line and display-form functions, see the manual Introduction to VOS 

The keys that perform specific VOS functions vary depending on the terminal. For example, on a V105 ANSI terminal, you press the and keys simultaneously to perform the INTERRUPT function; on a V105/V109 EPC terminal, you press the key on the numeric keypad to perform the INTERRUPT function.

Note: Certain applications may define these keys differently. Refer to the documentation for the application for the specific key mappings.

The following table lists some VOS functions and the keys to which they are mapped on commonly used Stratus terminals. For information about the key mappings for a terminal that is not listed in this table, refer to the documentation for that terminal.

VOS Function
V105 PC/+ 106
V105 ANSI
V105/V109 EPC
CANCEL
† or * †
† or * †
CYCLE
 †
 †
CYCLE BACK
 †
-
 †
DISPLAY FORM
 † or - †
or -
 † or - †
HELP
-
-
INSERT DEFAULT
-
-
INSERT SAVED
INTERRUPT
†
-
†
NO PAUSE
 †
-
 †
†Numeric-keypad key

Online Documentation

The VOS StrataDOC Web site is an online-documentation service provided by Stratus. It enables Stratus customers to view, search, download, print, and comment on VOS technical manuals via a common Web browser. It also provides the latest updates and corrections available for the VOS document set.

You can access the VOS StrataDOC Web site at http://stratadoc.stratus.com. A copy of the VOS StrataDOC CD-ROM is included with this release. You can also order additional copies from Stratus.

This manual is available on the VOS StrataDOC Web site.

For information about ordering the VOS StrataDOC CD-ROM, see Ordering Manuals.

Ordering Manuals

You can order manuals in the following ways.

  • If your system is connected to the Remote Service Network (RSN™), issue the maint_request command at the system prompt. Complete the on-screen form with all of the information necessary to process your manual order.
  • Customers in North America can call the Stratus Customer Assistance Center (CAC) at (800) 221-6588 or (800) 828-8513, 24 hours a day, 7 days a week. All other customers can contact their nearest Stratus sales office, CAC office, or distributor; see http://www.stratus.com/support/cac/index.htm for CAC phone numbers outside the U.S.

Manual orders will be forwarded to Order Administration.

Commenting on This Manual

You can comment on this manual by using the command comment_on_manual. To use the comment_on_manual command, your system must be connected to the RSN. Alternatively, you can email comments on this manual to comments@stratus.com.

The comment_on_manual command is documented in the manual VOS System Administration: Administering and Customizing a System  and the VOS Commands Reference Manual  There are two ways you can use this command to send your comments.

  • If your comments are brief, type comment_on_manual, press or , and complete the data-entry form that appears on your screen. When you have completed the form, press .
  • If your comments are lengthy, save them in a file before you issue the command. Type comment_on_manual followed by -form, then press or . Enter this manual's part number, R470, then enter the name of your comments file in the -comments_path field. Press the key that performs the CYCLE function to change the value of -use_form to no and then press .
Note: If comment_on_manual does not accept the part number of this manual (which may occur if the manual is not yet registered in the manual_info.table file), you can use the mail request of the maint_request command to send your comments.

Your comments (along with your name) are sent to Stratus over the RSN.

Stratus welcomes any corrections and suggestions for improving this manual.