Difference between revisions of "Samba Installation"

From VSI OpenVMS Wiki
Jump to: navigation, search
(Cluster Considerations)
(Cluster Considerations)
Line 42: Line 42:
 
= Cluster Considerations =
 
= Cluster Considerations =
  
Samba can run on multiple cluster members simultaneously, either in coordination with other cluster members or independent of other cluster members. When multiple cluster members share the same Samba installation directory - SAMBA$ROOT: - they are considered to be in the same Samba cluster.  Thus, multiple instances of Samba may run simultaneously in the same cluster.
+
Samba can run on multiple cluster members simultaneously, either in coordination with other cluster members or independent of other cluster members. When multiple cluster members share the same Samba installation directory (defined by the SAMBA$ROOT logical name), they are considered to be in the same Samba cluster.  To allow multiple cluster members to share the same SAMBA$ROOT: directory tree, install Samba on a device which may be mounted on all applicable cluster members.
  
Each instance of Samba requires a unique Samba cluster alias name (set during configuration).  Samba cluster members sharing the same SAMBA$ROOT installation directory must use the same Samba cluster alias name.
+
Each Samba cluster requires a unique Samba cluster alias name (set during configuration) which is shared by the members of that Samba clusterThe Samba cluster alias name may be specified by clients when establishing sessions to the Samba cluster, in addition to the hostname or IP address of each cluster member.
  
 
CAUTION:  While multiple instances of Samba may run simultaneously in a cluster, multiple instances should not allow access to the same files as no lock coordination occurs between Samba instances. Administrators who ignore this recommendation risk file corruption.
 
CAUTION:  While multiple instances of Samba may run simultaneously in a cluster, multiple instances should not allow access to the same files as no lock coordination occurs between Samba instances. Administrators who ignore this recommendation risk file corruption.

Revision as of 20:57, 21 May 2020

Pre-installation Tasks

The following tasks must be accomplished prior to installing Samba.

In a cluster, these tasks must be completed on each cluster member that will run Samba.

  • Verify the system is running a supported VSI OpenVMS version

Samba is supported on:

VSI OpenVMS i64 v8.4-1H1 and newer
VSI OpenVMS Alpha v8.4-2L1 and newer
  • The system must be running one of the following TCP/IP stacks:
TCP/IP Services for OpenVMS
VSI TCP/IP
Multinet
TCPware


  • The SYSGEN parameter PROCSECTCNT must be a minimum of 512
  • The SYSGEN parameter CHANNELCNT must be a minimum of 2560

If necessary, add the following lines to SYS$SYSTEM:MODPARAMS.DAT, AUTOGEN, and reboot the system:

MIN_PROCSECTCNT = 512
MIN_CHANNELCNT = 2560
  • The software must be installed and used on an ODS-5 file system.

The software cannot be installed on an ODS-2 file system and ODS-2 file systems cannot be used for file shares. If migrating from CIFS for OpenVMS, if CIFS is installed on an ODS-2 volume, convert the volume to ODS-5 before installing Samba. Alternately, move CIFS for OpenVMS to an ODS-5 volume as documented in the CIFS for OpenVMS Administrator Guide.

  • The OpenVMS internationalization data kit (VMSI18N) must be installed in order for Samba to be able to correctly support international characters in file names

Cluster Considerations

Samba can run on multiple cluster members simultaneously, either in coordination with other cluster members or independent of other cluster members. When multiple cluster members share the same Samba installation directory (defined by the SAMBA$ROOT logical name), they are considered to be in the same Samba cluster. To allow multiple cluster members to share the same SAMBA$ROOT: directory tree, install Samba on a device which may be mounted on all applicable cluster members.

Each Samba cluster requires a unique Samba cluster alias name (set during configuration) which is shared by the members of that Samba cluster. The Samba cluster alias name may be specified by clients when establishing sessions to the Samba cluster, in addition to the hostname or IP address of each cluster member.

CAUTION: While multiple instances of Samba may run simultaneously in a cluster, multiple instances should not allow access to the same files as no lock coordination occurs between Samba instances. Administrators who ignore this recommendation risk file corruption.

Installation (and Upgrade)

Post-installation Tasks

Resolving Common Issues