Mindvision Vise X For Mac

Leave a comment

Download now: Size: 17.2MB License: Shareware Price: $200 By: Shortcut Software: Installer VISE for Mac OS X 8.5 Installer VISE is quite simply the best software installer for the Macintosh. Download now: Size: 22.43MB License: Shareware Price: $650.00 By: MindVision Software.

Current as of KfM 4.0.3

Table of Contents

  • Really Important Notes
  • Installer Notes

Overview

Kerberos for Macintosh (KfM) 4.0.3 for Mac OS X provides Kerberos 4, KClient, Kerberos 5 and GSS implementations together in one unified package, with support for the various Mac OS X runtime environments. Kerberos for Macintosh 4.0.3 for Mac OS X consists of the Kerberos framework, CFM compatibility libraries, the Kerberos management application, the Kerberos Login Authenticator, basic command-line utilities, /usr/lib and /usr/include support. Also included is a preference file preconfigured for MIT.

The KfM 4.0.3 OS X installer installs all these components to the correct location on a Mac OS X volume while removing older and out-of-date KfM components. Since the components are installed at the system level, once they are installed by one user, KfM will be available to all users on the computer.

If you have any questions or comments, please send them to <krbdev@mit.edu> .

System Requirements of Components

The minimum system required for the components installed is Mac OS X 10.1.2. Only Power Macintosh machines are supported.

There is a separate installer for KfM 4.0 for Mac OS 8 & 9.

The Kerberos for Macintosh 4.0.3 OS X installer as distributed from MIT was built with Mindvision VISE 7.3. While this installer should build without problems in later versions of VISE, we have not tested it.

Getting Started

If you are working from the KfM installer source distribution, you should copy the KfM 4.0.3 Mac OS X binaries from the standard KfM 4.0.3 distribution (which you can download here) into the 'Put Binaries Here' folder.

Specifically, copy the contents of Kerberos for Mac 4.0.3:Binaries:Mac OS X: from the KfM distribution into the 'Put Binaires Here' folder of the installer source distribution.

The installer should automatically find the binaries once they are copied as described above. Then you can replace or add localized components as necessary.

Packages

Only an Easy Install option is available. Uninstall is also available, but this is not strictly a package.

Easy Install installs the Kerberos management application (a bundled Mach-O application), Kerberos.framework, Kerberos.bridge, Kerberos Support.bridge, Kerberos.loginAuthenticator, command-line utilities, /usr/include files, /usr/lib files, and edu.mit.Kerberos (the Kerberos preferences file) - see below for locations. The installer also installs a version of tar for temporary use by the installer, but this is deleted at the end of the install.

The installer will force a restart at the end of an install, and will try to quit all applications and force a restart at the end of an uninstall.

Build Targets

There are two build targets in the KfM 4.0.3 OS X installer - 'Default Target' and 'KfM 4.0 Silent'. The only difference between the two is that 'Default Target' will ask you for the name and location of the installer to be built (and you can choose whether to build a debug installer), whereas 'KfM 4.0 Silent' will just build a default-named non-debug installer in the same directory as the .vct file.

You should build this installer as a 'Carbon' installer. It is meant to run under Mac OS X only, and thus you should not build a 'Classic' version of it.

Really Important Notes

The Kerberos for Macintosh OS X installer has a variety of special features that you should be aware of before looking at or modifying the installer archive.

Custom Install Locations

One major design issue was that the KfM installer needs to install and uninstall files from Mac OS X directories that are not part of VISE's standard install locations (because they are not locatable by using FindFolder), such as the /usr directory and many of the /System locations. So we've created a set of custom install locations, which are built as an external code resource using C in CodeWarrior. The custom locations are compiled as a plug-in that is placed in the VISE application's folder.

Fortunately once specified in the installer archive, the custom install locations 'stick' in the installer archive and work without the plug-in being present, so in theory you shouldn't need the plug-in. In practice and for best results, however, you should copy the file ExternalCodeResources:KfMLocations:KfM Locations from the installer source distribution to the 'Install Locations' subfolder of your VISE application's folder before making any changes to the installer.

The custom install locations are:

