Linux

Overview of the file and print server for PowerLinux

Linux

Overview of the file and print server for PowerLinux

Note Before using this information and the product it supports, read the information in Notices on page 5.

Second Edition (October 2011) Copyright IBM Corporation 2011. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Overview of the file and print server for PowerLinux servers . . . . . . . . . 1
Configuring the file and print server . . . . . . Adding a Samba user . . . . . . . . . . . Enabling the user_xattr attribute . . . . . . . . Backing up and restoring the file and print server configuration . . . . . . . . . . . . . . Backing up the file and print server configuration Restoring the file and print server configuration . 1 1 2 2 2 2 Deleting backup files . . . . . . . . Troubleshooting the file and print server . . . Related information for the file and print server PDF file for Overview of the file and print server PowerLinux servers . . . . . . . . . . . . . . . . for . . 3 3 3 4

Notices . . . . . . . . . . . . . . . 5
Trademarks . . . . . . . . . . . . . . . 6

Copyright IBM Corp. 2011

iii

iv

Linux: Overview of the file and print server for PowerLinux

Overview of the file and print server for PowerLinux servers

Samba is an open source, free software suite that provides file and print services. Samba uses the TCP/IP protocol that is installed in the host server. When configured with this server software, the host system can share files and printers and make them accessible from client systems. The required packages for the Samba server are installed by the IBM Installation Toolkit for PowerLinux. The Samba server is configured by the IBM Installation Toolkit Simplified Setup Tool.

Supported Linux distributions

The Samba file and print server is supported by PowerLinux servers using the following Linux distributions: v Red Hat Enterprise Linux 6.1 v Red Hat Enterprise Linux 5.7 v SUSE Linux Enterprise Server 11 SP1 v SUSE Linux Enterprise Server 10 SP4

Configuring the file and print server

Follow these steps to configure Samba for use on PowerLinux servers. Use the IBM Installation Toolkit Simplified Setup Tool to configure the Red Hat Package Manager (RPM) packages by following these steps: 1. To open the Simplified Setup Tool, point your browser to: https://<server ip or hostname>:6060, where <server ip or hostname> is the IP address or host name of your system. 2. Sign in using the root user name and password. 3. In the Simplified Setup Tool, select the file and print server option and proceed through the screens.

See the Simplified Setup Tool help for details. The following RPMs are installed by the IBM Installation Toolkit for PowerLinux: v sst-core v sst-augeas v sst-fileprint v sst-fileprint-scripts The Simplified Setup Tool shows a list of files on the File and print server configuration page. These files are modified during the file and print server configuration. Samba smb.conf man page Samba smbcontrol man page Samba smbstatus man page Samba smbpasswd man page

Adding a Samba user

Follow these instructions to add your first Samba user.
Copyright IBM Corp. 2011

When security is set to user, Samba requires that you define a local account to validate the password for remote users. To add a definition for a new user, run the following command: smbpasswd -a username, where username is the user name for the user. Then, enter a password, and enter the password again for verification.

Enabling the user_xattr attribute

Enable the user_xattr attribute in order to improve performance. The IBM Installation Toolkit Simplified Setup Tool checks to see if the user_xattr attribute is enabled. If the Simplified Setup Tool discovers that user_xattr is enabled, more entries are added to the smb.conf file. If the user_xattr attribute is not enabled, the Simplified Setup Tool shows a message suggesting that you enable the user_xattr attribute for better performance. The message states:
[WARNING] You should enable user_xattr for better Samba performance.

To enable the user_xattr attribute: 1. Edit the /etc/fstab file. 2. Select any file system listed in the /etc/fstab file, and add the following entry to the mount options: user_xattr For example, in the /etc/fstab file, the fourth column has options that are used during the mount process. Multiple options are separated by commas:
/dev/disk/by-id/scsi-SAIX_VDASD_00f6773300004c000000012dc299e3c8.22-part3 / ext3 acl,user_xattr 1 1

Or, the entry might look similar to the following entry:

UUID=843b8d2e-4643-44e9-a49e-667157895b17 /boot ext4 defaults,user_xattr 1 2

3. Run the Simplified Setup Tool for the file and print server again. The Simplified Setup Tool applies the new settings to the smb.conf file.

