Index: [Article Count Order] [Thread]

Date:  Sat, 07 Feb 2004 16:51:46 +0800
From:  Jake Morrison <jake (at mark) jakemorrison.com>
Subject:  [coba-o:00361] English translation of HowToCreateOpenQube.pdf
To:  coba-e (at mark) open.cobaltqube.org, coba-o (at mark) open.cobaltqube.org
Message-Id:  <4024A722.1080908 (at mark) jakemorrison.com>
X-Mail-Count: 00361

Following is a rough translation of Shibuya-san's
presentation into English. I am still a beginner
at Cobalt, and my Japanese is not very good, so
some things are not very clear. But it is a start...
I have marked some questionable parts with ???

Perhaps this can go up on the http://open.cobaltqube.org/
website.

Jake MORRISON

-----------------------------

How to Make an Open Qube
Sept 11, 2003
Hisao SHIBUYA
<shibuya (at mark) alpha.or.jp>

-----------------------------

What is Open Qube?
* The open-sourced GUI component (Sausalito) of the
   Sun Cobalt Qube3 Plus
* The above GUI components installed on a PC running
   Red Hat Linux
* An open source version of the Qube

-> Open Qube

-----------------------------

Where is Sausalito?

-----------------------------

Red Hat Linux 9 Install
* Use "Server" install
   If you will be developing, also install development tools
* Required packages
   * expat (required by activity monitor ???)

-----------------------------

Things to watch out for during installation

* Put /home, /var on different partitions
   * Required by disk usage status monitor

* /home should have quotas enabled
   * In /etc/fstab
     /dev/mdi	/home	ext3	defaults,usrquota,grpquota	1 2
   * quotacheck -a

-----------------------------

Other required packages

* re2c (a tool for writing regular expression lexers in C)
* perl modules (from CPAN)
   * Jcode
   * Quota
* Cobalt patched glib (not glibc)
   * GHashIter buckets increased
     (used by RaQ550 cced)
     * Get it from:
       ftp://ftp.cobalt.sun.com/pub/products/qube3/OS-6.4/SRPMS/
* Other
   * swatch (activity monitor)

-----------------------------

Quick Start

* ftp://open.cobaltqube.org/pub/OpenQube/redhat/RPMS/
* rpm -ivh *
* Reboot if there is a problem
* /etc/init.d/cced.init start
* /etc/init.d/httpd restart
* touch /etc/build
* Open http://FQDN:444/ in web browser

-----------------------------

Getting the Source
(Anonymous CVS)

* Getting the source from anonymous CVS
   $ cvs -d:pserver:anonymous (at mark) open.cobaltqube.org:/cvsroot login
   Password is empty (null password)
* $ cvs -d:pserver:anonymous (at mark) open.cobaltqube.org:/cvsroot
      co -r DEV_OpenQube module_name

-----------------------------

Getting the Source
(CVS Account)

* Environment setup
   export RSH=ssh
   CVSROOT=:ext:username (at mark) open.cobaltqube.org:/cvsroot
* cvs co -r DEV_OpenQube module_name

-----------------------------

Starting the Build

* Start with ui/devel-tools

* Basic build method
   # cd ui/devel-tools
   # make rpm

* Copy rpms to RPMS directory
   rpms = *.i386.rpm
   as_rpms = *.noarch.rpm

-----------------------------

After Login

* Install a few more modules
* Build order:
   ui/devel-tools
   ui/i18n
   cce
   ui/base-winshare
   ui/sauce-basic
   ui/palette
   ui/gallery
   ui/carmel.mod
   ui/base-user.mod

-----------------------------

Dependencies...

* If rpm complains about dependencies...
   Install with rpm --nodeps

* devel-tools, i18n, cce dependency loop

-----------------------------

Changes

* PHP 4.1.x and above
   * The API for PHP 4.1 is different
   * PHP for the Qube3 is 4.0.6
* Message catalog encoding change
   * SJIS in CVS ???
-> Change to EUC-JP

-----------------------------

Changes

* Additions to PHP configuration file
   * Under Red Hat Linux 9, any configuration settings
     placed in /etc/php.d will be automatically included
   * Much nicer to handle :-)

* Contents of changes
   * cce.ini, i18n.ini additions
     * cce.so, i18n.so extension settings
     * include_path settings
     * Deal with security problem from
       register_globals On

-----------------------------

Changes

* Apache configuration file additions
   * Under Red Hat Linux 9, any configuration settings
     placed in /etc/httpd/conf.d will be automatically
     included
   * Much nicer to handle :-)

* Contents of changes
   * sausalito.conf added
     * VirtualHost setting uses port 444
     * log file setting
     * Alias setting
       * Use SSL on Port 81

-----------------------------

Try to Log In

* Access http://FQDN:444/
* admin password?
   * Now changed to 'admin'
* Can't become root?
   * root password is now also 'admin'

-----------------------------

After Installation

* Newly installed modules will not appear
   in menu until you restart:

   /etc/init.d/cced.init restart

-----------------------------

Things to pay attention to

* Running 'make rpm' as root
   It's ok, but...
* Don't use 'rpm -ta'
   * Change to 'rpmbuild -ta'
   * http://www.rpm.org/hintskinks/rpmbuild
* Configuration file path changes ???

-----------------------------

Things to pay attention to (packages)

* ftp now uses vsftpd
* Obsolete usages
* Home directories under /home/users
* gettext version differences
   * msgfmt, msgunfmt have no -e option
     zh_CN, zh_TW will not build
   * Due to format change, msgunfmt
     doesn't work properly

-----------------------------

Future Topics

* autoconf, automake configuration
* Make an ISO image
* Your help would be appreciated
* More time would be appreciated
* FHS support

-----------------------------

Joining the Development Team

* Mailing lists
   * coba-o (at mark) open.cobaltqube.org
     156 subscribers (Sept 11, 2003)
   * cvs-commits (at mark) open.cobaltqube.org
     7 subscribers (Sept 11, 2003)

* Anonymous CVS
* CVS on the Web
   * http://open.cobaltqube.org/cgi-bin/cvsweb.cgi