Temporary/Old KfM Files
/System/Library/Authenticators
/System/Library/CFMSupport
/System/Library/Frameworks
/Library/Preferences
/Library/Receipts
/usr
/usr/bin
/usr/include
/usr/lib
/private/var/root/.Trash

The 'Temporary/Old KfM Files' location is special - the code first creates an 'Old Kerberos for Mac Files' directory in the /tmp directory if one doesn't exist, and then tells VISE how to find that directory.

/Library/Receipts location is not currently used, because you can't use custom install locations in the Installer Log location pop-up.

From now on this document will refer to these locations without necessarily specifying that they are custom locations; basically any location that looks like a Unix path is a custom location.

Tarred Files

Some of the files in the KfM OS X installer are .tar files that are installed and then untarred by calling a shell script compiled into a external code resource (see the VISE manual for more information about this). These shell scripts refer to a binary called 'kfmtar', which is a renamed version of gnutar installed by the KfM OS X installer.

We are installing the Kerberos.framework and /usr/include header files as Tar files to work around a bug in VISE 7.3. The bug is: VISE cannot properly re-create UNIX symlink files on Mac OS X disks formatted with UFS. This is an important issue because both the Kerberos.framework and /usr/include headers have symlinks. Stuffit Expander does not properly re-create the symlinks either, and our build system generated Tar files anyway, so it was simpler to use Tar files and untar them to work around this issue.

However, the tar that ships with Mac OS X cannot handle the very long pathnames used in Kerberos.framework, so we create the Tar file with gnutar. But gnutar is only installed on Mac OS X if the user has also installed the Developer Tools, which many users won't have done. So the installer installs a copy of gnutar - renamed to kfmtar to avoid possible conflicts - into the Temporary Items folder (on Mac OS X, this is in the /tmp directory), uses it to untar the two Tar files installed, and then deletes 'kfmtar' at the end of the install.

See the Shell Script Resources section at the bottom of this document for more information about the external shell script resources.

Uninstall Action Items

Most of the action items in the KfM Mac OS X installer are set to run on both install and uninstall (this is in contrast to the KfM installer for Classic Mac OS, which has its own special set of action items for uninstall). The action items serve a dual purpose - they move existing copies of KfM components out of the way at install time, and simply remove them at uninstall time. If you modify the installer to install additional files, be sure to add similar action items that run at uninstall time to remove them.

Guide to Files & Action Items

In the table below, actual files and folders are displayed in bold, whereas action items names are displayed in italics. Each action item has a definition of what it does, and then an explanation of why it does this.

Items are listed in the order in which they appear in the .vct. Some may be inside placeholder folders for organizational purposes; this list is equivalent to the order of items if the hierarchy was flattened.

Note that on Mac OS X, the 'Domain' part of the location is important - it can mean the difference between installing a file in the System, where all users can access it, and installing it in just the current User's directory.

Some of the Gestalts used are not part of the VISE default Gestalts - they are custom Gestalt checks which are included in the .vct file (you can easily create and edit the Gestalts in VISE using the Archive->Gestalts menu item).

FilesInstall To:ReplaceGestalts

Message Action Item:'Requires Mac OS X 10.1.2'

If the installer is run on an OS less than Mac OS X 10.1.2 (a check made using the custom Gestalt), a warning message that the installer will only work on 10.1.2 and greater is displayed.

KfM 4.0 final requires Mac OS X 10.1.2 or later 10.1 version to work properly.

We're doing this instead of using the built-in system version check of VISE because the message VISE displays would say 'This installer requires System 10.1.2 or greater,' which is not the correct way to describe the system. Unfortunately using an action item means this message won't come up until the user actually clicks on the 'Install' button.

Only runs on installs.

n/an/aLess Than Mac OS X 10.1.2

Stop Action Item: Stop if not Mac OS X 10.1.2

If the installer is run on an OS less than Mac OS X 10.1.2 (a check made using the custom Gestalt), this action item brings the installation to a halt before it can begin (the user is warned of this by the above action item).

Only runs on installs.

n/an/aLess Than Mac OS X 10.1.2

Message Action Item: Message OS X Too New

If the installer is run on an OS whose version is Mac OS X 10.2 or greater (a check made using the custom Gestalt), a warning message that KfM is not supported on this version of Mac OS X and thus the installer will not continue is displayed.