Backing up and restoring the file and print server configuration

You can create a backup file of the file and print workload, restore a backup file, and delete backup files.

Backing up the file and print server configuration

When you configure the file and print server, you can create a backup file of the configuration. For instructions, see Configuring the file and print server on page 1. All backup files are stored in the /opt/ibm/sst/backups directory. If you uninstall IBM Installation Toolkit Simplified Setup Tool, the backup files are not uninstalled with the Simplified Setup Tool. Instead, the backup files remain in the /opt/ibm/sst/backups directory. A backup file for the file and print server consists of these files: v For Red Hat Enterprise Linux: etc/samba/smb.conf etc/rc.local v For SUSE Linux Enterprise Server: etc/samba/smb.conf etc/init.d/after.local

Restoring the file and print server configuration

You can restore the file and print server configuration by using the Simplified Setup Tool. 1. From the main menu, select Restore previous settings.

Linux: Overview of the file and print server for PowerLinux

2. Select the backup file that you want to restore and click Next. 3. Click Yes to restore the system files to the configuration specified in the backup file that you selected in the previous step.

Deleting backup files

The Simplified Setup Tool stores multiple backup files. Follow these steps to delete backup files from the Simplified Setup Tool. 1. From the main menu, select Delete backups. The Delete backup panel is shown. 2. Select the backup files that you want to delete and click Delete.

Troubleshooting the file and print server

Troubleshoot common problems with the file and print server. Problem: The IBM Installation Toolkit Simplified Setup Tool, which you want to use to configure the file and print server, does not start. Follow these steps to troubleshoot the Simplified Setup Tool: 1. Verify that the sst and uppd services are running by using the following commands: v service sst status v service uppd status The commands return the result running. 2. If the command does not return the correct result, open a terminal window, and enter the relevant command from the root directory: v service sst start v service uppd start 3. If the sst and uppd services are running correctly, but the Simplified Setup Tool still does not start, your firewall might be blocking the port that the Simplified Setup Tool uses. Check that port 6060 is enabled. 4. If port 6060 is enabled, but the problem is not solved, verify that the necessary RPMs are installed on your system. See the list of RPMs in the Configuring the file and print server on page 1 topic. Problem: After adding new disks to the system, the file and print server is not performing well. Run the Simplified Setup Tool for the file and print server again. Do not change any of the current settings. The settings are applied to your new disks, and performance improves. For more information about how to add a disk to your system, see Managing devices in the IBM Systems Hardware Information Center. Related information: Managing devices information in the IBM Systems Hardware Information Center (http://publib.boulder.ibm.com/infocenter/powersys/v3r1m5/topic/p7hdt/p7hdtkickoff.htm)

Related information for the file and print server

See the following resources for more information about the file and print server. Samba Documentation (http://www.samba.org/samba/docs/) This page lists several documentation sources for the Samba project. The Official Samba 3.5.x HOWTO and Reference Guide (http://www.samba.org/samba/docs/man/ Samba-HOWTO-Collection/) This guide provides configuration details and examples for Samba 3.

File and print server for PowerLinux servers

Samba-3 by Example (http://www.samba.org/samba/docs/man/Samba-Guide/) This book provides step-by-step implementation instructions for Samba network configurations in several environmental contexts.

PDF file for Overview of the file and print server for PowerLinux servers
Use this page to view and print a PDF of this information. To view or download the PDF version of this document, select Overview of the file and print server for PowerLinux servers (about 86 KB).

Saving PDF files

To save a PDF on your workstation for viewing or printing: 1. Right-click the PDF link in your browser. 2. Click the option that saves the PDF locally. 3. Go to the directory in which you want to save the PDF. 4. Click Save.

Downloading Adobe Reader

You need Adobe Reader installed on your system to view or print these PDFs. You can download a free copy from the Adobe Web site (www.adobe.com/products/acrobat/readstep.html).

Linux: Overview of the file and print server for PowerLinux

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Dept. LRAS/Bldg. 903 11501 Burnet Road Austin, TX 78758-3400 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Copyright IBM Corp. 2011

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol ( and ), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.

Linux: Overview of the file and print server for PowerLinux

Printed in USA