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.