________________________________________
          PyBB Installation Instructions

                            Feb 13, 2004
                           Version 0.9.0   
________________________________________          
 
   
   Installation Requirements
      Python
      MySQL
      MySQL-python
      Medusa
      PIL
   PyBB ġ
   PyBB ׷̵ 



=============================
    Installation Requirements
=============================

PyBB ϱ ؼ  α׷ ġǾ ־ մϴ.

 * Python 2.2.2 ̻
 * MySQL 3.23 ̻
 * MySQL-python 0.9.2 ̻
 * medusa 0.5.3 ̻ (ġ  ʿ )
 * PIL 1.1.3 ̻ (  )

~~~~~~~~~~~~~
   1. Python
    2.2.2 ̻
~~~~~~~~~~~~~

̽  python Ȯ  ֽϴ.
  ____________________________________________

  $ python
  Python 2.3 (#46, Jul 29 2003, 18:54:32) [MSC v.1200 32 bit (Intel)] on win32
  Type "copyright", "credits" or "license()" for more information.
  >>> 
  ____________________________________________

ʿϴٸ  ּҿ ֽ  ̽   ֽϴ.

 * http://python.org


ġ   ϴ.
  ____________________________________________

  $ tar zxvf Python-2.3.1.tar.gz
  $ cd Python-2.3.1
  $ ./configure --prefix=/home/userid/local     #--prefix=ġ
  $ make && make install
  $ cd /home/userid/local/bin      #̽ ġ 丮 bin ̵
  $ ./python                       #̽  -  Ctrl+D

  # ̽  ( )
  # .bash_profile   ߰
  PATH=$HOME/python23/bin:$PATH
  ____________________________________________


~~~~~~~~~~~
   2. MySQL
  3.23 ̻
~~~~~~~~~~~

 ġϷ  ּҵ ߿ MySQL ٿ޾ ġմϴ.
 * http://www.mysql.com/downloads/mysql-4.0.html
 * http://mysql.byungsoo.net/downloads/mysql-4.0.html
 * http://mysql.holywar.net/downloads/mysql-4.0.html
 * http://mysql.new21.com/downloads/mysql-4.0.html

ѱ    ҽ Ͻÿ '--with-charset=euc-kr' ɼ ԵǾ ϸ,
Ű ġǾ ִ 쿡 ѱ   ϱ ؼ

  # /usr/bin/safe_mysqld --default-character-set euc_kr & 

   ø ˴ϴ.

~~~~~~~~~~~~~~~~~
  3. MySQL-python
       0.9.2 ̻
~~~~~~~~~~~~~~~~~

MySQL ̽㿡 ϱ Դϴ.

 ּҿ mysql-python ٿ޾ ġմϴ.
 * http://sourceforge.net/projects/mysql-python

ġ   ϴ.

# MySQL 3.2.x   ġǾ ִ°ɷ 
  ______________________________________________________
  $ tar xfz MySQL-python-0.9.2.tar.gz
  $ cd MySQL-python-0.9.2
  $ vi setup.py # ÷  MySQL ġǾ ִ θ 캻.
                # thread_safe_library ɼ Ȯ (쿡 ٸ. Yes ȵ 쿡 No Ѵ)
  $ python setup.py build
  $ python setup.py install --prefix=/home/userid/local     #--prefix=ġ
  ______________________________________________________

~~~~~~~~~~~~
   4. Medusa
  0.5.3 ̻
~~~~~~~~~~~~
ġ ÿ ޵λ縦 ġ ʿ䰡 ϴ.

̽   Դϴ. 

 ּҿ medusa ٿ޽ϴ. 
 * http://oedipus.sourceforge.net/medusa

ġ   ϴ.
  ____________________________________________
  $ tar xfz medusa-0.5.4.tar.gz
  $ cd medusa-0.5.4
  $ python setup.py install --prefix=/home/userid/local    #--prefix=ġ
  ____________________________________________


~~~~~~~~~~~~
      5. PIL 
  1.1.3 ̻
~~~~~~~~~~~~
PIL Ű  Ǯ 丮 ̵ 

 ο   ּҿ   ֽϴ.
  * http://www.pythonware.com/products/pil/
  _________________________________________________
  $ tar zxf Imaging-1.1.4.tar.gz 
  $ cd Imaging-1.1.4/libImaging 
  $ ./configure --prefix=/home/userid/local     #--prefix=ġ 
  $ make 
  $ cd .. 
  $ python setup.py build 
  $ python setup.py install --prefix=/home/userid/local    #--prefix=ġ 
  __________________________________________________



===========================
          PyBB Installation
                      0.9.0
===========================
 %    α׷  ġ Ŀ մϴ.

 ο   ּҿ   ֽϴ.
  * http://kldp.net/projects/pybb
  * http://pybb.kldp.net

 1.  Ǯ PyBB 丮 ̵մϴ.
  ____________________________________________
  $ tar xfz PyBB-0.9.0.tar.gz
  $ cd PyBB-0.9.0
  $ 
  ____________________________________________


 2. PyBB python site-package 
 
   PyBB python site-package ؼ   ְ ״   ֽϴ.
     ų site-package    ׳ 3 ʱȭ Ѿ.


  Դϴ.

ġ 丮 ̵  "python setup.py install" մϴ.
  ____________________________________________
  $ python setup.py install --prefix=/home/userid/local
  running install
  :
  :

  # bbs, build 丮 մϴ.
  $ rm -rf bbs    
  $ rm -rf build
  $ 


 3. ʱȭ 

init.py  Ͽ ʱȭ մϴ.    Դϴ.
  ____________________________________________

  $ python init.py

  =========== DB SETUP ============
  =================================
  Input your DB Server host address   
  dbhost (localhost) : # db host Էմϴ. 
  Input your DB Server user name
  dbuser (dbuserName) : # db  Էմϴ. 
  Input your DB Server password
  dbpassword (dbpassword) : #  йȣ Էմϴ.
  Input DB Name
  dbname (dbname) : # ϰų  db ̸ Էմϴ. 
  Input DB Table prefix(Max 15 length)
  (tablePrefix = login id + input)
  tablePrefix (01) : # tablePrefix Էմϴ. 
                     #  01̶ Էߴٸ table 'loginId_01_user' ̷ ϴ.

  =========== HTTP SETUP ==========
  =================================
  Input Web server ip or address.
  HOST_URL (myhome.co.kr) : # PyBB ġ host url Էմϴ.
  Input Web server port No.
  HTTP_PORT (9080) :        # PyBB  Ʈ ȣ Էմϴ.
                            # ġ 80 Էմϴ.
                            # ġ ģ  Է host url port ϰ ˴ϴ. Ȯϰ Էϼ.
                            #  ּ ex) http://myhome.co.kr:9080/pybbs.py

  ======== BBS ADMIN SETUP ======== 
  =================================
  Create bbs administrator ID
  userId (admin) : # bbs  ̵ Էմϴ.
  Create bbs administrator name
  name (Administrator) : #  ̸ Էմϴ.
  Input bbs administrator E-Mail
  email (admin@youremail.co.kr) : #  ̸ Էմϴ.
  Create bbs administrator password
  password (admin) : #  йȣ Էմϴ.
  
  #   ģ   Ȯȭ Դϴ.
  ======== Registered Info ========
  =================================
  [ DB setup ]
  dbhost : localhost
  dbuser : dbuserName
  dbpassword : dbpassword
  dbname : dbname
  tablePrefix : loginId_01

  [ site information ]
  HOST_URL : myhome.co.kr
  HTTP_PORT : 9080

  [ User Information ]
  uid : admin
  passwd : admin
  name : Administrator
  email : admin@youremail.co.kr
  Accept(Y/n)?  #  Ȯ
  admin registrered

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

    Initialization is completed
  ===============================
  ____________________________________________

  # python  "from bbs import bbsmain" Է  
  $ python
  >>> from bbs import bbsmain
  >>> 
  _______________________________
    ġ Դϴ.


 4.   &  (޵λ縸 ش˴ϴ.)
  ʱȭ ģ  start Ͽ  մϴ.
  ____________________________________________
  $ ./start
  $
  ____________________________________________

   stop մϴ.
  ____________________________________________
  $ ./stop
  $
  ____________________________________________

  http request α  http.log Ͽ, pybb α  user.log Դϴ.

 5. ũƮ  α׷   (ġ ش˴ϴ.)
  pybbs.py  ٿ #!/usr/bin/env python̶  ִ  
   ´  η մϴ.

     α׷ θ   ֽϴ.
  ____________________________________________
  $ which python
  /home/bin/python   
  $
  ____________________________________________
  
 6. ũƮ  
  ____________________________________________
  $ chmod 755 pybbs.py
  $
  ____________________________________________

 7. ũƮ Ȯ  (ġ ش)
  py Ȯڸ ũƮ ν Ѵٸ
  ڱ  .htaccess Ͽ   ߰Ѵ. 
  (root  ̶ httpd.conf ߰Ѵ)
  _____________________________________________
  AddHandler cgi-script .py
  ____________________________________________
  
  
===========================
               PyBB Upgrade 
                      0.9.0
===========================

    
    PyBB  ġ PyBB     
  
   PyBB site-package  쿡 "python setup.py install" մϴ. site-package  ʾҴٸ   ʿ ϴ. 
  ____________________________________________
  $ python setup.py install --prefix=/home/userid/local
  running install
  :
  :
  # bbs, build 丮 մϴ.
  $ rm -rf bbs    
  $ rm -rf build
  $ 
  
    upgrade.py մϴ. ()
  ____________________________________________
  $ python upgrade.py 