Mac OS X 10.2 contains a newer and significantly different version of KfM, and thus KfM 4.0.x should not be installed on it because it will not work properly, and we do not want to replace the new version of KfM with KfM 4.0.x.

Only runs on installs.

n/an/aGT or Equal Mac OS X 10.2

Stop Action Item: Stop if not Mac OS X 10.1.2

If the installer is run on an OS whose version is Mac OS X 10.2 or greater (a check made using the custom Gestalt), this action item brings the installation to a halt before it can begin.

See the preceding message action item for an explanation of why we do this.

Only runs on installs.

n/an/aGT or Equal Mac OS X 10.2

Message Action Item: Message 'Uninstall Warning'

This message warns the user that an uninstall on OS X will remove the parts of Kerberos that ship with Mac OS X 10.1.x, and provides the user with an opportunity to cancel the install if they want. If the user clicks on Cancel, the uninstall stops.

Only runs on uninstalls.

n/an/a

kfmtar

A renamed copy of the gnutar distributed with the Mac OS X Developer Tools. Used to untar the Kerberos.framework and /usr/include headers.

The tar that ships with Mac OS X cannot handle the very long pathnames used in Kerberos.framework, so we create the Tar file with gnutar. But gnutar is only installed on Mac OS X if the user has also installed the Developer Tools, which many users won't have done. So we install our own copy of gnutar - renamed to avoid possible conflicts and then delete it at the end of the install. See Tarred Files notes above.

Temporary Items, System DomainAlways

Library (folder)

This folder matches /Library . We aren't actually installing this folder, since it already exists on all Mac OS X systems, but since we want to put the installer log in /Library/Receipts and cannot use a custom install location to do that, we have to create a folder that points at the correct location for VISE to refer to.

Root of Startup Drive, System DomainNever

Receipts (folder)

This folder matches /Library/Receipts .

The installer log is placed here. See notes for the Library folder above.

Other.. (Library)Never
Authenticator Items(place holder folder - not installed)n/an/a

Move Action Item: Move Kerberos auth to OldKfM

Looks for a folder named 'Kerberos.loginAuthenticator' in /System/Library/Authenticators, System Domain and moves it and its contents to the 'Old Kerberos for Mac Files' folder.

Runs on install and uninstall.

n/aAlways

Kerberos.loginAuthenticator (folder & contents)

The Kerberos login authenticator bundle.

/System/Library/Authenticators, System DomainAlways
CFMSupport Items (place holder folder - not installed)n/an/a

Move Action Item: Move Kerberos.bridge to OldKfM

Moves any files in /System/Library/CFMSupport, System Domain whose file type/creator 'shlb'/'Krb ' to the 'Old Kerberos for Mac Files' folder. Matches and moves multiple files, to catch debug versions.

Moving old (and possibly out of date) 'Kerberos.bridge' files out of the way.

Runs on install and uninstall.

n/aAlways

Move Action Item: Move KerbSppt.bridge to OldKfM

Moves any files in /System/Library/CFMSupport, System Domain whose file type/creator 'shlb'/'Fuzz' to the 'Old Kerberos for Mac Files' folder. Matches and moves multiple files, to catch debug versions.

Moving old (and possibly out of date) 'Kerberos Support.bridge' files out of the way.

Runs on install and uninstall.

n/aAlways
Kerberos Support.bridge/System/Library/CFMSupport, System DomainAlways

Kerberos Support.debug.bridge

This item may not be found in all versions of the installer, especially those meant for final releases.

System/Library/CFMSupport, System DomainAlways
Kerberos.bridge/System/Library/CFMSupport, System DomainAlways

Kerberos.debug.bridge

This item may not be found in all versions of the installer, especially those meant for final releases.

System/Library/CFMSupport, System DomainAlways
Framework Items(place holder folder - not installed)n/an/a

Move action item: Move Kerberos.frame to OldKfM

Looks for a folder named 'Kerberos.framework' in /System/Library/Frameworks, System Domain and moves it and its contents to the 'Old Kerberos for Mac Files' folder.

Runs on install and uninstall.

n/aAlways

