The downloaded Castanet tuner is a compressed tar file that installs like most similary packaged applications. Installation takes just a couple of minutes.
Prerequisites
What's Installed Where
Installation Step by Step
Configuration Step by Step
If you print this page, installation will take up less screen space, and you'll have a convenient place to check off each prerequisite and installation step as you complete it.
Before you install the Tuner, be sure your computer has the following:
If your computer is behind a firewall you'll need to provide the Tuner with proxy information. For the quickest and smoothest Tuner installation, gather the following before you begin:
Before you begin installation:
Installing the Tuner creates two directories that contain a number of subordinate files and directories.
castanet
; it contains directories called
tuner
and jdk
. The tuner
directory contains the Tuner files; the jdk
directory
contains the Java Developer's Kit. If you install other Marimba
programs, they will create other directories subordinate to
castanet
. Tuner installation will not disturb
non-tuner directories.
$HOME/.marimba/files
. Installing a new Tuner version
does not disturb channels downloaded with older Tuner versions.
castanet
program directory created (or used, if
it exists). These instructions assume the install directory is
/usr/local
but you can install in any writeable
directory; the install directory must be writable because the
Tuner updates itself. If you already have a castanet
directory choose its parent, e.g., if
/usr/local/castanet
exists, install into
/usr/local
.
Note: All Castanet programs must be installed in the same directory, along with the JDK.
prompt> mv tuner1_0b3.tar.Z /usr/local
Note: the Tuner file you download may have a slightly different
name; in particular b3
might be b4
or
might be absent.
prompt> cd /usr/local
prompt> uncompress tuner1_0b3.tar.Z
prompt> tar xvf tuner1_0b3.tar
/castanet/tuner/bin/tuner
When you run the Tuner for the first time, it prompts you for configuration information by presenting a series of dialogs for you to fill in. If you've configured an older version of the Tuner, that information is presented in the dialogs to save you a little typing. You can change configuration settings later by clicking the Tuner's Configure tab.
When you start an unconfigured Tuner, an Castanet Tuner dialog appears.
(Pressing Help will bring up a Web page explanation of each dialog.)
A User Information dialog appears.
Fill in as much information as you wish to make available to channel publishers. If a channel publisher has requested it, the Tuner will send your user information to the publisher when the Tuner updates the channel.
An Update Mailcap File dialog appears.
Web browsers see channels as MIME (multimedia Internet mail exchange) types analogous to movie or audio types. For a Browser to start the Tuner when you click on a Web page link to a channel, an entry must be made in your
$HOME/.mailcap
file associating the channel MIME type with the Tuner.
An HTTP Proxy Configuration dialog appears.
A Marimba Proxy Configuration dialog appears.
A Tuner Update dialog appears.
The Tuner is a channel and can therefore update itself. This dialog gives you the opportunity to update the Tuner you downloaded (perhaps some time ago). You can do this now or not, and you can do it whenever you like later.
A progress bar appears showing progress.
An Update Complete dialog appears.
A Finished Tuner Update dialog appears.
Configuration is complete; the Tuner user interface appears.
Remember, to change the configuration data you have entered above, click the Tuner's Configure tab.
Copyright
© 1997 Marimba, Inc. All rights reserved.