<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
<TITLE>Coda File System User and System Administrators Manual: Installing and Configuring a Coda Client </TITLE>
<LINK HREF="manual-9.html" REL=next>
<LINK HREF="manual-7.html" REL=previous>
<LINK HREF="manual.html#toc8" REL=contents>
</HEAD>
<BODY>
<A HREF="manual-9.html">Next</A>
<A HREF="manual-7.html">Previous</A>
<A HREF="manual.html#toc8">Contents</A>
<HR>
<H2><A NAME="s8">8. Installing and Configuring a Coda Client </A></H2>
<P>
<A NAME="ClientInstall"></A> <P>A Coda client can be run on any workstation that has kernel support
for Coda in its kernel. This chapter assumes the chapter on
<A HREF="manual-6.html#KernelsforCoda">Configuring Kernels for use with Coda</A> has
been read. It contains valuable information for building a kernel if
a pre-built kernel with Coda support (or loadable coda kernel modules)
cannot be used. Supported UNIX™-like platforms are currently Linux,
FreeBSD and NetBSD.
<P>
<H2><A NAME="ss8.1">8.1 Installing and Configuring the Coda Client Binaries and Documentation</A>
</H2>
<P>
<P>We currently provide binary distributions of the Coda client software
for Red Hat Linux (i386 and Sparc), FreeBSD and NetBSD (i386).
Red Hat Linux's rpm package format is supported. NetBSD 1.3.X and FreeBSD
package format are supported as well.
Please consult the <CODE>INSTALL.<platform></CODE> available on
<A HREF="ftp://ftp.coda.cs.cmu.edu/pub/coda">ftp://ftp.coda.cs.cmu.edu/pub/coda</A><CODE>/<platform></CODE>
for the current version of Coda and for last minute updates which possibly have not
made their way into the manual. To install the binaries for each platform,
the following instructions apply:
<P>
<DL>
<P>
<DT><B>For Linux</B><DD><P>Obtain:
<A HREF="ftp://ftp.coda.cs.cmu.edu/pub/coda/linux/i386/">ftp://ftp.coda.cs.cmu.edu/pub/coda/linux/i386/</A>
<UL>
<LI><CODE>coda-debug-module-<kernel_version>-<coda_release>.i386.rpm</CODE></LI>
<LI><CODE>coda-debug-clients-<kernel_version>-<coda_release>.i386.rpm</CODE></LI>
<LI><CODE>coda-doc-<coda_release>.i386.rpm</CODE></LI>
</UL>
<P><EM>NOTE:</EM> We provide a binary glibc (GNU C library) version of
Coda for Red Hat 5.X and higher. Coda has run successfully on other
versions of Linux and with different C libraries too.
<P>To install the binary and documentation packages, do:
<UL>
<LI><CODE>rpm -Uvh coda-module-<kernel_version>-<coda_release>.i386.rpm</CODE></LI>
<LI><CODE>rpm -Uvh coda-debug-clients-<kernel_version>-<coda_release>.i386.rpm</CODE>
<P>
</LI>
<LI><CODE>rpm -Uvh coda-doc-<coda_release>.i386.rpm</CODE></LI>
</UL>
<P>
<DT><B>FreeBSD and NetBSD:</B><DD><P>For FreeBSD, obtain:
<A HREF="ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/">ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/</A><CODE><OS-RELEASE>/i386/</CODE>
<P>
<P>For NetBSD, obtain:
<A HREF="ftp://ftp.coda.cs.cmu.edu/pub/coda/netbsd/">ftp://ftp.coda.cs.cmu.edu/pub/coda/netbsd/</A><CODE><OS-RELEASE>/i386/</CODE>
<P>Once the binary and documentation packages have been obtained, the following
will install them:
<UL>
<LI><CODE>pkg_add coda-clients-<OS_RELEASE>-<coda_release>/</CODE></LI>
<LI><CODE>tar zxfc coda-doc-<coda_release>.tgz -C /usr/share</CODE></LI>
</UL>
<P>Please make sure the correct path for your platform is set
in your environmental PATH variable:
<P>
</DL>
<P>
<DL>
<P>
<DT><B>For Linux:</B><DD><P>Coda installs in the standard /usr tree:
<BLOCKQUOTE><CODE>
<PRE>
/usr/sbin
/usr/bin
</PRE>
</CODE></BLOCKQUOTE>
<P>
<DT><B>For FreeBSD:</B><DD><P>Coda installs in the /usr/local tree:
<BLOCKQUOTE><CODE>
<PRE>
/usr/local/sbin
/usr/local/bin
</PRE>
</CODE></BLOCKQUOTE>
which is not usually part of the FreeBSD path search, particularly
for the root account. Please make sure this is part of your
seach PATH.
<P>
<DT><B>NetBSD:</B><DD><P>Please note the NetBSD has elected to create a new tree to install
NetBSD packages into (NetBSD uses <CODE>/usr/pkg</CODE> instead of
<CODE>/usr/local</CODE>). Coda creates package based on this
<CODE>/usr/pkg</CODE> tree. Please make sure this tree is in your search
path as the /usr/pkg is not part of the default PATH settings under
NetBSD.
<P>
</DL>
<P>Once the binaries and documentation are installed, configuration of
Venus is identical for all platforms when
<CODE>venus-setup</CODE> is used. To run the script, type:
<P>
<BLOCKQUOTE><CODE>
<PRE>
venus-setup <comma,seperated,list,of,servers> <cache_size_in_kilobytes>
</PRE>
</CODE></BLOCKQUOTE>
. For example,
<P>
<BLOCKQUOTE><CODE>
<PRE>
venus-setup micky,minnie,goofy 40000
</PRE>
</CODE></BLOCKQUOTE>
<P>will setup up <CODE>venus</CODE> to look for the set of servers micky, minnie
and goofy and configure Venus to use 40MB of disk space for caching. This
information is kept in <CODE>/usr/coda/etc/vstab</CODE>.
<P><EM>NOTE:</EM>At least one Coda server must be specified and the minimum
cache size is 10MB ( <CODE>10000</CODE> ).
<P>This script not only creates <CODE>/usr/coda</CODE>
and the necessary sub-directories, but creates <CODE>/usr/coda/etc/vstab</CODE>,
and adds necessary Coda port numbers to <CODE>/etc/services</CODE>.
<P>To start venus for the first time, become root and issue the following
commands:
<BLOCKQUOTE><CODE>
<PRE>
# venus -init &
# xterm -e tail -f /usr/coda/etc/console &
</PRE>
</CODE></BLOCKQUOTE>
The last command allows you to monitor Venus as it reports messages
to <CODE>/usr/coda/etc/console</CODE>.
<P>
<H2><A NAME="ss8.2">8.2 Upgrading from a previous Release</A>
</H2>
<P>
<P>If you are upgrading Coda from a previous release, do not
run <CODE>venus-setup</CODE> again! Simply obtain
the packages for your platform as indicated above. Then,
shutdown venus by becoming root and issue the following command:
<BLOCKQUOTE><CODE>
<PRE>
# vutil -shutdown
</PRE>
</CODE></BLOCKQUOTE>
Next, install the binary packages following the installation instructions
above. Make sure you have the appropriate kernel for *BSD systems
or the correct module for Linux systems. The <CODE>INSTALL.<platform></CODE>
document available from the ftp site will contain relevant notes about
upgrading the kernel for *BSD systems and the module for Linux systems.
INSTALL.<platform> will provide necessary advice on which
kernel to use with a provided Coda release.
<P>Also, the Chapter on
<A HREF="manual-6.html#KernelsforCoda">Installing and Configuring a kernel for use with Coda</A> has information on configuring and building
a kernel kernel (or loadable module) if a pre-build kernel or module
won't work for the target platform.
<P>Once the new binaries are installed and the any necessary kernel updates are
completed, you need to start the new venus for the first time by becoming
root and typing:
<BLOCKQUOTE><CODE>
<PRE>
# venus -init &
</PRE>
</CODE></BLOCKQUOTE>
The <-init> flag is used to re-initialize the
<CODE>/usr/coda/venus.cache/</CODE>.
<P>
<H2><A NAME="ss8.3">8.3 Configuration Changes made by venus-setup</A>
</H2>
<P>
<P>This section describes the changes that must be made to various
configuration files. Samples of the files are contained in Appendix
<A HREF="manual-18.html#ExampleFiles">XXX</A>.
<P>
<H3>/usr/coda/etc/vstab</H3>
<P>Create a <CODE>vstab</CODE> file in <CODE>/usr/coda/etc</CODE> to contain
the Coda file system table information. The contents of this
file are explained in the man page <CODE>vstab(5)</CODE>.
<P>
<H3>/etc/rc.*</H3>
<P>To automatically
start Venus at boot time, the script <CODE>rc.venus</CODE> is provided
in <CODE>/usr/local/etc</CODE> for FreeBSD systems and <CODE>/usr/pkg/etc</CODE>
for NetBSD. <CODE>venus.init</CODE> is provided for Red
Hat Linux in <CODE>/etc/rc.d/init.d</CODE>.
<P>Linux uses should create the following symbolic link if it doesn't already
exist:
<BLOCKQUOTE><CODE>
<PRE>
ln -sf /etc/rc.d/init.d/venus.init /etc/rc.d/
</PRE>
</CODE></BLOCKQUOTE>
This will allow <CODE>init</CODE> to process the file and start Venus
at boot time on Red Hat Linux systems.
<P>*BSD systems should append the following line to <CODE>/etc/rc.local</CODE>:
<DL>
<DT><B>For FreeBSD:</B><DD><P>
<BLOCKQUOTE><CODE>
<PRE>
if [ -f /usr/local/etc/rc.venus ]; then
. /usr/local/etc/rc.venus
fi
</PRE>
</CODE></BLOCKQUOTE>
<P>
<DT><B>For NetBSD:</B><DD><P>
<BLOCKQUOTE><CODE>
<PRE>
if [ -f /usr/pkg/etc/rc.venus ]; then
. /usr/pkg/etc/rc.venus
fi
</PRE>
</CODE></BLOCKQUOTE>
<P>
</DL>
<P>
<H3>/etc/services</H3>
<P>
<P>The following port numbers are added to <CODE>/etc/services</CODE> by
<CODE>venus-setup</CODE>:
<BLOCKQUOTE><CODE>
<PRE>
coda_opcons 1355/udp # Coda opcons
coda_auth 1357/udp # Coda auth
coda_udpsrv 1359/udp # Coda udpsrv
coda_filesrv 1361/udp # Coda filesrv
coda_venus 1363/udp # Coda venus
coda_backup 1407/tcp # coda backup service
codacon 1423/tcp venus.cmu # Coda Console
coda_aux1 1431/tcp # coda auxiliary service
coda_aux1 1431/udp # coda auxiliary service
coda_aux2 1433/tcp # coda auxiliary service
coda_aux2 1433/udp # coda auxiliary service
coda_aux3 1435/tcp # coda auxiliary service
coda_aux3 1435/udp # coda auxiliary service
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H3>/dev/cfs0</H3>
<P>The following major and minor numbers are used for the various
platforms:
<P>
<UL>
<LI>Character-special with Major 67 and minor 0 for Linux
<BLOCKQUOTE><CODE>
<PRE>
# mknod /dev/cfs0 c 67 0
</PRE>
</CODE></BLOCKQUOTE>
</LI>
<LI>Character-special with Major 93 and minor 0 for FreeBSD
<BLOCKQUOTE><CODE>
<PRE>
# mknod /dev/cfs0 c 93 0
</PRE>
</CODE></BLOCKQUOTE>
</LI>
<LI>Character-special with Major 46 and minor 0 for NetBSD 1.2
<BLOCKQUOTE><CODE>
<PRE>
# mknod /dev/cfs0 c 46 0
</PRE>
</CODE></BLOCKQUOTE>
</LI>
<LI>Character-special with Major 51 and minor 0 for NetBSD 1.3
<BLOCKQUOTE><CODE>
<PRE>
# mknod /dev/cfs0 c 51 0
</PRE>
</CODE></BLOCKQUOTE>
</LI>
</UL>
Please be sure to check the <CODE>INSTALL.<platform></CODE> to make
sure these numbers have not changed. For Linux and FreeBSD, the above
numbers are officially registered. Coda on NetBSD at present does not
have formally registered major device numbers so these are subject to
change from release to release.
<P>
<H2><A NAME="ss8.4">8.4 Where Data and Configuration Information is Stored</A>
</H2>
<P>
<UL>
<LI><CODE>/usr/coda/etc</CODE> Coda configuration files critical for Venus startup.</LI>
<LI><CODE>/usr/coda/venus.cache</CODE> Cached copies of Coda files.</LI>
<LI><CODE>/usr/coda/spool</CODE> Save CMLs from aborted reintegrations.</LI>
<LI><CODE>/usr/coda/tmp</CODE> Temporary hoard related files.</LI>
<LI><CODE>/etc/services</CODE> Various port numbers used by Coda for client
and server communication.</LI>
</UL>
<HR>
<A HREF="manual-9.html">Next</A>
<A HREF="manual-7.html">Previous</A>
<A HREF="manual.html#toc8">Contents</A>
</BODY>
</HTML>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
211238da6d926d1ca4390483bb29f586
>
files
>
43
