old-www/HOWTO/DB2-HOWTO/help.html

453 lines
9.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML
><HEAD
><TITLE
>Installing the DB2 Information Center</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="IBM DB2 Express-C for Linux HOWTO"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Installing DB2 Express-C on SimplyMEPIS 6.0"
HREF="mepis6.html"><LINK
REL="NEXT"
TITLE="Removing DB2 Express-C"
HREF="uninstalling.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>IBM DB2 Express-C for Linux HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="mepis6.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="uninstalling.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="help"
></A
>18. Installing the DB2 Information Center</H1
><P
>The DB2 Information Center delivers the DB2 product documentation inside
an Eclipse-based help system, and provides a convenient way to search and utilize
the DB2 documentation.</P
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="infocenter"
></A
>18.1. Installing the Information Center locally</H2
><P
>To begin, mount the DB2 Information Center CD in your system drive, or
if you downloaded the compressed file through the Express-C website, expand
the tarball containing the installation utilities.</P
><P
>Change to the base directory (<TT
CLASS="filename"
>doce/disk1/</TT
>) and
run the <B
CLASS="command"
>db2setup</B
> utility. This will launch the DB2 setup
wizard. You can also use the other setup methods, but since the GUI
installation sets up and configures everything for you, it's the
method I recommend.</P
><P
>Installation Steps:
<P
></P
><OL
TYPE="1"
><LI
><P
>Select the "Install a Product" option from the launcher, and
then click the "Install New" button in the main panel.</P
></LI
><LI
><P
>Read the description and click "Next".</P
></LI
><LI
><P
>Read the license agreement, and if you agree, select
"Accept" and click "Next".</P
></LI
><LI
><P
>By default, the installation script will install the Information
Center locally and generate a response file. The choice is up to you,
but we're only doing a local install, so choose the "Install DB2
Information Center on this computer" option instead. Click
"Next".</P
></LI
><LI
><P
>Add any additional languages that you want to have
installed. English is installed by default and cannot be
deselected. Each additional language will add anywhere from
5 MB to 50 MB to the installation size. Click "Next".</P
></LI
><LI
><P
>The next panel is where things get a little interesting. Here
you can specify the service name that the Information Center will
run under. An entry will be added to the
<TT
CLASS="filename"
>/etc/services</TT
> file for this service. You
probably don't need to change this, unless you have another service
running as "db2icv91". </P
><P
>Also, this panel is where you specify the system port that the
Information Center will use to serve up the documentation. By
default, this is port 51000.</P
><P
>These settings will change the configuration for
all DB2 products installed on the local system, so that their help
system will use the parameters you define here. Click "Next".</P
></LI
><LI
><P
>Read the summary of what will be done, then click "Finish" to
start the file installation</P
></LI
></OL
>
</P
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="AEN891"
></A
>18.1.1. Post-installation notes</H3
><P
>You can change which directory the Information Center uses as a
temporary working directory. To do this, modify the DB2_ECLIPSEIC_DATA
parameter in the db2ic.conf file
found in the <TT
CLASS="filename"
>/opt/ibm/db2ic/V9/cfg</TT
>
directory. The temporary directory can be
anywhere where the "bin" user can write to.</P
><P
>Also in this file, you can change the port used to serve up the
Information Center, in case you change your mind later on about the one
you set up during the install. Just change the DB2_ECLIPSEIC_PORT
parameter to the new number (though it must be a port under the maximum of
65535).</P
><P
>After making any changes, do a <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>/etc/init.d/db2icdv9 restart</PRE
></FONT
></TD
></TR
></TABLE
>
to have your changes picked up by the Information Center (see below for
more details on the db2icd daemon).</P
></DIV
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN898"
></A
>18.2. The Information Center daemon</H2
><P
>The Information Center daemon is set up during installation and is
used to launch the background process that runs the Information Center. The
daemon script, named <B
CLASS="command"
>db2icdv9</B
> is installed to the <TT
CLASS="filename"
>/etc/init.d/</TT
> directory, and start up symbolic
links are added to the <TT
CLASS="filename"
>/etc/init.d/rc.X/</TT
> run-level folders. By
default, the daemon is turned on for run-levels 3 and 5. You can modify
these run-levels with any system init utility (<B
CLASS="command"
>chkconfig</B
>,
<B
CLASS="command"
>ntsysv</B
>, or any of the X-based variants).</P
><P
>There are 5 commands you can pass to the daemon:
<P
></P
><OL
TYPE="1"
><LI
><P
>start &#8212; Starts the Information Center, using the
configuration parameters set in the /opt/ibm/db2ic/V9/cfg/db2ic.conf
file.</P
></LI
><LI
><P
>stop &#8212; Halts a running Information Center.</P
></LI
><LI
><P
>restart &#8212; A combination command that stops, then
starts the daemon again.</P
></LI
><LI
><P
>reload &#8212; Same as restart.</P
></LI
><LI
><P
>status &#8212; Provides information on whether the Information
Center is running, and if it is running, what the process IDs (PID)
are.</P
></LI
></OL
>
</P
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN918"
></A
>18.3. Accessing an installed Information Center</H2
><P
>There are three possible methods to access the DB2
Information Center:
<P
></P
><UL
><LI
><P
>Via the publib.boulder.ibm.com Web site (this is
the default option enabled during a DB2 installation)</P
></LI
><LI
><P
>Via an intranet machine that is hosting the DB2
Information Center within your own organization</P
></LI
><LI
><P
>Via an Information Center that is installed and set up on your
local machine</P
></LI
></UL
>
You can configure which access method will be used, either during the DB2
installation (only by specifying a "Custom" installation), or afterwards
in the tools configuration panel (in the GUI tools), or from the command
line.</P
><P
>To make the change using the GUI tools (Control Center), open the
<B
CLASS="command"
>Tools</B
> menu, select <B
CLASS="command"
>Tools Settings</B
>,
and then the <B
CLASS="command"
>Documentation</B
> tab. On this panel, you can specify a host URL
and port where an Information Center can be found. When putting a hostname
in, do not add the "http://" prefix, or any
subdirectories &#8211; just type in the hostname, and the internal code
will do the rest.</P
><P
>To change the access points from the command line, execute these
commands:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>db2set DB2_DOCHOST=<TT
CLASS="varname"
>host_URL</TT
>
db2set DB2_DOCPORT=<TT
CLASS="varname"
>host_port</TT
></PRE
></FONT
></TD
></TR
></TABLE
>
where <TT
CLASS="varname"
>host_URL</TT
> is the location hostname of the Information Center. This
could be: mydocserver.myorg.net or localhost (for a local installation),
and <TT
CLASS="varname"
>host_port</TT
> is the port number where the Information Center was
installed.</P
><P
>By default, these DB2 environment settings are blank, which means
that DB2 defaults to the
http://publib.boulder.ibm.com/infocenter/db2help/ Web site.</P
><P
>To invoke the DB2 Information Center from the GUI tools, click on
the "?" icon in the toolbar, any of the "Help" hyperlinks or buttons, or
by selecting any of the menu items in the "Help" menu.</P
><P
>To invoke the DB2 Information Center from the command line, issue
any of these commands:
<P
></P
><UL
><LI
>db2icdocs</LI
><LI
>db2help</LI
><LI
>db2ic</LI
><LI
>db2cc -ic</LI
></UL
>
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="mepis6.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="uninstalling.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Installing DB2 Express-C on SimplyMEPIS 6.0</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Removing DB2 Express-C</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>