Kerberos.framework.tar

The tar file of the Kerberos.framework.

Set to call the 'untar Kerberos.framework' external shell script resource after installation to untar it. See Tarred Files and Shell Script Resources for more information.

/System/Library/Frameworks, System DomainAlways
Preferences Items (place holder folder - not installed)n/an/a

Move Action Item: Mv Kerberos Prefs to /Lib/Prefs

Searches the system preferences folder /System/Library/Preferences (indicated by 'Preferences Folder, System Domain') for a file named 'Kerberos Preferences' and moves it to /Library/Preferences .

This takes an existing old-style-named preferences file from the old location (this name and location were used by KfM 4.0a17 and earlier) and moves it to the current preferences location in preparation for being renamed.

Runs only on installs.

n/aIf Newer Modification Date

Rename Action Item: Rnm KerberosPrefs to edu.mit.Ke

Searches /Library/Preferences (specified as Preferences Folder, Local Domain) for a file named 'Kerberos Preferences' (the old name) and renames it to 'edu.mit.Kerberos' (the new name). This file should only be in this location as a result of the previous action item.

Because the action item is set to 'Never replace', it will only rename the file if there isn't already a file named 'edu.mit.Kerberos' in the directory (we don't want to replace a current prefs file with an older one).

Runs only on installs.

n/aNever

Move Action Item: Move Kerberos Prefs to OldKfM

Searches /Library/Preferences (specified as Preferences Folder, Local Domain) for a file named 'Kerberos Preferences' and moves it to the 'Old Kerberos for Mac Files' folder.

This is to remove any old prefs files that were not renamed by the previous action item because there was already an existing preferences file with the correct name.

Runs only on installs.

n/aIf Newer Modification Date

edu.mit.Kerberos

Don't replace existing prefs files which are probably valid (this includes an old one that may have been moved and renamed by the previous action items).

Preferences Folder, Local Domain is equal to /Library/Preferences .

Preferences Folder, Local DomainNever

Applications Items (placeholder folder - not installed)

n/an/a

Move Action Item: Move Kerberos.CB to OldKfM

Searches Applications, System Domain (/Applications) for a file named 'Kerberos.CB' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes an out-of-date and incorrectly named CFM Carbon version of the Kerberos management application, which has been superseded by the Mach-O version.

Runs only on installs.

n/aAlways

Move Action Item: Move Kerberos.CB.dbg to OldKfM

Searches Applications, System Domain (/Applications) for a file named 'Kerberos.CB.debug' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes an out-of-date and incorrectly named CFM Carbon debugging version of the Kerberos management application, which has been superseded by the Mach-O version.

Runs only on installs.

n/aAlways

Move Action Item: Move Kerberos to OldKfM

Searches Applications, System Domain (/Applications) for a file named 'Kerberos' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes the out-of-date CFM Carbon debugging version of the Kerberos management application, which has been superseded by the Mach-O version.

Runs only on installs.

n/aAlways

Move Action Item: Move Kerberos.debug to OldKfM

Searches Applications, System Domain (/Applications) for a file named 'Kerberos.debug' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes the out-of-date CFM Carbon debugging version of the Kerberos management application, which has been superseded by the Mach-O version.

Runs only on installs.

n/aAlways

Move Action Item: Move Kerberos.app to OldKfM

Searches Applications, System Domain (/Applications) for a bundled app (folder) named 'Kerberos.app' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes possibly out-of-date versions of the Mach-O Kerberos management application.

Runs on installs and uninstalls.

n/aAlways

Move Action Item: Move Kerberos.debug.app to OldK

Searches Applications, System Domain (/Applications) for a bundled app (folder) named 'Kerberos.debug.app' and moves it to the 'Old Kerberos for Macintosh Files' folder.

This item removes possibly out-of-date debugging versions of the Mach-O Kerberos management application.

Runs on both install and uninstalls.

n/aAlways

Kerberos.app

