Home | History | Annotate | Download | only in ohacgeo-g11n
      1 README.ohacgeo.g11n v1.0 03 Dec 2007
      2 
      3 Open High Availability Cluster Geographic Edition (Open HA Cluster) 
      4 G11N Workspace buildable source
      5 
      6 The Open High Availability Cluster Geographic Edition Globalization buildable 
      7 source, consists of messages as well as codes pertaining to localization. 
      8 
      9 
     10 - The contents of the tarball ohacgeo-g11n-20071203.tar.bz2 includes:
     11 
     12         * Translations of Open HA Cluster GEO message files.
     13           including:
     14 
     15                 Translation messages for Open HA Cluster GEO
     16                 components.
     17 
     18                 Package buildable tree for above messages
     19 
     20         There are no translated man pages and online help files. 
     21 
     22 - More notes on the files in tarball
     23         * Translation file formats are .po, .properties.
     24         * Languages and encodings are as follows :
     25 
     26                 Language            Short_name    Encoding
     27                 --------------------------------------------
     28                 Japanese            ja          : eucJP
     29                 Korean              ko          : ko_KR.euc
     30                 Simplified Chinese  zh          : zh_CN.euc
     31 
     32         * Some files are not full translation of corresponding
     33           source (English) files but translation of subset.
     34 
     35 - You will need to have the following installed component in order
     36   to build the files on Solaris. To install all these tools and 
     37   components please select 'Developer System Support' and corresponding 
     38   three language areas in Solaris installation.
     39 
     40         * /usr/ccs/bin/make
     41         * /usr/bin/msgfmt
     42         * /usr/sbin/install
     43         * /bin/pkgmk
     44         * /usr/java/bin/native2ascii
     45         * OS locales
     46                 needed by msgfmt which needs to run 
     47                 in the locale which given (code-converted) .po file is for.
     48                 (Essentially, only codeset is significant so it's
     49                 possible to generate .mo in different locale but
     50                 with same codeset.)
     51                
     52                 All three locales, Japanese, Korean and Simplified 
     53                 Chinese are needed to succeed the build. When you 
     54                 added your own language or locale cluster message, 
     55                 that locale will be also needed on the system.
     56                 
     57         * iconv modules between each source encoding and target binary 
     58           encodings(e.g. UTF-8, GB18030, Big5...)
     59         * other misc tools like grep, sed, etc.
     60 
     61         This list can grow when more contents become available
     62         in the future.
     63 
     64         C/C++ compilers are not used.
     65 
     66 - How to extract the tarball
     67 
     68         $ cd <your_directory>
     69         $ bzcat ohacgeo-g11n-YYYYMMDD.tar.bz2 | tar xvf -
     70         (directory "ohacgeo-g11n" will be created)
     71 
     72 - How to build entire source tree
     73 
     74         * In the expanded directory 'ohacgeo-g11n', there is build script
     75           named as 'build_ohacgeo-g11n.sh'. You can use this script to 
     76           build sources and packages. 
     77 
     78           $ cd ohacgeo-g11n
     79           $ chmod 755 build_ohacgeo-g11n.sh
     80           $ ./build_ohacgeo-g11n.sh'
     81 
     82           Script makes directory of 'proto' for put compiled files 
     83           and 'packages' for built packages. Logs are gathered into
     84           'log' file.
     85 
     86 
     87         * If you would like to use make files directory for partial build
     88           etc., please follow the below instruction.
     89 
     90              Set three environment variables called 'SRC', 'ROOT', 'PKGROOT'
     91              to the full path of the g11n directory, i.e., if you extracted
     92              it into a /build directory then SRC should be /build/ohacgeo-g11n.
     93              Compiled files will be located under $ROOT directory and build 
     94              packages will be under $PKGROOT directory.
     95 
     96              For example in ksh:
     97 
     98                    $ export SRC=/build/ohacgeo-g11n
     99                    $ export ROOT=/proto
    100                    $ export PKGROOT=/pkg
    101 
    102              Each directory need to have proper permission to build.
    103 
    104            * Go to <your_directory>/ohacgeo-g11n/usr
    105 
    106                    $ make -e install 2>&1 | tee make.log
    107 
    108            The packages are built under $PKGROOT directory.
    109 
    110 - How to install built packages
    111 
    112         * Use pkgadd command with root or alternate user account to install
    113           packages on your system.
    114 
    115                 # pkgadd -d $PKGROOT <package names>
    116 
    117 - Package names:
    118         * The following packages are created.
    119 
    120                 Japanese pkg :
    121                    SUNWjscgctl SUNWjscgrepavsu SUNWjscgrepsrdfu
    122                    SUNWjscgreptcu SUNWjscgspm
    123                 Korean pkg :
    124                    SUNWkscgctl SUNWkscgrepavsu SUNWkscgrepsrdfu
    125                    SUNWkscgreptcu SUNWkscgspm
    126                 Simplified Chinese pkg :
    127                    SUNWcscgctl SUNWcscgrepavsu SUNWcscgrepsrdfu
    128                    SUNWcscgreptcu SUNWcscgspm
    129 
    130 - Bug/RFE subcategories 
    131 
    132         * To report a bug or an RFE, please use the following web interface:
    133 
    134                 https://www.opensolaris.org/bug/report.jspa
    135 
    136         * Translation bugs of Open HA Cluster are filed in 'l10n' subcategory
    137           in corresponding Open HA Cluster GEO bug category. The category of
    138           Open HA Cluster GEO bug is 'suncluster-geo'.
    139 
    140