Installing The International
Components for Unicode
Ted Schmidt
SunGard Higher Education
November 13,
13 2009
What is Unicode?
Subhead
November 13,
13 2009
What is Unicode?
Unicode defines the character set necessary
for efficiently processing text in any
language and for maintaining text data
integrity.
November 13, 2009 | www.sungardhe.com
3
What is Unicode?
In addition to global character coverage, the
Unicode standard is unique among
character set standards because it also
defines data and algorithms for efficient
and consistent text processing. This
simplifies high-level
high level processing and
ensures that all conformant software
produces the same results.
November 13, 2009 | www.sungardhe.com
4
What is Unicode?
The widespread adoption of Unicode over
the last decade made text data truly
portable and formed a cornerstone of the
Internet.
November 13, 2009 | www.sungardhe.com
5
Unicode Examples
In ASCII:
Celine Dion
However, this diva’s name is actually:
Céline Dion
November 13, 2009 | www.sungardhe.com
6
Unicode Examples
In ASCII:
Johann Strauss
However, the waltz king’s name is actually:
Johann Strauß
November 13, 2009 | www.sungardhe.com
7
Unicode Examples
In ASCII:
Mikhail Gorbachev
However, the Russian's leaders name is
actually:
Михаил Горбачёв
And he is from Россия.
November 13, 2009 | www.sungardhe.com
8
Why Unicode?
Storing Unicode characters in our BANNER
database will allow us to communicate
effectively with our constituents.
constituents
November 13, 2009 | www.sungardhe.com
9
Why IBM’s International Components for Unicode?
The ICU library provides a complete
implementation of the Unicode character
set and the prescribed algorithms
associated with manipulating Unicode
data. This allows us to efficiently
implement the processing of Unicode
characters within BANNER batch
processing jobs.
November 13, 2009 | www.sungardhe.com
10
Downloading the Prerequisites
and the ICU Library Source Code
Subhead
November 13,
13 2009
Prerequisites
•
•
C++ Compiler Installed and Licensed
GNU Make
November 13, 2009 | www.sungardhe.com
12
ICU Library Software
•
http://icu-project.org/download/3.6.html
November 13, 2009 | www.sungardhe.com
13
Updated msgfmt.h
The baseline ICU source code requires a modified
version of the msgfmt.h file to link properly
with BANNER 8 executables.
• It can be located on the ActionWeb under
Software Downloads for General\ICU
Header\International Components for Unicode
Header Files.
November 13, 2009 | www.sungardhe.com
14
Compiling the ICU Library for
BANNER 8
Subhead
November 13,
13 2009
Compiling the ICU Library
For this example will assume we are running
BANNER job submission processes on a Linux
RedHat 4.x system.
November 13, 2009 | www.sungardhe.com
16
Unpack The ICU Library Source Code
$ mkdir /usr/local/include
$ cd /usr/local/include
$g
gunzip
n ip -d
d < icu4c-3_6-src.tgz
ic 4c 3 6 src tg | tar xvff -
November 13, 2009 | www.sungardhe.com
17
Replace The msgfmt.h Header File
$ mv /usr/local/include/icu/source/i18n/unicode/msgfmt.h
/usr/local/include/icu/source/i18n/unicode/msgfmt_orig.h
$ cp msgfmt.h /usr/local/include/icu/source/i18n/unicode
November 13, 2009 | www.sungardhe.com
18
Update The LD_LIBRARY_PATH
$ export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
November 13, 2009 | www.sungardhe.com
19
Configure the ICU Library
To configure ICU library, execute the following
commands:
Red Hat 32-bit
$ ./runConfigureICU Linux --disable-64bit-libs
Red Hat 64-bit
$ ./runConfigureICU Linux --enable-64bit-libs
Check the config.log for errors.
Typically if the last line has this information,
Typically,
information the
runConfigureICU was successful.
configure: exit 0
November 13, 2009 | www.sungardhe.com
20
Compile the ICU Library
To compile the ICU library, execute the following
commands:
$ gmake clean
$ gmake >& make.log
$ gmake install >& install.log
November 13, 2009 | www.sungardhe.com
21
Update The Environment Variables
You must update your environment to let the
programs know you will be using UTF8/Unicode character sets.
$ export LC_ALL=en_US.utf8
$ export
p
NLS_LANG=AMERICAN_AMERICA.AL32UTF8
November 13, 2009 | www.sungardhe.com
22
Download the BANNER Makefile_tm Makefile
The are attached to FAQ CMS-1361 Banner
Example Makefiles.
Download the correct makefile for your
environment and place it the
$BANNER HOME/general/c directory and link it
$BANNER_HOME/general/c
to $BANNER_LINKS
November 13, 2009 | www.sungardhe.com
23
Download the BANNER Makefile_tm Makefile
The are attached to FAQ CMS-1361 Banner
Example Makefiles.
Download the correct makefile for your
environment and place it the
$BANNER HOME/general/c directory and link it
$BANNER_HOME/general/c
to $BANNER_LINKS
November 13, 2009 | www.sungardhe.com
24
Compile All of the B ANNER “C” Code
$ cd $BANNER_LINKS
$ sh gencmpl.shl
$ sh <prd>cmpl
<prd>cmpl.shl
shl For each BANNER prod
product
ct
installed.
November 13, 2009 | www.sungardhe.com
25
Frequently Asked Questions
Subhead
November 13,
13 2009
What portions of BANNER Batch processing are affected by use
of the ICU Library?
y
All “C” programs are linked with the ICU library to
enable Unicode support. COBOL natively
supports the Unicode character set, so special
handling is not required.
November 13, 2009 | www.sungardhe.com
27
FAQ 1-50JKLS
How can I locate the Banner 8 ICU file msgfmt.h?
g
•
It can be located on the ActionWeb under
Software Downloads for General\ICU
Header\International Components for Unicode
Header Files.
November 13, 2009 | www.sungardhe.com
28
FAQ 1-6OXPEV
Compiling Banner 8 ICU C program and getting errors on
Makefile_tm
_ "msgfmttm.cpp"
g
pp Could not open
p include file
"unicode/msgfmt.h"
Confirm the Banner version of the file
/usr/local/include/icu/source/i18n/unicode/msgfmt.h
Is in place and has the correct permissions
To locate the Banner version of the file please see
- FAQ 1-50JKLS - How can I locate the Banner 8 ICU file
msgfmt h?
msgfmt.h?
To check the permissions on the file
ls -l /usr/local/include/icu/source/i18n/unicode/msgfmt.h
The error above was replicated when the permissions were
-rw------- 1 root root
32556 Nov 19 2008
/usr/local/include/icu/source/i18n/unicode/msgfmt.h
To fix that error as root run
chmod 644
/usr/local/include/icu/source/i18n/unicode/msgfmt.h
p the Banner programs
p g
without the error.
Now recompile
November 13, 2009 | www.sungardhe.com
29
Operating System Specific FAQs
Redhat 3.x/4.x
Redhat 5.x
Solaris Sparc
Solaris x86
AIX
HPUX IA
HPUX RISC
Windows
November 13, 2009 | www.sungardhe.com
1-3GODR4
1-5EOZZS
1 4OVRPG
1-4OVRPG
1-4XSR5D
1-4WW4G8
1-3T9RYB
1-3QO4GI
1-3GBB8J
1
3GBB8J
30
Questions?
November 13, 2009 | www.sungardhe.com
31