Under certain circumstances, such as when different or remote databases are used in an
integrated environment, you must complete extra database configuration steps.
About this task
If you are installing Network Manager and ITNCM-Reports together,
and if the Network Manager database is Db2® and on a different server, then its component databases must be cataloged.
If Network Manager uses an Informix® database in a distributed environment and Dashboard Application Services Hub is not installed on the same
server as Network Manager, ensure that
the correct library JAR files are used.
Procedure
- Required:
If Network Manager and
ITNCM-Reports are installed together, and if the Network Manager database is Db2 and on a
different server:
-
To connect to a Db2 database on a server remote from your Tivoli® Common Reporting Installation, ensure that a Db2 client
is installed and the remote database cataloged. When the database server is remote to the WebSphere® Application Server node where configuration is
taking place, enter the following command at the node to add a TCP/IP node entry to the node
directory:
db2 catalog tcpip node <NODENAME> remote <REMOTE> server <PORT>
where
- NODENAME
- Specifies a local alias for the node to be cataloged.
- REMOTE
- Specifies the fully qualified domain name of the remote DB server.
- PORT
- This value is the port on which the database is accessible, typically port 50000.
db2 catalog database <database_name> at node <NODENAME>
where
- database_name
- Specifies the Db2 database name.
- NODENAME
- This value is the local alias that is specified in the previous step.
-
Add
'source $HOME/sqllib/db2profile'
to your
<install_user>/.bash_profile.
Where
$HOME
refers to the home directory of the user, which was configured
during the installation of the Db2 client to manage the client
(usually db2inst1), and
<install_user>
is the user who installed
Netcool Configuration Manager, usually
'icosuser'
.
Note: The .bash_profile
is only used for bash shell,
and it is different for sh, csh, or ksh.
-
Restart your reporting server after this update. However, before you restart the Reporting
Server, check that the amended login profile is sourced.
Tip: For installations that use a Db2 database,
Cognos® requires 32-bit Db2 client libraries, which are installed by the 64-bit Db2 client. However, there maybe further dependencies on other 32-bit packages being present
on the system; if such errors are reported, you can check with 'ldd
$library_name'.
- Required:
If Network Manager and
ITNCM-Reports are installed together, and if the Network Manager database is Oracle:
-
To connect to an Oracle database from your Tivoli Common Reporting Installation, ensure that ITNCM-Reports are installed, and then update the itncmEnv.sh file default
location:
/opt/IBM/tivoli/netcool/ncm/reports/itncmEnv.sh
Export the following
variables (where
<install directory>
is the
Netcool Configuration Manager installation directory):
- ORACLE_HOME
-
ORACLE_HOME=<install directory>/reports/oracle
export ORACLE_HOME
- TNS_ADMIN
-
TNS_ADMIN=<install directory>/reports/oracle/network/admin
export TNS_ADMIN
- LD_LIBRARY_PATH
-
LD_LIBRARY_PATH=<install directory>/reports/oracle:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
-
Create a tnsnames.ora file located in <install
directory>/reports/oracle/network/admin/
-
Add the NCIM database to the tnsnames.ora file.
For example: NCIM = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(Host =
<Database Server>)(Port = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = NCIM) ))
-
Add
source <install directory>/reports/itncmEnv.sh
to your
<install_user>/.bash_profile.
Note: The .bash_profile
is only used for bash shell, and it is different for sh,
csh, or ksh.
-
Restart your reporting server after this update. However, before you restart the Reporting
Server, check that the amended login profile is sourced.