Penn Computing
Computing Menu Computing A-Z
Computing Home Information Systems & Computing Penn

Webmail Evaluation - Spring 2000 - WorldPilot Installation Script

  • Author: Andy Diller
  • WebMail application/version: World Pilot 1.0.4
  • Software Prereqs: Python, Zope
  • WebMail Server Platform: Sun Solaris 2.6
  • WebMail Server Hostname: OXO.ISC-NET.UPENN.EDU
  • Target Email Server: SPINNER.ISC-NET.UPENN.EDU
    WebMail URL: oxo.isc-net.upenn.edu:8080/spinner
  • Target Email Server: DOLPHIN.UPENN.EDU
    WebMail URL: oxo.isc-net.upenn.edu:8080/dolphin

Installation

Also see: commands - the actual commands to do this script
=============================================================
Step 1. Gather Files:


WP:     ftp://demo.worldpilot.com/pub/worldpilot/worldpilot-release-1.0.4.tar
Zope:   http://www.zope.org/Products/Zope/2.1.6/Zope-2.1.6-src.tgz
Python: http://www.python.org/ftp/python/src/py152.tgz


==============================================================
Step 2. Install


Python:
- untar
- ./configure; make; make install
  - (/usr/local is default install dir)


Zope:
- copy tarball to dir where you want Zope's Home Dir (/usr/local)
- untar Zope tarball in /usr/local
- rename the resulting Zope-1.1.6 dir to "zope" (no quotes)
- create a zope user & zope group on your system
- make /usr/local/zope the HomeDir of Zope user
  - make sure .cshrc or .login has /usr/local/bin in path
- become user zope- run install script "wo_pcgi.pyc" using python:
    > python wo_pcgi.pyc

- watch end of script output--> write down super user & password !!!

        The super user name and password are 'superuser'
        and 'wdQLedDr'.


- start Zope and test by connecting with a browser:
    - as user zope, execute the start script
      - /usr/local/zope/start
    - start a browser and go to: 
      - http://your-machine:8080
    - open new browser and test management; goto: 
      - http://your-machine:8080/manage
        - enter superuser and password given at install time


WorldPilot:
- untar worldpilot-release-1.0.4.tar into a temporary dir
- cd into the resulting worldpilot-1.0.4 dir
- copy worldpilot.1.0.4.tgz into "Zope Home Dir" (ZHD) --> /usr/local/zope
- chown it to user "zope"
- become zope user and untar it from within the ZHD
     - (as zope) > gtar zxvf worldpilot.1.0.4.tgz
- WP is now located in:
    /usr/local/zope/lib/python/Products/WorldPilot

- cd into this directory and edit these 2 files:
  - edit "DOMAIN.py" -  put in your domain name
    - in this case, for Dolphin, put in--> upenn.edu
  - edit "IMAPHACK.py"
    - verify that the line:
       MailListRoot='"Mail"'
       has Mail with a capital "M"
    - this is for UWASH imap home dir compat with elm

- create the following directories in /var
(execute this commands as root)

umask 000
mkdir /var/spool/worldpilot
mkdir /var/spool/worldpilot/storage
mkdir /var/spool/worldpilot/storage/user
mkdir /var/spool/worldpilot/sessions
mkdir /var/spool/worldpilot/user

chmod -R 700 /var/spool/worldpilot
chown -R zope:zope /var/spool/worldpilot


==========================================================
Step 3. Configuration


- start Zope (as user zope in the ZHD)
  - ./start &

- attach with browser to Root Management Screen:
  - open a browser window:
  - http://your_server:8080/manage


STARTING WorldPilot SETUP------------------

- at the root (/) select "Available Objects" pull down menu:
   - Choose "WorldPilot"
   - for ID enter:     spinner
   - for Title enter:  Spinner WebMail
   - for IMAP enter:   spinner.isc-net.upenn.edu
   - for SMTP enter:   spinner.isc-net.upenn.edu
   - click ADD button

