Preface

The Software Release Bulletin: OpenSSL and OpenSSH Release 2.0.0 for VOS (R521) documents the implementation of the product OpenSSL and OpenSSH Release 2.0.0. To install and use OpenSSL and OpenSSH Release 2.0.0, you need one of the following minimum operating-system releases:

  • VOS Release 15.1.1 (for ftServer V 100, V 200, and V 400 systems)
  • VOS Release 16.1.0 (for ftServer V 150, V 250, V 300, V 500, and V 502 systems)
  • OpenVOS Release 17.0.0 (for ftServer V 2302, V 4304, and V 6308 systems)

To rebuild OpenSSL and OpenSSH Release 2.0.0 from source code, you need one of the following minimum releases:

  • VOS Release 15.1.2ax
  • VOS Release 15.2.0ag
  • VOS Release 15.3.0
  • VOS Release 16.1.0

OpenSSL and OpenSSH Release 2.0.0 includes the following software:

  • OpenSSL Version 0.9.7e
  • OpenSSH Version 3.9p1
  • zlib 1.2.1, an open source compression/decompression library

This manual does not describe OpenSSL or OpenSSH in detail; it describes how to install and configure the VOS implementation. See Related Manuals for detailed information about OpenSSL and OpenSSH.

This manual is intended for people who administer a network of Stratus VOS modules, or who administer a single Stratus VOS module. It may also be useful for people who are developing distributed applications or networking software that require a secure socket connection and the ability to encrypt messages.

Before you use the product OpenSSL and OpenSSH Release 2.0.0 for VOS, make sure you have a working knowledge of the following software (for a list of the documentation, see Related Manuals):

  • OpenSSL, or access to the OpenSSL Project documentation
  • OpenSSH, or access to the OpenSSH Project documentation
  • VOS POSIX and access to POSIX documentation

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.

This revision incorporates the following changes.

Manual Organization

This manual contains the following chapters and appendix.

  • Chapter 1 provides an introduction to the product OpenSSL and OpenSSH Release 2.0.0 for VOS.
  • Chapter 2 describes how to install and use the product OpenSSL and OpenSSH Release 2.0.0 for VOS.
  • Chapter 3 explains how to rebuild OpenSSL and OpenSSH from source code.
  • Appendix A presents licenses for the products.

Related Manuals

Refer to the following Stratus manuals for related documentation.

  • OpenVOS System Administration: Configuring a System 
  • Software Release Bulletin: OpenVOS GNU Tools Release 3.4 
  • OpenVOS Standard C Reference Manual 
  • OpenVOS POSIX.1 Reference Guide 
  • OpenVOS POSIX.1: Conformance Guide —A document that describes the implementation differences in VOS POSIX.1 versus the POSIX.1 Standard; this document is available only on the StrataDOC Web site.

Refer also to the following third-party documentation.

  • Information Technology—Portable Operating System Interface (POSIX)—Part 1: System Application Program Interface (API)
    [C Language]    , International Standard ISO/IEC 9945-1: 1996 (E), IEEE Std 1003.1, 1996 Edition
  • OpenSSL documentation, provided by the OpenSSL Project at http://www.openssl.org/docs and available in the >system>openssl>doc directory on the module.
  • OpenSSH documentation, provided by the OpenSSH Project at http://www.openssh.org/manual.html. Trade publications, such as the following two books, are also informative:

- Himanshu Dwivedi. Implementing SSH: Strategies for Optimizing the Secure Shell, Wiley Publishing, Inc., Indianapolis, Indiana, 2004.

- Daniel J. Barrett and Richard E. Silverman. SSH, the Secure Shell: The Definitive Guide, O'Reilly & Associates, Inc., Sebastopol, California, 2001.

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

The following typographical conventions are used in this manual:

  • 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  *.*

Online Documentation

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

You can access the OpenVOS StrataDOC Web site at http://stratadoc.stratus.com. A copy of OpenVOS StrataDOC on supported media is included with this release. You can also order additional copies from Stratus.

This manual is available on the OpenVOS StrataDOC Web site.

For information about ordering OpenVOS StrataDOC on supported media, see the next section, 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 OpenVOS System Administration: Administering and Customizing a System  and the OpenVOS 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, R521, 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.