A bundled application (the .app won't show up in the Mac OS X finder), the Mach-O Kerberos management application.

Applications, System DomainAlways

Kerberos.debug.app

A bundled application (the App won't show up in the Mac OS X finder), a debugging version of the Mach-O Kerberos management application.

This item may not be found in all versions of the installer, especially those meant for final releases.

Applications, System DomainAlways
/usr/bin Items(place holder folder - not installed)n/an/a

Move Action Item: Move kdestroy to OldKfM
Move Action Item: Move kinit to OldKfM
Move Action Item: Move klist to OldKfM
Move Action Item: Move kpasswd to OldKfM

(4 separate action items)

All these action items search /usr/bin, System Domain for the files named as specified (kdestory, kinit, etc.) and moves them to the 'Old Kerberos for Macintosh Files' folder.

These action items remove possibly out-of-date versions of these files.

All these action items run on both install and uninstall.

n/aAlways

kdestory
kinit
klist
kpasswd

(4 separate files)

The basic UNIX command-line utilities.

/usr/bin, System DomainAlways

Find Action Item: Find /usr/include

Searches the /usr directory for the include directory. The result is used in the following action item.

Runs on both install and uninstall.

n/an/a

Jump Action Item: Jump To /usr/lib items

If the previous action item does not find a /usr/include directory on the user's computer, they do not have the Mac OS X Developer Tools installed. Since the /usr/include Kerberos headers are really only used by developers, they will not be installed if the Developer Tools haven't been installed. So we jump over the /usr/include items and continue the install at the '/usr/lib Items' placeholder folder if /usr/include is not found.

Likewise, we do this check on uninstall because attempting to uninstall items from a nonexistent folder would result in the installer giving an error.

Runs on both install and uninstall.

n/an/a
/usr/include Items(place holder folder - not installed)n/an/a

Move action item: Move Kerberos headers to OldKfM
Move action item: Move com_err.h to OldKfM
Move action item: Move des.h to OldKfM
Move action item: Move gssapi headers to OldKfM
Move action item: Move kerberosIV hdrs to OldKfM
Move action item: Move KerberosSupport to OldKfM
Move action item: Move krb.h to OldKfM
Move action item: Move krb5.h to OldKfM
Move action item: Move profile.h to OldKfM

(9 separate action items)

All these action items search /usr/include, System Domain for the files/symlinks specified and moves them to the 'Old Kerberos for Macintosh Files' folder. Note: some of the items (gssapi, kerberosIV, KerberosSupport) are UNIX symlinks to directories, and so search for aliases to folders; others are simply files.

These action items remove possibly out-of-date versions of these files.

All these action items run on both install and uninstall.

n/aAlways

includes.tar

Vec3 sample pack free download. The tar file of the Kerberos /usr/include headers.

Set to call the 'untar Kerberos includes' external shell script resource after installation to untar it. . See Tarred Files and Shell Script Resources for more information.

/usr/include , System DomainAlways
/usr/lib Items(place holder folder - not installed)n/an/a

Move action item: Move libcom_err.dylib to OldKfM
Move action item: Move libdes524.dylib to OldKfM
Move action item: Move libdes425.dylib to OldKfM
Move action item: Move libgssapi_krb5 to OldKfM
Move action item: Move libk5crypto to OldKfM
Move action item: Move libkrb4.dylib to OldKfM
Move action item: Move libkrb5.dylib to OldKfM

(7 separate action items)

All these action items search /usr/lib, System Domain for the files specified and moves them to the 'Old Kerberos for Macintosh Files' folder.

Note: libdes524.dylib is not a file that is installed by KfM 4.0 final. This is an incorrectly named library from the developmental releases of KfM 4.0 that we need to remove.

These action items remove possibly out-of-date versions of these files.

All these action items run on both install and uninstall.

n/aAlways

libcom_err.dylib
libdes425.dylib
libgssapi_krb5.dylib
libk5crypto.dylib
libkrb4.dylib
libkrb5.dylib

(6 separate files)

The UNIX compatibility libraries.

/usr/lib , System DomainAlways

Move Action Item: Move Old KfM Files to Trash 1

Searches the Temporary Items directory for an 'Old Kerberos for Mac Files' folder (created by the custom install location code when it's first used) and moves it to /private/var/root/.Trash .

Since the installer is running as the administrative user, the 'Trash' is /private/var/root/.Trash , not the user's Trash. This move action will fail if there's already an 'Old Kerberos for Mac Files' folder in /private/var/root/.Trash ; the next two action items deal with any failure.

The files are moved to root's Trash instead of the user's Trash for two reasons: (1) the installer is running as an administrative user (hence, root) and so VISE considers root to be the current user; and (2) some of the files we are removing - such as the Kerberos.framework - are owned by root. If we put them in the user's Trash, the user won't be able to delete them. Since VISE currently has no facility for changing file permissions of already-installed files, we put files into the root's Trash instead.

We could have deleted all the old KfM files outright instead of moving them around, but we thought providing a backup of the original files, even though they are mostly inaccessible to the average user, was better.

Runs on both install and uninstall.

n/aAlways

Delete Action Item: Delete old Old KfM Files folder

If the 'Move Old KfM Files to Trash 1' action item failed, searches /private/var/root/.Trash for a folder called 'Old Kerberos for Mac Files' and deletes it.

If 'Move Old KfM Files to Trash 1' failed, it's because there's already an 'Old Kerberos for Mac Files' in /private/var/root/.Trash . An interaction between VISE and Mac OS X causes attempts to replace a folder with contents by moving another folder on top of it to fail. So this action item removes any existing older 'Old Kerberos for Mac Files' folder in root's Trash so we can move the one created by the current run of the installer there.

We don't just want to rename the older folder of files, because then every time a user runs the installer more files appear in root's Trash, which the user probably won't empty.. so old copies of KfM could eventually fill the hard disk! So we delete it outright. We only keep the last set of old KfM files.

Runs on both install and uninstall.

n/an/a

Move Action Item: Move Old KfM Files to Trash 2

If the 'Move Old KfM Files to Trash 1' action item failed, searches Temporary Items for an 'Old Kerberos for Mac Files' folder (created by the custom install location code when it's first used) and moves it to /private/var/root/.Trash .

n/aAlways

Delete Action Item: Delete kfmtar

Searches the 'Temporary Items' directory for a file named 'kfmtar' (installed at the beginning of the install) and deletes it.

kfmtar, as explained in Tarred Files above, is only for temporary use by the installer, so we clean up afterwards.

Runs only on install.

n/an/a

Message Action Item: Message 'Restart Uninstall'

This action item shows a dialog warning the user that the installer is going to restart when an uninstall finishes. There is no option to cancel the restart, because leaving some Kerberos stuff running in memory after removing it would be bad.

The action item is set to call the external code resource 'Restart' after the message is displayed, since VISE does not actually provide a built-in way to force a Restart after an uninstall.

Only runs on uninstalls.

n/an/a

Message Action Item: Message 'Restart Install'

This action item shows a dialog warning the user that the installer is going to restart when an install finishes. There is no option to cancel the restart, because we want to force memory resident processes of KfM to quit since in case we've just installed a newer version.

We need this action item for two reasones: (1) to call the 'Restart' external code resource, and (2) because in the installer settings we have told VISE to suppress 'success' dialogs in order to suppress an excess message during uninstall, and it turns out that the standard VISE restart warning is considered a 'success' dialog, and is suppressed as well. Since it's kind of alarming for the installer to restart without any warning when it's done, this message action item simply emulates the original VISE behavior.

The action item is set to call the external code resource'Restart' after the message is displayed, since the VISE Restart functionality under Mac OS X is unreliable.

Only runs on installs.

If its possible, give me: a. Instruction how to set up path on Blackberry Q10 b. Where to download the installer Thanks Best Regards Limakaki. Cara download path di blackberry q10 download. Free Download Path for Blackberry - Download the application Path for. Of Blackberry phones like BlackBerry Q10, BlackBerry, Blackberry. If you're new to a BlackBerry 10 device, you might be eager to learn more about what makes it different from other. For example, you can change settings, download apps. Accounts, it is recommended that you enter the IMAP Path Prefix. Delete old media files to free up storage space and try again.

n/an/a

Installer Notes

Special Installer Settings

There are a few settings of special note in the 'Installer Settings' of the Kerberos for Macintosh OS X installer:

Require OS X Authentication (Attributes tab) - Since the installer installs files in directories owned by root, the installer must have administrator access. This option is checked so that the installer will prompt for an administrator password when it starts up. The install will not continue if a password isn't entered. The installer would fail when attempting to install some files if this option was unchecked.

Allow Installs to Non-HFS volumes (Behavior tab) - This option must be checked in order to allow installs to UFS formatted volumes. (This option is only in VISE 7.3 and earlier - VISE 7.4 does not provide a way to prevent installs to non-HFS volumes.)

Install Log File Location (Extras tab) - By default VISE will place the install log on the root level of the drive (that is, the / directory). We regarded that as undesirable. So instead we put the install log in the /Library/Receipts directory, which is where other system stuff puts install logs.

Installation Location of 'edu.mit.Kerberos' File

The edu.mit.Kerberos preferences file may be found in two locations on a Mac OS X volume, the system preferences in /Library/Preferences and the user preferences in /User/userid/Library/Preferences . The KfM installer installs the edu.mit.Kerberos file in the system location so that it is accessible by all users of a Mac OS X machine, and you should do the same. See the Kerberos Preferences on Mac OS X Documentation for a full explanation.

Uninstall

Uninstall support has been built into the installer. Files that will be uninstalled are: the Kerberos management application (both debug and non-debug), Kerberos.framework, Kerberos.bridge (both debug and non-debug), Kerberos Support.bridge (both debug and non-debug), Kerberos.loginAuthenticator, /usr/bin Kerberos command-line utilities, /usr/include Kerberos headers, /usr/lib Kerberos libraries, and edu.mit.Kerberos (in /Library/Preferences, does not remove the copy in the user's home directory).

Instead of using the VISE built-in uninstall feature, the KfM OS X installer uses a bunch of action items that move the files to an 'Old Kerberos for Macintosh Files' folder in the Trash (these are the same action items used to move existing files out of the way when an install is done), and then a special external code resource to force a restart afterwards.

We don't use the built-in uninstall feature because it attempts to delete items outright, which causes two problems - you cannot recover the files if they are deleted directly, and some of the items cannot be deleted outright because they are still in use even when all applications are quit.

The next problem is that we'd like to force a restart at the end of uninstall, because some Kerberos processes are still active even though KfM has been uninstalled. However, VISE does not provide a way to force a restart at the end of uninstalls. So we wrote an external code resource called 'Restart' that is called on uninstall after we display a message warning the user that we're going to restart.

See also the Really Important Notes section near the top of this document.

Code Resources

The Kerberos for Macintosh installer uses a couple of external code resources to add functionality to VISE. The code for these resources along with compiled binaries is included with the installer distribution. The code resources require CodeWarrior 7.2 to be compiled, although you shouldn't need to make changes to them and recompile them. Here are some brief explanatory notes about them.

Restart

On Mac OS 8 & 9, sends a restart AppleEvent to the Finder. On Mac OS X, sends a restart AppleEvent to the LoginWindow.

Used to force a restart after uninstall in the Mac OS 8 & 9 installer, used to force a restart after both install and uninstall on OS X (VISE's restart is unreliable on OS X).

Timebomb

Displays a dialog warning that the installer will expire on a certain day, and once that day arrives, tells the installer to refuse to run.

Installers that contain development and prerelease versions of KfM include and call the Timebomb code. Final versions do not. The installer source distribution does not include references to the Timebomb external code resource or the code resource itself.

Shell Script Resources

VISE allows you to put UNIX shell scripts in resources that can then be called by your installer to do specialized tasks. The Kerberos for Macintosh installer uses a couple of these. See the VISE manual for information on how they are created; the ones used by the KfM OS X installer are included in the file 'UntarShellScripts.rsrc' in the 'External Code Resources' folder. The shell scripts are simply text stored as a resource, you should be able to read and edit them (although editing should not be necessary) using ResEdit or Resourceror.

These shell scripts have absolute paths in them to refer to the files in question.

untar Kerberos.framework

Calls kfmtar to untar the Kerberos.framework.tar.

untar Kerberos includes

Calls kfmtar to untar the Kerberos /usr/include headers.

Questions or comments? Send mail to macdev@mit.edu
Last updated on $Date: 2003/11/19 20:36:46 $
Last modified by $Author: smcguire $