FINISHED WorldPilot SETUP------------------


Open new Browser Window:

- go to WP login page:
  - http://your_server:8080/spinner
  - login using your spinner username & password
  = you should see your inbox

================================
================================

Continue with client side scripts

++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++

Please Read:
------------


Problem Solving:

* If you don't see "WorldPilot" in the Available Objects
  pulldown menu in your Zope Management screen look in:
  http://your_server:8080/Control_Panel/Products/WorldPilot/manage_main
  and see what error is causing WP not to load
  - its usually is some permission errors with /var/spool/worldpilot

* If you get an error after the inital login to SPINNER please login
  via telnet and run ELM, read a message, quit ELM and login in with
  WorldPilot again. It should work now.
 

Additional Information:
------------------------

ZHD - Zope Home Directory. This is the home directory of the zope
      installation, and also the home directory of the zope user.
      The zope user should be used to start ZOPE, which itself
      is a web and ftp server, as well as an application server.

Python - a high level scripting lanugage that Zope is written in

WP - WorldPilot a WebMail application written with Zope


-end-

Commands used to install WorlPilot


================================
Notes:

: %; ---> my unix prompt

gtar ---> gnutar (z option ungzips)
          if you don't have gnutar then gunzip ; tar

sudo ---> commands prepended with sudo are executed as root
          if you don't have sudo as your system, make sure
          to execute these as root


py152c1.tgz -------------------> latest version of Python
Zope-2.1.6-src.tgz ------------> latest version of Zope
worldpilot-release-1.0.4.tar --> latest version of WP

================================

: %; gtar zxvf py152c1.tgz
: %; cd Python-1.5.2c1
: %; ./configure --with-threads
: %; make
: %; make install

Verify that a user "zope" and a group "zope" exist:
(create these on your system)

: %; more /etc/passwd
...
zope:x:4003:800::/usr/local/zope:/usr/local/bin/tcsh
...

: %; more /etc/group
...
zope:*:800:
...


: %; sudo cp Zope-2.1.6-src.tgz /usr/local
: %; cd /usr/local
: %; sudo gtar zxvf Zope-2.1.6-src.tgz
: %; sudo mv Zope-2.1.6-src zope
: %; sudo chown -R zope:zope zope
: %; sudo su - zope
: %; python /wo_pcgi.py

: %; exit  (from user "zope")
: %; tar xvf worldpilot-release-1.0.4.tar
: %; cd worldpilot-1.0.4
: %; sudo cp worldpilot.1.0.4.tgz /usr/local/zope
: %; sudo chown zope:zope /usr/local/zope/worldpilot.1.0.4.tgz
: %; sudo su - zope
: %; gtar zxvf worldpilot.1.0.4.tgz
: %; cd lib/python/Products/WorldPilot
: %; vi DOMAIN.py
: %; vi IMAPHACK.py


Finally, start Zope:

: %; sudo su - zope
: %; ./start &



===============================
Extra Info:



-typical Zope startup---------------------------

------
2000-04-03T19:08:05 PROBLEM(100) ZServer Computing default hostname
------
2000-04-03T19:08:05 INFO(0) ZServer Medusa (V1.13.4.1) started at
    Mon Apr  3 15:08:05 2000
        Hostname: oxo.isc-net.upenn.edu
        Port:8080

------
2000-04-03T19:08:05 INFO(0) ZServer FTP server started at
    Mon Apr  3 15:08:05 2000
        Authorizer:None
        Hostname: oxo.isc-net.upenn.edu
        Port: 8021
------
2000-04-03T19:08:05 INFO(0) ZServer Monitor Server (V1.5) started on port 8099


--end--------------------------
top

Information Systems and Computing
University of Pennsylvania
Comments & Questions


University of Pennsylvania Penn Computing University of Pennsylvania Information Systems & Computing (ISC)
Information Systems and Computing, University of Pennsylvania