<HTML
><HEAD
><TITLE
>Pine Configuration</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="Pine-Exchange mini-HOWTO"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Exchange Server Configuration"
HREF="exchange.html"><LINK
REL="NEXT"
TITLE="Example Configuration"
HREF="example.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Pine-Exchange mini-HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="exchange.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="example.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="PINE">5. Pine Configuration</H1
><P
>Pine has three types of configuration files we will concern ourselves with. Each
of them can contain all the same settings, but with varied syntax. The decreasing
order of precedence for each setting is as follows: /etc/pine.conf.fixed,
~/.pinerc, and /etc/pine.conf. Basically this means if Pine is looking for a
specific setting it first checks pine.conf.fixed, if it does not exist it checks
~/.pinerc, if it does not exist it finally checks /etc/pine.conf.
<P
></P
><UL
><LI
><P
> ~/.pinerc -- This is the local user copy of the configuration file. It is
located in the root of the users home directory it only affects that user.
You should use this configuration if you do not have superusers/root access
on the computer on which you are using Pine. To generate a new configuration
file of this type, you issue the command 'pine -pinerc .pinerc.new'.
</P
></LI
><LI
><P
> /etc/pine.conf -- This is the site-wide Pine configuration file, so it
affects all the users running Pine on that machine (It can only be installed
by the superuser/root account). The syntax is slightly different than the
~/.pinerc file since it has to represent all the users on the system, not
just one. To generate a new configuration file of this type, you issue the
command 'pine -conf > pine.conf.new'.
</P
></LI
><LI
><P
> /etc/pine.conf.fixed -- This has exactly the same purpose and syntax as the
/etc/pine.conf file, except for one property. This file is not overridden
by the users ~/.pinerc file. Basically all the settings in this file are
enforced, and cannot be changed by the user. Initially this file should be
empty. You should add settings to it as needed.
</P
></LI
></UL
></P
><P
>Each of these files contain settings in the form of "key=value" pairings. You
can change these settings with your favorite editor (ex. vi). For the ~/.pinerc
file the user can change the settings directly from Pine, by going into (S)etup
then (C)onfig. For LDAP settings go into (S)etup then (D)irectory.</P
><P
>Here are the important settings for communicating with the Exchange Server:</P
><P
>NOTE: The syntax of each setting will be shown in the Example configuration.
<P
></P
><UL
><LI
><P
> user-domain -- The domain name portion of your email address (So if your
email address is user@yourcompany.com, then yourcompany.com would be
your user-domain).
</P
></LI
><LI
><P
> customized-hdrs -- This is the actually "From:" header that will appear in
the message that you compose before you send it out. If you don't specify
this header, the user and full name are taken from the system
/etc/passwd file. There are other variations to setting up the "From:"
header (see Resources).
</P
></LI
><LI
><P
> smtp-server -- The hostname of your SMTP server. This may or may not be the
same as your Exchange Server. (With SMTP Authentication you will need to
specify a "/user" parameter on the end of this setting).
</P
></LI
><LI
><P
> inbox-path -- This contains the default path to your INBOX. (This should
point to the remote INBOX on your Exchange/IMAP server).
</P
></LI
><LI
><P
> folder-collections -- This contains points to other folder collections you
wish to view. There are only two sets you should concern yourself with.
The first is your INBOX folders (personal folders you create in your
INBOX), and the second is your Mailbox folders, which are default folders
(ie. Sent Items, Deleted Items, Drafts, Outbox, Public Folders, etc.)
</P
></LI
><LI
><P
> default-fcc -- This folder contains a carbon copy of all messages that you
sent out. (This should point to the "Sent Items" folder on the Exchange
server)
</P
></LI
><LI
><P
> postponed-folder -- This folder contains postponed messages, that you wish
to finish later. (If you are using Outlook, this should point to the
"Drafts" folder on the Exchange server, otherwise you can create your own
on the server)
</P
></LI
><LI
><P
> ldap-server -- This is the hostname of your LDAP server. There are many
parameters available for which you should consult your Pine documentation.
(This will be used to access the Global Address List on the Exchange
Server).
</P
></LI
><LI
><P
> rsh-open-timeout -- Pine will use rsh to connect to IMAP by default.
This is an Integer value which represents the timeout period. (Since
Exchange servers don't run rsh, we are going to want to disable this
feature by setting this value to 0).
</P
></LI
></UL
> </P
><P
>One potential problem that you may run into is SMTP Authentication. Basically,
this means that you need to provide a username and password to use SMTP to send
email. I have found no official documentation which states that Pine supports
SMTP Authentication (more so on the contrary). The closest thing I've found is
the possibility of a /user Parameter to the smtp-server setting, which was
mentioned briefly in the change log from version 4.20 to 4.21. It was also
brought up a couple of times on the listserv. (see Resources)</P
><P
>If you still have problems with it, here is an alternative which I ended up
using. You can have your SysAdmin add your IP address to the Exchange
Server to allow you to bypass the SMTP authentication.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="exchange.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="example.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Exchange Server Configuration</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
> </TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Example Configuration</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
