The CastanetTM Tuner
Installing on Solaris
The downloaded Castanet tuner is a compressed tar file that installs
like most similary packaged applications. Installation takes just a couple
of minutes.
Contents
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.
Prerequisites
Hardware Requirements
Before you install the Tuner, be sure your computer has the following:
- a SPARCstation running Solaris 2.4 or later installed
- at least 16 megabytes of installed RAM
- at least 10 megabytes of free disk space to hold the Tuner files; you'll
need additional disk space for the channels you subscribe to
- a direct (hard-wired) Internet connection; if you can read the Marimba
home page (www.marimba.com) in a Web browser, you have an Internet connection
Proxy Information
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:
- If your site uses an HTTP proxy, obtain its host name and port number.
You can get this information from a network administrator, or from a Web
browser that you know can reach the Internet. In Netscape Navigator 3,
choose Options:Network Preferences, then press the Proxies tab.
- If No Proxies is selected, your site does not use an HTTP proxy.
- If Manual Proxy Configuration is selected, press View... to see the
list of proxies; write down the HTTP proxy name and port number.
- If Automatic Proxy Configuration is selected, open the URL listed next
to it with your Browser and write down the HTTP proxy's host name and port
number.
- If your site uses a Castanet proxy, obtain its host name and port number
from a network administrator. Although the Tuner does not require one,
a Castanet proxy substantially improves Tuner and firewall performance.
- Some proxies require a user name and password. Web browsers do not
record these, but ask for them as needed; if your Web browser has never
asked you to supply these items, you probably don't need to enter them
here. If your Web browser asks you for a proxy user name and password,
enter the same values you supply to the Web browser here. If you aren't
sure whether you need a proxy user name and password, ask your network
administrator.
Clean Up First
Before you begin installation:
- Quit any running Marimba programs now. Installation will fail if any
Marimba programs are running.
- Uninstall the old Tuner version if you
have one; uninstalling does not disturb channels you have downloaded with
older versions of the Tuner.
What's Installed Where
Installing the Tuner creates two directories that contain a number of
subordinate files and directories.
- The program directory holds the Tuner program and related files.
The program directory is called 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.
- The channel directory holds the channels you subscribe to with
the Tuner. The channel directory is $HOME/.marimba/files. Installing
a new Tuner version does not disturb channels downloaded with older Tuner
versions.
Installation Step-by-Step
- Choose an install directory, the directory in which you want the 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.
- Move the downloaded Tuner file to the install directory, for example:
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.
- Uncompress the downloaded file, for example:
prompt> cd /usr/local
prompt> uncompress tuner1_0b3.tar.Z
- Create the Tuner files from the tar file, for example:
prompt> tar xvf tuner1_0b3.tar
- Optionally, remove the tar file.
- Integrate the tuner with your desktop as you wish; the executable is
invoked by the script installdir/castanet/tuner/bin/tuner
- Start the Tuner.
Configuration Step by Step
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.
- Press Next>.
(Pressing Help will bring up a Web page explanation of each dialog.)
A User Information dialog appears.
User Information
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.
Update Mailcap
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.
Proxy Configuration
Tuner Update
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.
- To have the Tuner update itself
- click Next>.
A progress bar appears showing progress.
An Update Complete dialog appears.
- Click Next>.
- To forego updating the Tuner, click Skip.
A Finished Tuner Update dialog appears.
- Click Finish.
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.