ExtremeZ IP Manual
ExtremeZ IP Manual
ExtremeZ IP Manual
Copyright
2011 GroupLogic, Incorporated, including this documentation, and any software and its file formats and audiovisual displays described herein; all rights reserved; may be used only pursuant to the applicable software license agreement; contains confidential and proprietary information of GroupLogic and/or other third parties which is protected by copyright, trade secret and trademark law and may not be provided or otherwise made available without prior written authorization. Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subdivision (c)(1)(ii) of the rights in technical data and computer software clause at DFARS 252.227-7013. Unpublished rights are reserved under the copyright laws of the United States.
Notice
The information and the software discussed in this document are subject to change without notice and should not be considered commitments by GroupLogic, Incorporated. GroupLogic, Incorporated assumes no responsibility for any errors in this document. The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of the license. No responsibility is assumed by GroupLogic, Incorporated for the use or reliability of software on equipment that is not supplied by GroupLogic or its affiliated companies. All warranties given by GroupLogic, Incorporated about equipment or software are set forth in your purchase contract, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties.
Trademarks
GroupLogic, the GroupLogic logo, ExtremeZ-IP, the ExtremeZ-IP logo, Zidget and the Zidget logo are registered trademarks of GroupLogic, Incorporated. AppleTalk, AppleShareIP, Finder, Macintosh, and Spotlight are registered trademarks and Bonjour is a trademark of Apple Computer, Inc. Microsoft, the Microsoft logo, Windows, Windows 2003, Windows Server 2008, Windows Vista, and Windows XP are registered trademarks of Microsoft Corporation. InstallShield is a registered trademark of InstallShield Corporation, a business unit of Macrovision. Adobe, the Adobe logo, and Acrobat Reader are trademarks of Adobe Systems Incorporated. Intel, the Intel logo, and Pentium are registered trademarks of Intel Corporation. Hewlett-Parkard is a registered trademark of Hewlett-Packard, Inc. The Common UNIX Printing System, CUPS, and CUPS logo are trademarks of Easy Software Products. Support for Bonjour includes software developed by the Bonjour Project http://developer.apple.com/networking/bonjour/ This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit http://www.openssl.org/. This product includes cryptographic software written by Eric Young [email protected]. Portions Copyright (c) 1995-2010 International Business Machines Corporation and others. All rights reserved. Other brands and product names are trademarks of their respective owners and are hereby acknowledged. GLI 2011.07.06 - 7.2
Table of Contents
Getting Started with ExtremeZ-IP.........................................................................9
System Requirements................................................................................................................. 9 Windows............................................................................................................................... 9 Macintosh Clients............................................................................................................... 9
Getting Help.............................................................................................................10
About This Document............................................................................................................... 11
Installing ExtremeZ-IP...........................................................................................13
Installing ExtremeZ-IP.............................................................................................................. 13 Before Installing ExtremeZ-IP......................................................................................... 13 ExtremeZ-IP and SFM................................................................................................. 13 Required Windows File Permissions for Shared Volumes.................................... 13 Sharing the Root of a Drive ....................................................................................... 13 Installing the ExtremeZ-IP Program............................................................................... 13 Sharing the Print Server Directory................................................................................. 14 Launching ExtremeZ-IP the First Time................................................................................... 14 Automatically Importing SFM and SMB Shares.......................................................... 14 SFM Shares ................................................................................................................. 14 SMB Shares.................................................................................................................. 15 Migrating SFM and SMB shares after first launch................................................ 16 Naming Conventions for SFM and SMB volumes.................................................. 16 Running ExtremeZ-IP and SFM................................................................................. 16 Installing AppleTalk................................................................................................................... 16 Using Kerberos.......................................................................................................................... 16 Troubleshooting Kerberos.......................................................................................... 17 Setting up ExtremeZ-IP Clustering......................................................................................... 17 Cluster Worksheet..................................................................................................................... 19 Installing ExtremeZ-IP on a Cluster........................................................................................ 20 Reviewing the Installation Procedure........................................................................... 20 Configuring ExtremeZ-IP Services................................................................................. 20 Creating an ExtremeZ-IP Service ............................................................................. 20 Adding an ExtremeZ-IP Service to a Cluster........................................................... 21 Creating a Windows 2003 Cluster Group....................................................................... 22 Setting Cluster Service Dependencies.................................................................... 24 Bringing the New Service Online.............................................................................. 24 Creating a Windows 2008 Cluster Group....................................................................... 24 Setting Cluster Resource Dependencies................................................................. 26 Bringing the New Resource Online.......................................................................... 27 Administering ExtremeZ-IP on a Cluster............................................................................... 27
Contents 3
ExtremeZ-IP User Manual Server Name...................................................................................................... 37 AppleTalk............................................................................................................ 37 Bonjour............................................................................................................... 37 Zidget/HTTP....................................................................................................... 37 Port...................................................................................................................... 38 Master Server.................................................................................................... 38 Location.............................................................................................................. 38 Description......................................................................................................... 38 SLP....................................................................................................................... 38 Register Service Connection Point................................................................ 38 DFS................................................................................................................................. 38 Namespaces...................................................................................................... 38 Target Servers................................................................................................... 39 Logging.......................................................................................................................... 39 Verbose logging options.................................................................................. 39 Enable Windows Error Reporting................................................................... 39 Archive Active Log File.................................................................................... 39 Adding License Numbers................................................................................................. 40 Administering ExtremeZ-IP remotely............................................................................. 40 Using the ExtremeZ-IP File Server......................................................................................... 41 Creating Volumes for Use with ExtremeZ-IP................................................................ 41 Viewing the Volume Window..................................................................................... 41 Volume Properties ...................................................................................................... 42 Attributes............................................................................................................ 42 Search Settings ................................................................................................ 42 ArchiveConnect................................................................................................. 43 Time Machine.................................................................................................... 43 Using Custom Quotas.................................................................................................. 43 Using Advanced Volume Properties......................................................................... 44 ExtremeZ-IP Users............................................................................................................ 45 Connecting Macintosh Users.................................................................................... 46 Reconnecting a Dropped User Session................................................................... 46 Reconnecting If a Session is Dropped.......................................................... 46 Viewing Files Opened with ExtremeZ-IP.................................................................. 47 Keeping track of activities with the Log................................................................................ 48 Exporting the Log ........................................................................................................ 48 Exporting the Log within ExtremeZ-IP........................................................... 48 Exporting the Log from the Command Line................................................... 48 Remapping Extensions............................................................................................................. 48 Associating a Type and Creator...................................................................................... 49 Creating a New Type and Creator.................................................................................. 49
ExtremeZ-IP User Manual Controlling the Processing of Jobs ............................................................................... 54 Viewing and Managing Print Jobs ........................................................................... 54 Publishing A Print Queue................................................................................................. 55 Using the Print Log ................................................................................................................... 55 Customizing ExtremeZ-IP Print Processing Log Columns.......................................... 56 Exporting the Print Log from ExtremeZ-IP..................................................................... 56 Exporting the Print log with the Command Line........................................................... 56 Using Print Accounting............................................................................................................ 57 Setting up Print Accounting............................................................................................ 57 Creating a List of Codes for Customers ................................................................... 57 Setting up a Print Queue to Provide Print Accounting Information ................... 57 Modifying a PPD for use with Print Accounting ......................................................... 59 Configuring Client Computers to Print to ExtremeZ-IP........................................................ 60 ExtremeZ-IP Zidget........................................................................................................... 60 Printer Setup Utility........................................................................................................... 61 Adding a Printer using the optional ExtremeZ-IP Print Components.................. 61 Adding a Printer using Bonjour from the Printer Setup Utility................................... 62 Using Bonjour Within the Print Dialog........................................................................... 62 Choosing a Printer with Mac OS 9 ................................................................................ 63 Using Bonjour from Windows......................................................................................... 63 Using Print Accounting Features from a Client ........................................................... 65
ExtremeZ-IP Zidget................................................................................................67
Configuring the ExtremeZ-IP server for Zidget access...................................................... 67 Adding additional servers to the Master Server.................................................................. 68 Installing and Configuring the Zidget on the Client ............................................................ 69 Adding a printer with the Zidget................................................................................ 70 Mounting ExtremeZ-IP shared volumes with the Zidget....................................... 70 Mounting DFS shared volumes with the Zidget...................................................... 71 Adding a printer from a Web Page......................................................................................... 71
Contents 7
Getting Started
System Requirements
Windows
The ExtremeZ-IP File Server operates on Windows 2003, Windows Server 2008, Windows XP, Windows Vista. For optimal results, your Windows machine should be running the latest service pack from Microsoft. Adding additional RAM to your Windows machine will greatly enhance ExtremeZ-IP performance. See below for system requirements.
Windows System Requirements Windows Server Platforms: 2008, 2003, Windows Storage Server, Windows Powered NAS Windows Professional Platforms: Windows 7, Vista, XP Pro, XP Embedded Minimum Hardware Recommendation: Processor: Pentium IV Memory: 1 GB
Macintosh Clients
Macintosh clients must have Mac OS 9.0 or later and should run the latest Mac OS release. If Macintosh clients are using Mac OS X, they must have version 10.2.8 or later. ExtremeZ-IP supports the latest Macintosh client technologies, including Bonjour, the Service Location Protocol (SLP), Kerberos, and Apples built-in encrypted logon support for long passwords. Print Accounting requires Mac OS X 10.3. Zidget requires Mac OS X 10.4. DFS and Network Spotlight require Mac OS X 10.5. Print Accounting is not compatible with applications running in 64-bit mode on Mac OS X 10.6 or later.
Setting Up ExtremeZ-IP 9
Getting Help
You can open Help from the Windows menu in the ExtremeZ-IP Administrator.
You can visit Group Logic at: http://www.grouplogic.com You can find the latest releases of ExtremeZ-IP at http://www.grouplogic.com/files/glidownload/ezipreleases.cfm The ExtremeZ-IP Manual at http://www.grouplogic.com/files/ez/EZIPManual.pdf You can search the Knowledgebase at http://www.grouplogic.com/Knowledge/index.cfm For the first year you own ExtremeZ-IP, technical support and upgrades are included in the price of the product. After your first year of free support, you can purchase extended support. For technical support services, submit a support request at http:// www.grouplogic.com/support/requestform/ or call 1.703.528.1555 Monday through Friday, 8:00 am to 6:00 pm ET. Have your ExtremeZ-IP serial number ready for verification. In addition, you can send your questions to [email protected] The Maintenance and Support program includes important benefitse-mail, fax and telephone technical support services for problems that you encounter, upgrades, bug fixes, and other incremental releases of the software.
Setting Up ExtremeZ-IP 10
Getting Starting with ExtremeZ-IP describes ExtremeZ-IP, lists system requirements, and explains how you can get help. Installing ExtremeZ-IP includes instructions for installing and removing the ExtremeZ-IP File Server, the ExtremeZ-IP Print
Server and instructions for starting and stopping the ExtremeZ-IP service. In addition, it explains installing AppleTalk, Kerberos, and Clustering.
ExtremeZ-IP File Server provides instructions for administering ExtremeZ-IP File Server on local and remote computers,
information about the features of ExtremeZ-IP, and instructions for remapping MS-DOS extensions to make files easy to use for Macintosh users. ExtremeZ-IP Print Server includes instructions for using the print server and print accounting. ExtremeZ-IP Zidget provides instructions for using Zidget with both the file and print server. ExtremeZ-IP DFS - Macintosh Client Configuration includes instructions for configuring Macintosh clients for DFS support. The Appendices cover the following topics. Using the Registry Keys Monitoring ExtremeZ-IP Configuring Guest Access for Windows XP and above Legal Notices
Setting Up ExtremeZ-IP 11
Installing ExtremeZ-IP
See the Installation Quick Start PDF for step by step installation instructions. Note For reinstallations, the ExtremeZ-IP installer stops the ExtremeZ-IP Service to perform the install. However, in some cases the installation fails because the ExtremeZ-IP Service cannot be stopped; these cases include possible service errors, conflicts with other running processes, or installing while the Services Control Panel is open. If you experience installation failures, you can stop the Service manually from the Services Control Panel and proceed with the install.
Installing ExtremeZ-IP 13
If you are upgrading from a previous version, ExtremeZ-IP checks for volumes shared with previous versions of ExtremeZ-IP and automatically creates these ExtremeZ-IP volumes.
If you choose Migrate SFM Shares, ExtremeZ-IP volumes are created for those SFM shares. In addition, if the SFM service is running, it is stopped and the service disabled. The following bullets describe how ExtremeZ-IP treats shares.
ExtremeZ-IP does not remove the SFM shares themselves. If you re-enable and run the SFM service, those shares are
unchanged.
In the event that SFM is re-enabled at a later date, ExtremeZ-IP takes the volumes that conflict with SFM shares offline. ExtremeZ-IP uses the built-in Apple user authentication modules; therefore, the Microsoft UAM volume from SFM is not
migrated. Installing ExtremeZ-IP 14
ExtremeZ-IP does not reuse SFMs Macintosh file IDs, but any data (including metadata such as Finder info) in the SFM
share are accessible through ExtremeZ-IP.
SMB Shares
Each time the ExtremeZ-IP Administrator is launched, ExtremeZ-IP checks for any SMB shares that are not being shared as ExtremeZ-IP volumes. If any such volumes exist, the Migrate SMB Shares button within the Volumes dialog becomes active. If you choose to do so, ExtremeZ-IP creates new volumes for those SMB shares. ExtremeZ-IP does not replicate hidden shares (for example, C$). When Mac OS X clients copy files to a server with SMB, they do not have access to alternate streams, where resource fork and Finder information is usually stored. Instead, this resource fork and Finder information is written to a separate file, the dot underscore file. To the Macintosh client, this action happens behind the scenesthe dot underscore is hidden, and all they see is a single file that appears to contain resource fork and Finder information. But when you view these files from Windows, the dot underscore file is just another hidden file with no relation to the original data file. In ExtremeZ-IP, the server can migrate resource and Finder information from the dot underscore file into alternate data streams of the file so that Macintosh clients have access to that information. When a Macintosh client requests information about a file or folder, ExtremeZ-IP first tries to read from the file or folders Finder info stream (AFP_AfpInfo) and, in the case of a file, from its resource stream (AFP_Resource). If either one of these streams is missing, ExtremeZ-IP tries to find a corresponding dot underscore file. If that file is present and contains the necessary data, the data are migrated into the appropriate stream. The dot underscore migration feature is enabled by default, but you can disable this feature. To disable this feature, set the refreshable registry value ServerMigratesDotUnderscoreFiles to 0 and if ExtremeZ-IP is running use the Refresh Registry button in the Administrator to read in the new value. In addition, ExtremeZ-IP contains an optional feature that allows ExtremeZ-IP to delete a dot underscore file after its contents have been migrated into the data file. This feature is disabled by default, but you can enable this feature. To enable this feature, set the refreshable registry value ServerDeletesMigratedDotUnderscoreFiles to 1 and refresh the registry. Since ExtremeZ-IP migrates dot underscore information only when necessary, dot underscore migration may occur over time, as ExtremeZ-IP explores new areas of the volume for the first time. ExtremeZ-IP does not perform this migration all at once when the volume first comes online. If the dot underscore file is locked, or has different permissions than the corresponding data file, the information may not be copied to the AFP_Resource or AFP_Info streams. This fact is logged. The dot underscore migration is a transition feature and is not designed for simultaneous use with SMB. ExtremeZ-IP does try to deal with AFP clients accessing a file while it is still being written with SMB, but this is not a supported use of the feature. Any changes that occur to dot underscore files after the initial migration is ignored by ExtremeZ-IP, since the service always prefers its alternate streams to dot underscore files. Therefore, if a user alters the resource fork of a file over SMB after the resource fork information has been migrated by ExtremeZ-IP, these changes are not migrated. While dot underscore files can contain information other than resource fork or Finder information, this other information is not migrated into the data file. The following types of information are not migrated:
File Comments Real Name (Files name as created on home file system) Icon, B&W (Standard Macintosh black and white icon) Icon, Color (Macintosh color icon) File Dates Info (File creation date, modification date, and so on) Macintosh File Info (Macintosh file information, attributes and so on) Short Name (AFP short name) Directory ID (AFP directory ID)
Note SMB shares will not be migrated on a Windows Cluster Server installation of ExtremeZ-IP.
Installing ExtremeZ-IP 15
Installing AppleTalk
When the AppleTalk protocol is installed on the server, ExtremeZ-IP registers itself with AppleTalk. Mac OS 9 clients see ExtremeZ-IP when they open the Chooser. If AppleTalk is not already installed, you can install the AppleTalk protocol for Windows. To install the AppleTalk protocol, add it as a protocol in the Network Control Panel. Note Windows XP, Windows Vista, and Windows Server 2008 do not include AppleTalk.
Using Kerberos
The Massachusetts Institute of Technology created Kerberos to address such network security issues as username/password exchange, network security, client computer security, and login persistence. Kerberos is a protocol that provides secure network authentication and support for single sign-on to network resources. With single sign-on support, a user logs in one time to a network domain (also called a realm) and, after he or she is authenticated, gains access to resources on other computers without resubmitting a user name and password. Kerberos works on the premise that only the client and authenticating server share a piece of secret information and it provides a way to confirm that the shared information is accurate throughout the users session. When a user on a client computer types in a username and password and submits that information to a server to log in, Kerberos first authenticates the user and then issues a ticket that uniquely identifies the client for that session. The ticket is used for future access to other applications and shared volumes during the users session. Kerberos provides encrypted key exchange to ensure security on both internal networks (behind firewalls) and insecure networks such as the internet. Once a user is authenticated, all further communication is encrypted for privacy and security. For more information on how Kerberos works on a Windows Server, go to http://www.microsoft.com/windowsserver2003/technologies/security/kerberos/default.mspx ExtremeZ-IP supports the Kerberos extensions in the AFP protocol and works directly with Active Directory. It is registered as a Kerberos service provider and can authenticate Macintosh tickets. Since the tickets themselves are a standard format within Installing ExtremeZ-IP 16
ExtremeZ-IP User Manual Kerberos, ExtremeZ-IP takes tickets from a Macintosh and passes them to Microsoft Windows Active Directory for authentication and then grants access to Windows server resources if Active Directory says the client has a valid ticket.
Troubleshooting Kerberos
If you are having trouble getting Kerberos to work with ExtremeZ-IP, use the following troubleshooting steps: To verify that a client computer has communicated successfully with the Kerberos ticket authority and received a ticket for ExtremeZ-IP, run the Kerberos application located in /System/Library/CoreServices. The active Kerberos tickets are listed in Kerberos.app. In addition, the Kerberos application can be used to destroy existing tickets before their normal expiration time. To verify that a client computer is bound to the Active Directory Domain correctly and is running the right version of Kerberos modules, try connecting to the server from the Macintosh over SMB instead of AFP by typing smb://SERVER_NAME into the Server Address field in the Connect To Server dialog. If you are required to log in then you will know that there is a general problem with Kerberos.
active-active clustering multiple virtual servers per node in a cluster improved reliability and availability eight node clusters in Windows 2003 & 2008 possible server consolidation
When you are running ExtremeZ-IP in a clustered environment, the ExtremeZ-IP Administrator window shows the following in the title bar:
the name of the server in upper case characters the name of the service in upper or lower case as you typed it when you set up the service.
MSCS uses the following terms to describe the component parts of a cluster configuration. Do not confuse these terms as you proceed with installing ExtremeZ-IP.
NodeA single member server in a cluster. ResourceA hardware or software component that runs in a cluster, such as a disk, an IP address, a network name, or an
instance of the ExtremeZ-IP service.
GroupA combination of resources that are managed as a unit of failover.Groups are also known as resource groups or DependencyA service or other resource that must be available first in order for the dependant service to start. FailoverThe process of moving resources or resource groups from one server to another. Failover can occur when one
failover groups. A typical ExtremeZ-IP failover group consists of a disk, an IP address, a network name, and an instance of ExtremeZ-IP.
server experiences a failure of some sort or when you, the administrator, initiate the failover. This term is equivalent to the Installing ExtremeZ-IP 17
ExtremeZ-IP User Manual Microsoft Cluster Administrator action of moving a Cluster Group to another node.
Quorum ResourceA disk resource containing the failover information that is shared between nodes in a cluster. HeartbeatThe communication between Cluster nodes tells the other nodes that the service is still running. Virtual ServerA virtual server is a combination of configuration information and cluster resources, such as an IP address,
network name and an application resource. An ExtremeZ-IP Virtual Server (EVS) is defined by its unique IP address. tion.
Active/ActiveThis term describes a configuration in which multiple nodes are ExtremeZ-IP file servers running in produc Active/PassiveThis term describes a configuration in which one node is active in production and another node sits idle
until a failover occurs.
Shared StorageThis term refers to the external SCSI or fibre channel storage system. Shared storage is a requirement for
multi-node clusters. Although this storage is shared, only one node can access an external storage resource at any given time.
Mac Workstations
Client Network
Node 1
192.168.0.5 Finance
Node 2
192.168.0.16 Marketing
Q1
192.168.0.21 Sales 192.168.0.72 Tech Support 192.168.0.101 R&D
ExtremeZ-IP MassTransit
Q2 Q3
Bashar
Logs
ProjectX
Kim
Q4
Hacks
Hotfixes
Shared Disk 1
Extreme Z-IP Instance
Shared Disk 2
Quorum Resource
Shared Disk 3
Shared Disk 4
Shared Disk 5
Cluster Network Interconnect (Heartbeat)
This diagram shows an example of a cluster setup. Note Each server has its own IP address. You can configure multiple shares for each virtual server..
Installing ExtremeZ-IP 18
Cluster Worksheet
For each ExtremeZ-IP service running on your cluster you will need the following. 1. A name for the unique ExtremeZ-IP service (the first instance is created by default and is named ExtremeZ-IP) 2. A unique IP address and optionally a network name 3. Shared physical storage 4. A cluster group in which to put the new ExtremeZ-IP service To simplify this process we have provided a worksheet to prepare for your installation. Duplicate the worksheet for each additional ExtremeZ-IP virtual server you would like to create. Information needed to install the software ExtremeZ-IP Serial Number: For each virtual server you want to set up, you will need to have unique values for all the sections below.
Information needed to set up a new cluster group Cluster Group name IP address Network name (DNS/Netbios name) Unique service name (created above) Is the volume shared with Windows?
Drive Letter
Volume Name
Volumes to be shared
Installing ExtremeZ-IP 19
An ExtremeZ-IP cluster-enabled serial number that is encoded with the number of nodes and virtual servers for which it is
licensed. Use a single serial number for all the nodes of the cluster.
A shared disk or disks where the ExtremeZ-IP shared volumes will reside An IP address and network name for each ExtremeZ-IP virtual server you want to create; create a DNS entry for each IP
address. Note If folders sharedover SMB (forWindows clients)reside on the same physical disk as ExtremeZ-IP shares, Group Logic recommends configuring DFS (Distributed File System) so that your Windows users can use one IP address or host name to access your shared volumes.
Place each set of components in its own cluster group or ExtremeZ-IP Virtual Server (EVS).
The number of EVSs created is based on the number of physical disks that need to be shared out with ExtremeZ-IP. For example, if the volumes are on three physical disks, create three EVSs. This configuration has the most flexibility; however, in some cases you may not want to use up multiple IP addresses. Then you can have multiple physical disks shared out by one EVS. The Cluster Worksheet found on page 18 of this chapter can help you set up a plan for your cluster.
Installing ExtremeZ-IP 20
4.
You will be prompted to create your first service. Enter the Service Name of your choosing. In this example, our service name is Marketing.
Note Write down the exact service name you use in this command. You need the exact name when configuring Microsoft clustering in the next section.
5. After the service is created, it will appear in the ExtremeZ-IP Services window. ExtremeZ-IP Services will be shown each time the ExtremeZ-IP Administrator is launched. It is used to select the service you would like to administer, as well as to add or remove additional services.
6.
If you are configuring multiple services, select Add Service and to create any additional services necessary.
7.
You will need to perform these steps on each cluster node that these ExtremeZ-IP services will run on.
If you already have set up a Cluster Group, simply add ExtremeZ-IP as a generic service to your Cluster Group. If you do not have any existing cluster group, follow the steps in the sections below, which take you through the process Or, you may use another method with which you are familiar.
of using the Cluster Application Wizard to configure the cluster group.
If folders shared over SMB for Windows clients reside on the same physical disk as your ExtremeZ-IP volumes, you can add the ExtremeZ-IP service to an existing group.
Installing ExtremeZ-IP 21
ExtremeZ-IP User Manual In addition, when using an active/active configuration with Windows SMB shares, you may want to install and configure Windows DFS (Distributed File System). DFS makes it easier for connected users to find shared folders on the network without having to learn multiple IPs or DNS names. For more information, see Microsofts DFS documentation. Although the Macintosh client does not support DFS, ExtremeZ-IP has the ability to make DFS volumes available to Macintosh clients. Information on configuring ExtremeZ-IP and Macintosh clients for DFS can be found on pages 36 & 70 of this manual.
Note Make sure you select Generic Service. Selecting Generic Application, which is the default entry, is a common mistake.
11.
Use a meaningful name such as the one used in the examples belowExtremeZ-IP Service-Marketing.
Installing ExtremeZ-IP 22
12.
This name must match the Service Name configured in the command line in Configuring an ExtremeZ-IP Service.
13.
3.
Configure the owners of the Physical Disk resource to be all of the nodes ExtremeZ-IP will run under.
4.
You can add dependencies for the Physical Disk, if needed, but this configuration is not required for ExtremeZ-IP.
Select the Physical Disk containing the folders you want to share with ExtremeZ-IP, and click Finish.
Installing ExtremeZ-IP 23
Since the ExtremeZ-IP resource is created under the virtual server wizard, all the nodes in the cluster are owners for the resource. If you do not want this configuration, you can change it before you bring the service online. To change the owners for the resource, click the General tab and modify the Possible Owners accordingly.
Installing ExtremeZ-IP 24
3.
4.
You must now select the service to add. You may see multiple entries for ExtremeZ-IP in the list. Each entry will display the ExtremeZ-IP service name as defined when the service was created. See page 19 for further details. Select the entry that includes the specific ExtremeZ-IP service name you would like to configure and click Next.
Installing ExtremeZ-IP 25
6.
Select the volume(s) you would like to make available to this cluster group and click Next. These should be the volumes that contain the directories to be shared with ExtremeZ-IP.
7. 8.
Click Next on the Replicate Registry Settings step. No changes are necessary. Click Next on the Confirmation step.
Since the ExtremeZ-IP resource is created under the High Availability Wizard, all the nodes in the cluster are owners for the resource. If you do not want this configuration, you can change it before you bring the service online. To change the owners for the resource, click the Advanced Policies tab and modify the Possible Owners accordingly.
Installing ExtremeZ-IP 26
When the ExtremeZ-IP Administrator is started, you will be prompted to select the ExtremeZ-IP service that you want to administer. Select an ExtremeZ-IP Service and click OK Once you have chosen a service, the Administrator launches and connects to that service. The Administrator title bar tells you which server it is connected to in the format (Network Name Service Name).
If the connection to the server is broken (that Cluster Group is failed over) the administrator cannot reconnect to that service since it is on another node. However, you can now administer it on the node to which it has been moved. If it fails back to the original node, you can reconnect to it.
Installing ExtremeZ-IP 27
Setting up ExtremeZ-IP
Before using ExtremeZ-IP, review the default settings; you can make changes at this time or later. The Settings dialog box has the following tabs: File Server, Print Server, Security, Search, Filename Policy, Service Discovery, and DFS. To change settings, do the following:
1. 2. 3. Access the ExtremeZ-IP Administrator window. Click Settings. Choose the settings appropriate for your use, then click OK to return to the ExtremeZ-IP Administrator window.
Add serial numbers. Check Group Logic web site for updates. Displays the active TCP/IP sessions, open file forks and file locks.
View the users who are connected; disconnect users; send messages.
File Server 29
Port used for AFP connections. Message sent to users when they log in. Share volumes as home directories. Set Login Methods.
AFP Port
If required for your connection, make changes to the AFP port. Although rarely necessary, you can type a new port number for the TCP/IP port the file server uses; the default is 548. Note If Macintosh clients cannot connect to your server, ExtremeZ-IP may be running on a port other than the default. In this case, ExtremeZ-IP displays a message on the ExtremeZ-IP Administrator window warning you that you have picked a non-default port.
Logon Messages
The logon message displays on the Macintosh users computers after they successfully log in. Leave the message blank if you do not want clients to receive a message when they log in. To increase the number of characters you can use in the message you send to clients, use the registry key. You can use as many as 500 characters; Macintosh clients using Mac OS 9 see fewer characters.
Enable ArchiveConnect
This option turns on enhanced ArchiveConnect support for any file archive volumes shared with ExtremeZ-IP. ArchiveConnect is a separate Mac client-side application that enables Mac OS X clients to access file archives without triggering unintended retrieval of offline files.
Control whether or not the server logs print job processing results.
File Server 31
ExtremeZ-IP User Manual Note In order to make sure that jobs arent automatically deleted because of a queue-wide problem, such as a network problem, or printer turned off, ExtremeZ-IP will not automatically delete a job after the configured period of time unless at least two other jobs have been successfully printed since the job went offline. For the purposes of our performance counters, any queue that has more than one offline job and has not successfully processed a job since the last job went offline is considered an offline queue. So a single offline job does not make a queue offlineit could just be a bad job, but having multiple offline jobs without any recent successful jobs would suggest that a queue-wide problem exists. A queue that is offline does not differ from an online queue in terms of its processing; how it is reported in performance counters is the only difference.
ExtremeZ-IP User Manual If the credentials are invalid, the service will not be able to access Active Directory and UNIX permissions will be disabled. ExtremeZ-IP DFS support requires that this option is enabled and that valid Directory Service credentials are entered.
Enable IPv6
If you would like to use IPv6, check the Enable IPv6 checkbox. On some versions of Windows you will need to install IPv6 manually before services such as ExtremeZ-IP will be able to use it.
Enumeration Search
When the Mac OS performs an enumeration search, it scans each file in the folder and all of its subfolders across the network. An enumeration search is performed if searching a subfolder of a volume or if catalog search is disabled. The process of the client enumerating the entire directory structure below the folder being searched results in drastically reduced search performance.
Index Search
An index search issues a single search request that is processed on the server side. The Mac OS only issues an index search request when the Macintosh user is searching the root of a volume. ExtremeZ-IP maintains a search index to accelerate these searches. This index contains the name of every file on your ExtremeZ-IP volumes. With indexed searching enabled on the server, a Macintosh client can use the built-in Mac OS search functionality to perform fast searches of ExtremeZ-IP volumes. No client side configuration or applications are necessary. Instead of scanning your servers drive each time a Macintosh client makes a search request and looking through every file in the volume, ExtremeZ-IP checks the file name index to retrieve search results. Index search results can be provided only for searches initiated at the root of a volume. Any search performed below the root of a volume will result in the Mac OS performing an enumeration search.
File Server 33
ExtremeZ-IP User Manual Note Please instruct your users to search the entire ExtremeZ-IP volume for the fastest results.
Spotlight Search
Mac OS X 10.5 or later supports Spotlight searching of AFP file servers. Spotlight search allows files to be found by searching on content, in addition to file names and file attributes. When enabled, Spotlight search replaces both enumeration and catalog search and provides results when searching at both the root of a volume and within subfolders.
ExtremeZ-IP stand-alone server: Search index files are stored in a folder called ExtremeZ-IP Indexes in the
ExtremeZ-IP application folder or the custom global location you have set. which the volume resides.
ExtremeZ-IP Cluster: Search index files are stored in a folder called ExtremeZ-IP Indexes at the root of the drive on
When starting EZIP for the first time, search indexes for a volume is created in the default index path unless you have set individual custom paths for a particular volume or volumes.
File Server 34
Default Path
By default on a standalone server, ExtremeZ-IP stores index files in the ExtremeZ-IP Indexes directory in the ExtremeZ-IP application folder. If you would like to locate the index files in a different location, click Browse to select a new folder. Note If you modify the default path while ExtremeZ-IP is running, all index files for volumes without individual custom paths are created in the new location. Administrators can also specify custom index file paths for individual volumes; this setting overrides the global default path setting.
File Server 35
Custom message that will be added to the built-in description for each error. Policies that will be enforced.
Do Not Allow
In this section, set characters, filenames, and extensions that your Macintosh users will not be able to save to your file server . Characters Illegal in Windows FilenamesIf you check this setting, users cannot save files with names that include characters illegal in Windows. The characters are / ? < > \ : * | and trailing spaces and trailing periods. Characters Not Displayable in Windows ExplorerIf you check this setting, users cannot save files with names that include File Server 36
ExtremeZ-IP User Manual characters that cannot be displayed in the font used by Windows Explorer (the default is Tahoma). Specific CharactersYou can specify additional characters that you do not want users to include in filenames. Type the characters in this field without separators. File or Folder names overYou can limit file or folder names to a specified number of characters. Creation of .DS_Store filesYou can prevent Macintosh clients from saving .DS_Store files. ExtensionYou can restrict users from saving specific file extensions, such as mp3, mov and wav, by typing in the extension without the (.) dot precursor and clicking Add. To remove extensions from the list, highlight the extension and click Remove.
Service Discovery
Macintosh clients can use a number of different protocols to discover an ExtremeZ-IP server, depending on what operating system is being used and how the administrator configures the server. Select the network protocols you want the server to use to register withAppleTalk, Bonjour, Zidget/HTTP, or SLP by placing a check in the appropriate checkboxes. The protocols available for discovering file, print, and DFS resources can be configured independently.
Server Name
The Server name appears in the login window whenever a Macintosh user connects to the server. This name also appears in the Mac OS X Connect to Server dialog and on earlier Mac OS systems in the Chooser and the Network Browser when Macintosh users browse the network. You may change the name; use uppercase and lowercase text.
AppleTalk
The AppleTalk protocol is primarily used by the Mac OS 9 Chooser. When AppleTalk is selected, Mac OS 9 users can see volumes and print queues in the Chooser without specifying the IP address, and Mac OS X users can see them in Connect to Server and Add Printer dialogs. To register the server on AppleTalk, the protocol must be installed on the Windows server. Windows XP, Vista, and Windows 2008 Servers do not include AppleTalk support.
Bonjour
Bonjour allows Mac OS X users to see volumes in the Connect to Server dialog and print queues in the Print Center.
Zidget/HTTP
The ExtremeZ-IP Zidget is a replacement for AppleTalk and Bonjour service discovery that works across subnets without your having to configure your router. The Zidget uses XML over HTTP to retrieve a list of ExtremeZ-IP servers and their Print Queues from a Master ExtremeZ-IP server. By default this master server is named ExtremeZIPServerList. If there is a DNS entry in the default domain for ExtremeZIPServerList, then Macintosh clients ask that server for a list of all the ExtremeZ-IP servers on the network. They then query each server individually for its default zone or location and any print queues that it hosts. Because the ExtremeZ-IP Zidget uses standard HTML and XML, the administrators can use this protocol to create their own web interfaces as well. More details about how to do this can be found in the Zidget section of the manual. File Server 37
Port
Enter the port used for client server communication between the server and Zidget and Print Accounting. Note Even if you turn off Zidget/HTTP ExtremeZ-IP still uses this port to support the legacy ExtremeZ-IP Print Components and Print Accounting. Only the new features are disabled.
Master Server
Zidget supports connecting to a single master server to discover the other ExtremeZ-IP servers on the network. By default this is set to ExtremeZIPServerList. It is recommended that you keep this setting and create a CNAME record in DNS pointing to the host name of your master server. You can change it to any server name listed in the DNS.
Location
This field specifies the location of the server. It is similar to an AppleTalk zone, but allows for multi-level hierarchies. The location is also the default location of print queues on the server, but you can assign a different location on a queue by queue basis. Zidget groups the AFP Server and print queue display based on location. If you want to have a hierarchy of locations, such as 1100 N. Glebe RD, Arlington, Virginia, enter the locations separated by colons (Virginia:Arlington:1100 N. Glebe RD).
Description
The optional description for the server. Zidget displays this description when the user selects a file server.
SLP
With SLP, Mac OS 9 users can see volumes and print queues in the Network Browser. Type the name of the SLP scope (or Neighborhood) in which you want the file server to appear when Mac OS 9 clients use the Network Browser. Type a host name, which is the name of the server provided to Macintosh clients when they use the Network Browser.
DFS
ExtremeZ-IP can be configured to make a Microsoft Distributed File System (DFS) available to Macintosh clients. In addition to the server side configuration, installation of the ExtremeZ-IP Zidget dashboard widget (for Mac OS X 10.4 or later), or either a client application or an update to a configuration file (for Mac OS X 10.5 or later) is required for each Macintosh client that requires access to DFS. Details on the required client side configuration can be found on page 70. DFS support also requires two settings on the Security tab of the Settings dialog. Valid Directory Services credentials must be entered and Support UNIX Permissions and ACLs must be enabled for DFS to function.
Namespaces
To add a namespace, click the Add button. You will be prompted to enter the path of your DFS namespace. File Server 38
ExtremeZ-IP User Manual ExtremeZ-IP will attempt to verify that the DFS namespace entered is valid. If it is not valid, you will be prompted to correct the DFS namespace path. ExtremeZ-IP will automatically create a DFS virtual root volume in the ExtremeZ-IP DFS Volumes folder, located in the ExtremeZ-IP program directory. This volume will contain links to target servers in the DFS namespace and will be added as a shared volume with a volume name matching your DFS domain or host server name. The location where DFS virtual root volumes are created can be modified by selecting Advanced on the DFS settings tab. You are returned to the DFS tab, which is updated with the newly added namespaces information. You will find your namespace listed on the left and the target servers in that namespace listed on the right. The Valid column in the Namespaces list will indicate if the namespace was successfully validated. DFS namespaces can later be removed by selecting the namespace and clicking the Remove button.
Target Servers
The protocol used by Macintosh clients to connect to each target server can be configured on a per target server basis. When a namespace is first added, ExtremeZ-IP will attempt to detect, for each target server in the namespace, whether it supports the AFP protocol. If AFP is supported, the target server will be set to AFP by default. If AFP support cannot be confirmed, the target server will be set to OFF. Links to target servers set to OFF will not be visible to Macintosh clients in the DFS volume(s). If you would like Macintosh clients to connect to a target server using SMB, you can select the SMB option for each individual server. If you later install ExtremeZ-IP on a target server, you can return to the DFS settings tab and select AFP for that server.
Logging
ExtremeZ-IP allows the customization and configuration of its logging functionality and its ability to generate Windows Error Reports.
File Server 39
you have a trial version of ExtremeZ-IP installed and you purchase a license for the product. you are upgrading your client count. you are adding an additional ExtremeZ-IP companion product, such as ShadowConnect, to your server.
To add a serial number, do the following:
1. 2. 3. 4. 5.
Open the ExtremeZ-IP Administrator application. Click Licensing on the main ExtremeZ-IP Administrator window. Click Add License, enter the serial number, and click OK. The serial number will be displayed in the Active Licenses list and will take effect immediately. Click Close to return to the ExtremeZ-IP Administrator.
The Licensing window can also be used to remove serial numbers or replace serial numbers to upgrade client count. Note When adding companion product serial numbers to ExtremeZ-IP, you may be required to enter a serial number that matches the ExtremeZ-IP Servers client count and server type (retail, cluster, enterprise licences, etc).
2. 3.
Type the name or IP Address of the remote computer and click OK. The Administrator will attempt to use your Windows credentials to log onto the server. If necessary, you will be prompted for an alternate username and password.
File Server 40
Create a volume.
Creating a Volume
Folders can only be shared as ExtremeZ-IP volumes if they reside on an NTFS formatted disk. If you try to create a volume that is not on an NTFS formatted disk, ExtremeZ-IP gives an error message.
1. 2. 3. 4. Create a new directory on an NTFS formatted volume on the server machine or find an existing directory that you want to use. From the ExtremeZ-IP Administrator window, click Volumes. On the Volumes dialog, click Create. Using the Browse for Folder, locate and select the folder (directory) you want to share from an NTFS formatted disk.
5.
File Server 41
6.
Note A name can have no more than 27 characters. If you type more, ExtremeZ-IP truncates the name to 27 characters.
7. 8. Choose any additional settings required. Click OK to create the volume.
As soon as a volumes status becomes Online for Clients, Macintosh clients can see and connect to it.
Volume Properties
Attributes
Volume is read-only Setting the Volume to read-only prohibits Macintosh users from changing any documents on the volume or adding any new files or folders. Allow guests to use volume If you want a Macintosh user who logs into ExtremeZ-IP as a guest to access the volume, check this checkbox. Use Volume as home directory To filter the contents of this volume so that it only shows a user their own home directory, check this checkbox. In order for this feature to function, the server-wide Enable Home Directory Support option in the File Server Settings dialog box must also be enabled; see page 28. Reset permissions on move If you would like files and folders to always inherit permissions from their parent folder after they have been moved, check this checkbox . Note If the directory that is moved contains a large number of sub-folders, resetting the permissions can take awhile. Enforce Filename Policy Enforcing Filename Policy will prevent Macintosh clients from saving files to the server that do not comply with the filename policies that the administrator has set in the global Filename Policy settings. Volume supports ACLs Click this check box if you want the volume to support Access Control Lists.
Search Settings
Index volume for search Indexed searching is enabled on newly created volumes. To disable this feature, remove the check from this checkbox; in addition, you must stop and restart service the ExtremeZ-IP Files service for this change to take effect. Use custom index file path To specify an alternate index file location for a volume, place a check this checkbox and select a path for the new index file location. Support Spotlight Searching Enables Spotlight searching on the individual volume by Mac OS X 10.5 or later clients. This feature requires that Microsoft Windows Search is installed on the server and must be enabled on the Search tab of the Settings dialog before it can be enabled for the specific volume.
File Server 42
ArchiveConnect
Bring online explicitly ArchiveConnect is a separate Mac client-side application that enables Mac OS X clients to access file archives without triggering unintended retrieval of offline files. Normally, ArchiveConnect retrieves offline files automatically when a user double clicks to open them. This option requires the user to right click on an offline file and explicitly use a contextual menu option to bring the file online.
Time Machine
Support Time Machine backup When you check the Allow Time Machine Backup box, Macintosh clients can use the selected ExtremeZ-IP volume as a Time Machine backup destination. On the local network, Time Machine uses Bonjour to discover Time Machine supported volumes. Time Machine stores backup data as sparse disk image format or as HFS+. When you select a destination volume, Time Machine creates a disk image for the backup. By default, the Support Time Machine backup setting is disabled for a volume. Note You cannot enable Support Time Machine backup for volumes that are read-only or used as home directories. When you enable Support Time Machine backup, ExtremeZ-IP disables Volume is read only and Use volume as home directory. The opposite is also true. Limit users without custom quotas to X GB Check this box and enter a value to limit the size of Time Machine backups per user. When the Macintosh client connects to the server for the first time it sees the available space on the drive as whatever the quota was set to. On subsequent logins it will see the available space as the quota size minus however much space has been used by that users other backups. This quota applies to all users who do not have a custom quota assigned. Note Because ExtremeZ-IP has to tell the Macintosh how much space is available immediately when the user logs in, prior to Time Machine opening a specific backup file, the quota is applied on a per user basis not a per machine basis. If a user backs up both a desktop machine and a laptop, the quota will apply to the combined size of the backups. Custom quotas This button opens the Custom Quotas window.
2. 3.
Click Add to add a new user-based or group-based quota. Use the Select Users or Groups dialog to choose the users or groups you would like to apply a quota to. You can pick more than one user or group at a time if you would like to set them all to the same quota value.
File Server 43
Note Volume specific passwords were eliminated in Mac OS X 10.5, but have been re-enabled in Mac OS X 10.6.
Enabled only when there are new SFM or SMB shares available.
File Server 44
ExtremeZ-IP User Manual When you click Migrate SFM Shares, you are asked to verify that you want to migrate the shares and disable SFM.
When you click Migrate SMB Shares, you are asked to verify that you want to migrate the shares.
If you follow this procedure, preexisting SFM and SMB shares will become available as ExtremeZ-IP volumes. This procedure is the same as that used the first time you launch ExtremeZ-IP (see page 13). Because someone could add or remove volumes to either the SFM or SMB service at any time, when you reopen the Volumes window, note the state of the Migrate buttons. If they are dimmed (disabled), no new SFM/SMB volumes have been added. If one of the corresponding ExtremeZ-IP volumes is removed, the button is enabled. Note This button updates only when the Volumes window is opened. Changes occurring to SMB/SFM shares have no effect on the button state while the Volumes window remains opened.
ExtremeZ-IP Users
The Users dialog box lets you view the users connected to the server, disconnect those users, or send messages to them. See the section on the next page Connecting Macintosh Users for information on user name and password entry. To view the Users dialog box, click Users on the ExtremeZ-IP Administrator window. Names and IP addresses identify users who are currently connected. Their connection and idle times are given. The dialog refreshes automatically. Click on a column title to sort the list by a column.
The Status column tells you if the connection Active, Sleeping, or Waiting for Reconnect. Disconnect a highlighted user or all users. Send a message to a highlighted user or all connected users.
The status tells you if the Macintosh client is idle, sleeping, or being reconnected; see Reconnecting a Dropped User Session on page 43. Note User accounts are defined in Windows. ExtremeZ-IP uses this information to determine the user access privileges.
File Server 45
File Server 46
ExtremeZ-IP User Manual Reconnecting with Kerberos Authentication Kerberos is a protocol that provides secure network authentication and support for single sign-on to network resources: see Using Kerberos on page 15. Because of limitations in the Windows OS, users that originally logged in using Kerberos authentication cannot reconnect automatically if their old session is no longer available. Therefore, while users logging in with cleartext or DHX-encrypted passwords silently reconnect after a cluster failover, clients logging in with Kerberos may be disconnected.
The dialog refreshes itself as new files are used by the Macintosh Users. The dialog box lists the following information about each file being used:
the name of the Macintosh user using the file. the IP Address from which the user is connected. the name of the file being used. the fork being accessed by the usereither the Resource or Data fork. access information (for example, read access or write access). a count for the number of locked sections on a file if a user has locked portions of that file for exclusive access, which happens often for database programs.
Note You should use caution when closing a file this way because a user may experience data loss and possibly a crash. Instead, disconnect a user using the Users dialog box; this automatically closes all files opened by that user.
File Server 47
You can view the type of entry, the time the entry was made, and the message about the entry.
See the included sample batch file Export_Print_Log.bat that came with ExtremeZ-IP.
Remapping Extensions
Macintosh programs use a documents type and creator to launch particular applications from the Finder automatically. Windows users normally do not have access to the Macintosh-specific type and creator information. With ExtremeZ-IP, you can automatically map MS-DOS extensions to particular type/creator combinations. For example, you can map Adobe Acrobat documents that have a PDF extension, to the Macintosh type PDF and creator CARO. ExtremeZ-IP installs a number of default mappings for certain document types; you can change these at any time. You can create a new type and creator to assign to a document. You can also edit and delete types and creators. ExtremeZ-IP Print Server 48
3. 4. 5.
From the Files with MS-DOS Extension drop list at the top of the Macintosh Type/Creator to Extension Mappings dialog box, select a new extension. From the list of types and creators, select the entry you want to remap. Click Associate.
2. 3.
Fill out the dialog box to meet your specifications. Click OK to return to the Macintosh Type/Creator to Extension Mappings dialog box.
Create print queues. When a queue is suspended, jobs are accepted by the server. However, they are not sent to the printer until processing is resumed. Open a window with a list of the pending jobs. From there you can start, stop, or reorder the print jobs. Takes the existing Windows print queues and republishes them as ExtremeZ-IP queues as well. 2. Click Create to define a print queue.
The name that you will see when you print from a Macintosh. Whether the print queue should be discoverable by clients. Where ExtremeZ-IP will send the jobs after they are received.
The PPD to be used by clients when printing to this queue. Require the Macintosh client to supply job-tracking information every time they print to this queue (refer to the ExtremeZ-IP manual for additional configuration).
Note If you plan to use Print Accounting, enable the checkbox allowing to you to Require Client Validation Codes. See page 54 for information about setting up print accounting for a print queue.
3. 4. Type a name for the print queue you are setting up. Associate a PPD file with the queue and choose a processing method. See the sections below for instructions for each kind.
You see a list of Windows printers that you have already shared for Windows clients on the server. ExtremeZ-IP Print Server 52
If this list is empty, you must create a Windows printer from the Windows Print Wizard and set it to be shared.
Queue names must be unique; you cannot have two queues with the same name. See the section Controlling printing with an LPR printer for information about controlling the LPR print queue.
2. 3.
Use the Browse for Folder dialog to locate and select the directory. Click OK.
2. 3.
Type the Zone in which the printer is located or an asterisk (*) if you do not have zones on your AppleTalk network. Enter the name of the Printer.
You can click Browse to search for the printer on your network.
view the status of each job in the queue in the Status column. suspend processing of all jobs in a print queue and a particular job in a print queue. resume processing when you want. control which jobs are processed first. delete jobs.
To access the Print Queues dialog, click Print Queues on the ExtremeZ-IP Administrator window. This dialog lists the print queues available to Macintosh clients.
ExtremeZ-IP User Manual The Print Queue Jobs dialog box lists the jobs being processed. When a job is being processed, you see the progress indicator and the name of the job being processed.
Click to stop processing. (The job being processed continues to process.) Click to resume processing.
You can also disable publishing a specific queue so that only people who know the queue exists can use it.
The Print Processing Log contains standard printing information. You can sort the log by any column by clicking on the column title. To toggle the sort between ascending and descending, click the column title a second time.
Using the registry keys, you can add each new print log entry to a specified text file automatically. See Appendix A: Using the Registry Keys on page 74.
See the included sample batch file Export_Print_Log.bat that came with ExtremeZ-IP.
allocating proofing costs between clients and jobs. tracking use of shared printing resources and assigning costs correctly to departments and jobs. tracking the use of printers between employees, students, or projects. ensuring that only authorized users can print to certain printers.
You can configure print queues to require that Macintosh users enter accounting codes before printers will accept jobs from them. You decide how many accounting codes are required for each print queue, the names of the codes, and whether the codes are optional or required. When codes are required, Macintosh users cannot print a job until codes are entered. You may allow clients to browse a list of valid accounting codes or pick from the most recently used codes on their computer. Each print accounting code is associated with a text file that contains valid codes and descriptionsfor example, an employee number/name ( 2312, Jane Smith), or project number/name ( Q98331A, Mockup for Acme Corp Annual Report). When clients print to a queue, they are prompted to enter the print accounting codes based on the configuration on the server. Validation is performed against this text file when the client prints, so you can update these codes and descriptions on the server without having to reconfigure the client.
4.
To add the first code, click Configure. You can change the name of the code to anything you would like. This name appears next to the field on the Macintosh print dialog box.
5. 6. 7. 8. 9.
If you want to require the Macintosh user to fill in the code before printing instead of it being optional, check the checkbox Requires Validation. Use fields that do not require validation for information such as comments. If you want the Macintosh user to be able to browse the code list, place a check in the Allow User to Browse Codes checkbox. Click Browse to locate the text file that contains the codes you set up earlier. Click OK to save the entered code or click Add to add additional code fields. Provide the PPD for each Macintosh by placing it on the ExtremeZ-IP server and configuring the print queue to require it.
On Mac OS X, the PPD selected for each print queue must be modified to include additional information, including the IP address of the server. Macintosh PPDs are normally in the folder /Library/Printers/PPDs/Contents/Resources. A sample PPD called ExtremeZ-IPSample.PPD is included with the software. To modify a PPD for use with Print Accounting, follow these steps:
1. 2. 3. 4. Find the PPD you want to modify. Default PPDs are compressed in the gzip format. Expand one by double-clicking it. Open the uncompressed PPD in a text editor. Copy the following lines to the PPD from the ExtremeZ-IP sample PPD.
*%****************************************************************************** *% ExtremeZ-IP Print Accounting CUPS Filter *%****************************************************************************** *cupsFilter: application/vnd.cups-postscript 0 ExtremeZ-IP_filter *ExtremeZ-IP_Print_Accounting_IP: 192.168.1.5 *ExtremeZ-IP_Print_Accounting_Queue_Name: My Queue Name *%****************************************************************************** *% ExtremeZ-IP Print registering UI element for plugin invocation *%****************************************************************************** *OpenUI *ExtremeZ-IPValidationRequired/ValidationRequired: Boolean *DefaultExtremeZ-IPValidationRequired: False *ExtremeZ-IPValidationRequired True/Required: *ExtremeZ-IPValidationRequired False/Not Required: *?ExtremeZ-IP_Validation_Required: query code *CloseUI: *ExtremeZ-IPValidationRequired Note If the PPD you are modifying already has a CUPS filter it may conflict with the ExtremeZ-IP filter.
5. 6. 7. 8. 9. Modify the line ExtremeZ-IP_Print_Accounting_IP to be the TCP/IP address of the ExtremeZ-IP server. Modify the line ExtremeZ-IP_Print_Accounting_Queue_Name to be the name of the queue as it is specified in the ExtremeZ-IP Administrator. Modify the NickName of the PPD. There should be a line that starts *NickName: This name will appear when selected during creation of a desktop printer. If you dont modify the NickName and, instead, leave the original compressed PPD installed, you will not be able to select the modified one. Save the PPD from the text editor with a .ppd extension. The standard TextEdit application asks you if you want to append a .txt extension. Click Dont Append a .txt and do not re-compress the PPD.
To make use of ExtremeZ-IP printing, clients follow specific steps depending on their operating system. Once you add print queues through the ExtremeZ-IP Administrator Print Queues dialog box, they are immediately available for clients to print to them. Printer Browser installers for Macintosh clients are copied onto your servers drive when you install ExtremeZ-IP. Macintosh clients can copy to their computer, and install, an operating system specific Printer Browser installer from the ExtremeZ-IP server. It is also possible to use Apple Remote Desktop to deploy the installer packages to multiple Macintosh computers. A Macintosh user can select an ExtremeZ-IP queue to print to in a number of ways, depending on the operating system they are using and the functionality they need. When using Mac OS X, the following are the primary ways to set up a printer:
ExtremeZ-IP Zidget supports discovering printers across subnets, automatic PPD download, and adding queues that have
been set up to require Print Accounting codes if the Macintosh also has the optional ExtremeZ-IP print components on it. It is also available from inside any application, therefore; you can set up a printer when you need to print without leaving your current application. The slight downside is that you must install it on each Macintosh. Although simple to install, it does require additional work. tive Mac OS X Bonjour discovery is also very simple to use. The disadvantage of Bonjour is that it does not support automatic PPD download or Print Accounting queues.
Bonjour discovery from within the print window of an application has the advantage of being built-in to Mac OS X. The na ExtremeZ-IP Printer Browser works from within the Apple Printer Setup Utility. It supports automatic PPD download from
the server and can be used to add queues that have been set up to require Print Accounting codes. The disadvantage to the custom ExtremeZ-IP print components is that they have to be installed by someone with administrator rights on the client computer either manually or with Apple Remote Desktop. It also requires more training than the Zidget does.
When using Mac OS 9, there are two options for setting up a printer:
The built in Chooser desk accessory can use AppleTalk to locate and set up the printer. Note: AppleTalk is not installed by
default on Windows servers.
ExtremeZ-IP Choose IP Printer is an optional install that supports faster printing. It uses the SLP and TCP/IP protocols.
The advantages and disadvantages are similar to the ones stated above for Mac OS X. The built-in Chooser is simple and well understood by Macintosh users, but the custom client has more features and is several times faster than printing with AppleTalk.
ExtremeZ-IP Zidget
Zidget is the easiest and fastest way to add an ExtremeZ-IP printer from the Macintosh. More information about using Zidget can be found in the Zidget section. To add a printer using Zidget, do the following:
1. 2. Press the F12 key to invoke Dashboard. Select the ExtremeZ-IP Zidget.
3. 4. 5. 6.
Double-click a location/zone if necessary. Select a printer from that location/zone. Click Add Printer and the printer will be created on the Macintosh with the proper PPD if one is available from the server. The status section of the Zidget updates to say the printer was successfully created.
3. 4.
Note If a PPD was specified in the ExtremeZ-IP print queue configuration on the server, ExtremeZ-IP sends a printer PPD hint to the client Mac. If the client Macintosh already contains a valid PPD for the printer type, the Print Using dropdown is set to the correct printer type automatically.
4.
3.
Click Next.
4.
Select the printer you would like to install, then, click Next.
If a PPD was specified in the ExtremeZ-IP print queue configuration on the server, ExtremeZ-IP sends the printer model listed in the PPD to the Windows client. If the Windows client already contains a valid driver for the printer type, the printer manufacturer and model should be automatically selected.
5. If a PPD was not selected automatically, select the appropriate manufacturer and model and click Next.
If print accounting is enabled for that print queue, a special dialog box appears. The following is an example:
2.
In the example above, the ExtremeZ-IP Administrator has enabled Browse buttons for each field, so the Macintosh user can browse the list of codes for that field. Fields that have asterisks (*) before their names are required and must be completed before the job can be sent.
3. Click Print to send the job to the selected print queue.
ExtremeZ-IP Zidget 65
ExtremeZ-IP Zidget
The ExtremeZ-IP Zidget is a new way of connecting to ExtremeZ-IP file and print servers. Zidget is a Dashboard Widget that the Macintosh user can use to discover and connect to a file server whether or not the server is in the users local subnet. Zidget also allows the Macintosh user to browse DFS namespaces that are shared through the ExtremeZ-IP server. Using Zidget, the Macintosh user can also browse for and add ExtremeZ-IP printers. Zidget will automatically download the PPD for the printer, and set up the print queue without the user having to use the Print Center. The Zidget can also be used to add queues on the print server that receive jobs directly, or direct print printers that are advertised by the ExtremeZ-IP server but do not route jobs through the print server. Zidget contacts a server called the ExtremeZ-IP master server to retrieve a list of all the ExtremeZ-IP servers in your organization. It then contacts each of those servers to find out whether they are just file servers or if they also are print servers. If the server is a print server it then retrieves a list of all the print queues on that server. The servers as well as individual print queues can be assigned to locations or zones. Once the Zidget has retrieved information from all the servers it merges them into a list of locations for the user to choose from.
Although many customers may choose to mimic their existing AppleTalk zone structure, they can also use a more complex location-based method for organizing their print queues. For that matter, they can use any other hierarchical arrangement they would like, such as Color and Black and White. The location-based method can be hierarchical such as building, floor, and room.
ExtremeZ-IP Zidget 67
ExtremeZ-IP User Manual If you would like, you can also assign a server to a specific location. A location is composed of locations separated by colons that contains the hierarchy of zones/locations that the Zidget should use to display them. An example for single level zone is GLIHQ and a multi-level location might be Virginia:Arlington:1st Floor. In addition to the location property of a print queue or file server, an administrator can also assign them descriptions. When a queue is selected, the status area of Zidget displays any description that the administrator has set for the queue. However, locations and descriptions are optional. If no servers or print queues have locations assigned to them, then they are all displayed in Zidget as a list without any additional hierarchy. If only some of the servers do not have a location, they will be displayed at the end of the list below the locations.
To make a manually generated MasterServerList.xml, you take the information from each server and put it in one file. The HTML Files folder inside the ExtremeZ-IP program folder also contains a TemplateMasterServerList.xml that you can modify to contain the information specific to your organization.
ExtremeZ-IP Zidget 68
2. 3. 4.
Click on the Download Zidget link. The file Zidget.wdgt.zip will be downloaded. Click Install to confirm the dialog asking if you want the Zidget installed (if you have not disabled auto installation of widgets in Safari). If your Master Server is something other than the default ExtremeZIPServerList, click the i icon to modify this setting. The Refresh Interval determines how often the available file servers, printers, and DFS namespaces in the Zidget are refreshed.
ExtremeZ-IP Zidget 69
3. 4. 5. 6.
Double-click a location/zone if necessary. Select a printer from that location/zone. Click the Add Printer button and the printer will be created on the Macintosh with the proper PPD if one is available from the server. The status section of the Zidget updates to say the printer was successfully created.
3. 4. 5.
Double-click a location/zone if necessary. Select a server from that location/zone. Click the Connect to Server button.
ExtremeZ-IP Zidget 70
3. 4. 5. 6.
Double-click the DFS domain or server, in this example GROUPLOGIC. Double-click the DFS root, in this example ProductionDFS. Select a DFS target. Click the Connect to Server button.
ExtremeZ-IP Zidget 71
In the auto_master file, add the following line: /<new volume name> /Volumes/<new volume name>/.auto_dfs The new volume name is the name of the ExtremeZ-IP DFS volume that was created in the Namespace setup process on the DFS tab of the Settings dialog. Example: if the volume to be used for DFS roots is called GLILABS then the auto_master line would be: /GLILABS /Volumes/GLILABS/.auto_dfs
Be sure there is a new, blank line at the end of this file. If this new line does not exist, DFS will fail to function on the client. This file can be copied to any other Macintosh clients that need access to DFS; it is not necessary to manually edit the file on each client. It is recommended that the AUTOMOUNT_TIMEOUT parameter in /etc/autofs.conf be changed to 300 (seconds) in order for changes in the DFS namespace to be reflected by AutoFS. AutoFS is used by the Macintosh client to automatically mount DFS targets as they are accessed. Once youve completed these steps on the Macintosh client, reboot the client so the automount changes will take effect. At this point, you will be able to mount the ExtremeZ-IP DFS volume from the Macintosh client and browse and utilize your DFS structure.
For home directories, unlike the basic solution where we have a DFS Root Emulator volume represent the namespace(s), we have a server represent the first half of the namespace (the DomainHost portion). An example will probably make this clear. If the DFS path to the users home directory is \\GLILABS\DFSHOMES\Sales\phd, at login that will be converted to afp://GLILABS.glilabs. com/DFSHOMES/Sales/phd, therefore we have to have a volume called DFSHomes on a server named GLILABS. The DFSClient script takes care of the first part but you need to make sure there is a volume on the server that matches the second portion of the DFS namespace. In this example, you would share the Sales folder. This folder should already exist In C:\Program Files\Group Logic\ExtremeZ-IP\DFS Volumes\namespace\ and just needs to be shared as an ExtremeZ-IP volume. This volume represents the specific DFS namespace on the DFS DomainHost where the users home directory is located. With this subvolume shared out, the Macintosh user will be able to use their DFS home directory.
Appendices
ServerSupportsReconnectUAM
ReconnectTimeout ServerSupportsAFP3Reconnect ReconnectServerKeyLifetime ServerEmbedsPasswordInReconnectCredential MaxDuplicateSessionsWaiting
ReconnectUAMExpirationInterval
The value of this registry key determines the interval at which the client is notified of the upcoming password expiration in minutes. The interval can be configured from 1 minute to 1440 minutes (1 day).
Appendix A 77
1. 2.
Modify the PrintAccountingLogFilePath in the registry. Set the value to the full path where you want the logs (e.g., C:\Logs\Log.txt)
A REG_SZ string entry in the registry controls custom configuration. The format for the string is to add types of data separated by a forward slash /. The format respects the order and number of types in the string value. For example, if you wanted to restrict your view to job_name, job_dateandtime, and job_printer only, you would enter job_name/job_dateandtime/job_printer as your string value. By default, ExtremeZ-IP has a specific column order. If no registry key is present, that order will be used. The following examples illustrate keys that would set up the default columns. They can be used as a starting point for customization.
..\Parameters4 \PrintRefreshable
Appendix A 78
File Locks - Number of file locks Bytes Received/sec - Number of bytes read from the network per second Bytes Transmitted/sec - Number of bytes sent on the network per second Note Users counters can be viewed as an individual user or as a total of all activity.
Appendix C: Configuring Guest Access Configuring Guest Access for Windows XP and Above
To support guest access when running under Windows XP and later operating systems you must change a Windows default security setting. Starting with Windows XP, the Anonymous Logon group is no longer a member of the Everyone group by default. Microsoft made this change because, if system administrators did not realize that anonymous users were members of the Everyone group, they might inadvertently grant them access to resources only intended for authenticated users. In order to enable guest access, ExtremeZ-IP requires that the Anonymous Logon group be a member of the Everyone group. For operating systems that do not support this behavior by default, a system-wide setting needs to be changed. To change this setting, do the following:
1. 2. 3. Open Local Security Policy. Go to Start > Settings > Control Panel > Administrative Tools > Local Security Policy. Navigate to Local Policies -> Security Options. Set the Network access: Let Everyone permissions apply to anonymous users setting to Enabled.
Appendix B 81
Appendix C 82
Appendix D 83
Appendix D 84
Appendix D 85
ExtremeZ-IP User Manual Some Zidget icons are licensed under the Creative Commons Attribution 2.5 License: http://creativecommons.org/licenses/by-sa/2.5/legalcode These icons are the original the work of: http://www.famfamfam.com/lab/icons/silk/ http://www.jodriozola.com/blog/?p=10
-------------------------------------------------------------------------------All trademarks and registered trademarks mentioned herein are the property of their respective owners.
Appendix D 86
Index
Index
Index
access to your computer 30 ACL 32, 38, 42, 44 Active Directory 32, 46 active/passive 18 adding serial numbers 40 Advanced Volume Properties 44 allow guests to connect 30 AppleTalk 37 installing 16 printers 54 ArchiveConnect 31, 43 auto_master file 74 Bonjour 37, 62 Bonjour printers disabling 55 setting network protocol 37 setting up for Macintosh 55 setting up for Windows 63 Bring online explicitly 43 cache 35 changing folder permissions 32 checking for SFM and SMB shares 14 Choose IP Printer 63 Clustering 17 clusters administering 27 configuring 20 creating a group 22, 24 ExtremeZ-IP support 17 installing 20 worksheet 19 cluster setup, diagram 18 codes setting up for print accounting 57 connection options File Server 30 counters 79 creators 48 Custom Quotas 43 dependency 17 DFS 22, 67, 71, 73, 74, 75 home directory 73, 75 Zidget service discovery 37 DFS Client Application 73
dialog box Administrator 47 Files 47 Files Opened by Macintosh Users 47 Log 48 Users 45 domain 46 dropped session reconnecting 77 encrypted logins 31 exporting the log 48 ExtremeZ-IP clustering 17 remote administration 40 ExtremeZ-IP Zidget 60 EZIPUTIL 77 failover 17 file archives 31 Filename Policy 36 Violations Report 36 Files dialog box 47 Files Opened by Macintosh Users dialog box 47 folders, properties of 44 group 17 cluster 22, 24 Guest Access 81 guests allowing 30 help 10 home directory 42 Home Directory 75 home directory support 30, 75 index cache size 35 index volumes for search 34, 35 Kerberos 16, 73 description 16 Knowledgebase 10 launching ExtremeZ-IP 14 legal notices 82 licenses, adding 40 log archive active log file 39 exporting 48 file server 48 print server copying to a text file 78 verbose logging options 39 Log dialog box 48 logon messages 30
Index
ExtremeZ-IP User Manual LPR printer 53 Macintosh permissions 44 system requirements 9 viewing those connected 45 Microsoft Cluster Servers 17 definitions 17 migrating dot underscore files 15 migrating SFM shares 16 migrating SMB shares 15 cluster 15 monitoring ExtremeZ-IP 79 multiple virtual servers 17 name, server 30 offline files 31, 43 password 44 connecting 46 length 9 notify of expiration 33 password expiration notifications 77 performance counters 79 permissions required for shared volumes 13 port settings with SFM use 13 PPDs associating with a print queue 54 creating for print accounting 59 print accounting logging information 56 setting up PPDs for Mac OS X users 59 using information 56 printers 51, 55 printing over TCP/IP Mac OS 9 63 Print Queue jobs dialog box 55 Send to AppleTalk Printer 54 Send to a Specified Directory 53 Send to LPR Print Queue 53 Send to Windows Print Queue 52 Print Queue Jobs 54 Print Server 51 properties of shared files and folders 44 quorum resource 18 quota 43 reconnecting dropped session 46 with Kerberos 47 register server on networks 37 registry keys print log entries to text files 78 reconnecting dropped session 77 registry keys, using 77 releases, latest 10 remote administration dialog box 40 resource 17 retry of printer jobs 31 root drive, sharing 13 security for volumes 30 serial numbers, adding 40 server name 30 servers, multiple 17 Service Location Protocol 9 Services for Macintosh 16 avoiding conflicts with ExtremeZ-IP 16 session reconnecting 46 with Kerberos 47 settings Security 32 setting up printers 51 specified directories 51 SFM 13, 14 SFM shares 14 checking for 14 shared files and folders 44 shared storage 18 sharing the root drive 13 SMB 15 SMB shares checking for 14 sparse index 35 Spotlight search 34, 35, 42 SSL 33 support 1 703 528-1555 10 system requirements 9 technical support 10 text files from print log entries 78 Time Machine 43 Time Machine quota 43 troubleshooting 57 UNIX permissions 32, 38 user name and password 46 Users dialog box 45 validation codes requiring for printing 51 setting up 57 viewing jobs being processed 55 log of printing activities 55 log of server activities 48 Macintosh users 45 volumes creating 41 sharing 41 warning about password expiration 33 Windows Error Reporting 39 Windows system requirements 9 Zidget 37, 60, 67, 73 helper 71 Location 38, 68 Master Server 38 Index