USING MACZEPHYR OUTSIDE OF MIT -- 30 NOVEMBER 1999 -------------------------------------------------- NOTE: MacZephyr cannot send "interrealm" zephyr messages, that is, it only works within your university/organization's computer system (technically, within a single Kerberos realm). CONFIGURING MACZEPHYR FOR USE OUTSIDE OF MIT -------------------------------------------- To use MacZephyr locally, you need to edit several of its resources (with a resource editing utility such as ResEdit or Resourcer). Templates for these resources are included in MacZephyr for easy editing. MacZephyr is distributed with the MIT defaults. Consult your local experts to find out which machine names you should be using. Zephyr Servers -------------- MacZephyr first tries to use Hesiod, a system for locating the servers a certain program needs, to look up the hostnames of the zephyr servers. If your network supports Hesiod, edit the HSRV resources to be the hostnames of your Hesiod servers. If you do not use Hesiod, delete the HSRV resources to disable it. MacZephyr will then look in the ZSRV resource for the hostname of the zephyr server. Note that only one zephyr server's name can be entered; if you have more than one, be careful which one you pick. You should edit the ZSRV resource to an appropriate machine name as a backup anyway (in case Hesiod fails for some reason). Kerberos Servers ---------------- MacZephyr uses KClient to determine the Kerberos realm and the name of the Kerberos servers to use. You cannot disable the use of Kerberos in MacZephyr. (While there are resources for Kerberos servers in the MacZephyr resource fork, they are ignored and not used.) KClient 1.62 or later (the control panel version) provides a reasonable interface for editing the Kerberos realm and server information KClient uses. Resource Reference ------------------ Here is a list of MacZephyr resources that you'll need to edit to use MacZephyr at a non-MIT location, along with a brief description of what they are: HSRV - a list of Hesiod servers to use. To disable Hesiod, delete these resources. ZSRV - a default zephyr server; used as a fallback if HSRV resources are not present or Hesiod lookup fails. Right now MacZephyr only looks for one backup zephyr server, so if you have more than one server, be careful which one you pick. TSVL - list of time servers which one of the libraries that MacZephyr depends on uses in some obscure way. You should update these, or MZ may display incorrect timestamps in your messages. (no longer used) KSVR - list of Kerberos servers (out of date; MacZephyr now uses the servers listed in KClient, not its own internal resources). (no longer used) KRML - the name of the Kerberos realm to use (out of date; MacZephyr now uses the realms listed in KClient, not its own internal resources). SOURCE CODE ----------- Source code for MacZephyr, 1.3.2, is avaiable at: If you fix any bugs or add any useful features, we would appreciate receiving patches for them. We may or may not add them in as part of future releases of MacZephyr. DOCUMENTATION, SUPPORT, AND OTHER IMPORTANT STUFF ------------------------------------------------- Copyright: This distribution is Copyright 1999 by the Massachusetts Institute of Technology. Please see the section "COPYRIGHT" at the end of this document for the exact terms that this software is licensed. Documentation: The documentation is targeted at MIT users but you may be able to use large portions in preparing local documentation. Be sure to preserve the MIT copyright notice if you do reproduce portions of these manuals. Please note that the support phone numbers and e-mail addresses listed in the documentation are for MIT users only. Support: MacZephyr and the other items in this distribution are provided as-is and without any support from MIT. We have created a mailing list for discussion about MacZephyr, called . You can have yourself added to the list by sending mail to . We have very little people-power to devote to answering questions and comments about MacZephyr so please don't be offended if you don't get a response to your questions from the developers. This list is yours as (hopefully) MacZephyr users and we will step in when we can to field questions and respond to comments. --MIT Information Systems COPYRIGHT & LICENSE AGREEMENT ----------------------------- Project Athena, Athena Dashboard, Athena MUSE, Kerberos, X Window System, TechInfo, Zephyr and MacZephyr are trademarks of the Massachusetts Institute of Technology (MIT). Athena, Discuss, Hesiod, Moria, OLC, and TechMail are registered trademarks of MIT. No commercial use of these trademarks may be made without prior written permission of MIT. This software is being provided to you, the LICENSEE, by the Massachusetts Institute of Technology (M.I.T.) under the following license. By obtaining, using and/or copying this software, you agree that you have read, understood, and will comply with these terms and conditions: Permission to use, copy, modify and distribute this software and its documentation for any purpose and without fee or royalty is hereby granted, provided that you agree to comply with the following copyright notice and statements, including the disclaimer, and that the same appear on ALL copies of the software and documentation, including modifications that you make for internal use or for distribution: Copyright 1999 by the Massachusetts Institute of Technology. All rights reserved. THIS SOFTWARE IS PROVIDED "AS IS", AND M.I.T. MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. By way of example, but not limitation, M.I.T. MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. The name of the Massachusetts Institute of Technology or M.I.T. may NOT be used in advertising or publicity pertaining to distribution of the software. Title to copyright in this software and any associated documentation shall at all times remain with M.I.T., and LICENSEE agrees to preserve same.