IBM Software

IBM INFORMIX V.14.10.XC4 -

INFORMIX HQ 1.2.0

v.1a

1 © 2020 IBM Corporation

 IBM Software

Agenda
• New start and stop script for IHQ

• Support for Connection Manager functionality

• The ability to create custom dashboards

• Enhancements to the schema manager

• Customized system reports

2 © 2020 IBM Corporation

 IBM Software

New start and stop script

3 © 2020 IBM Corporation

 IBM Software

New start and stop script

• Prior to this release, starting the IHQ server or agents required executing a raw Java
command
• There was not a graceful way to stop IHQ agent or server services except for an O/S kill command

• Starting with IHQ 1.2.0, there is a new shell script that makes starting, stopping and
managing server and agent services more easy and graceful

4 © 2020 IBM Corporation

 IBM Software

New start and stop script

• Called InformixHQ.sh (or .bat for Windows users), the script can start IHQ services
with service “names” and other parameters such as the instance locale
• These names are used to stop the service(s)
• This does NOT eliminate the need to configure the properties files for the server and agent(s)

• There is a help option that displays the command options

• Of particular note is the default locale encoding — it is utf-8 which might or might not work for your
instance environments
5 © 2020 IBM Corporation
 IBM Software

New start and stop script

• For example, to start the IHQ server component using defaults — except for locale

• In the past, to find the processes, you’d have to execute a ps -ef|grep java and look
through the results to find the one for the server or agent(s)
• With the script, the process takes the “service name”, in this case i_svr_1

6 © 2020 IBM Corporation

 IBM Software

New start and stop script

• Starting the IHQ agents may require changing the naming conventions for the properties
files
• Using the command line, you can pass any valid property file name into the Java command
• For example, if there were 7 instances to monitor you could name the properties files as follows
then start them as illustrated

7 © 2020 IBM Corporation

 IBM Software

New start and stop script

• With the new IHQ start and stop scripts, the agent and server properties files must use
the .properties suffix
• Therefore, for the 7 instances
• Rename the properties files

8 © 2020 IBM Corporation

 IBM Software

New start and stop script

• With the newly renamed properties files, start an agent

• To stop either a server or agent service, use the stop option with the service name
• For example to stop the agent on inst_1

9 © 2020 IBM Corporation

 IBM Software

New start and stop script

• There is a . . . . .
functional issue . . . you
need to know about with
the stop command
• The script does no
validation of the service
names passed to it
• Regardless of what you
pass, the script returns
Terminated
• This has been raised with
development

• For example, I have no

IHQ services running but
stop them anyway
• All return Terminated
10 © 2020 IBM Corporation
 IBM Software

11 © 2020 IBM Corporation

 IBM Software

Support for Connection Manager

functionality

12 © 2020 IBM Corporation

 IBM Software

Before continuing . . . .
• A 4 instance H/A cluster with a primary,
SD secondary, HDR and one RS
secondary is used for this section of the
presentation

13 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Prior to IHQ 1.2.0, there wasn’t any support for Connection Manager agents in the tool

• With this release you can

• See a list of the active CM agents
• Administer SLAs
• Modify the FOC sequence

• There is a new sensor for CM functionality as well

14 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• With this release, a new sensor is added to monitor SLA activity
• Called SLA_Connections, it can be added to instances which support CM SLAs

• This sensor works for all SLAs, including those for ER or Grid clusters

15 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• With an H/A cluster built and two CM agents started, let’s look at the new IHQ CM
functionality
• First, the High Availability menu option, then clicking on the cluster primary, should display that there
are 2 CM agents active but at this time it only shows 1 for the active FOC arbitrator
• This has been raised with development
• FYI - clicking on another instance displays statistical information about that instance, not CM
information

16 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Clicking on the Connection Manager menu option displays general information about
each active CM agent, including which is the active FO arbitrator
• Each agent can be expanded to show the cluster unit name(s) as well as the FO configuration for the
H/A cluster

17 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Clicking on the cluster unit
name displays
• The SLAs it contains
• A option to change whether this
CM agent is the active FO
Arbitrator
• The option to modify the FO
order for the cluster
• The ability to change the Failover
Timeout value
• The option to add a new SLA to
the cluster unit

18 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Before showing how to add a new SLA, drop an SLA or modify an SLA through IHQ, there
are some functional issues you need to know
• First - SQLHOSTS
• As you know, SLAs act as “pseudo-instances” from a connectivity perspective (e.g.
dbname@sla_name)
• Applications and their connectivity drivers need to know where to “find” the SLAs in order to connect to
them
• This requires an entry in SQLHOSTS

• IHQ 1.2.0 does NOT modify SQLHOSTS when you add or delete an SLA
• You must make the required changes manually
• IHQ 1.2.0 does NOT validate that an SQLHOSTS entry exists when adding a new SLA
• So it’s possible to add an SLA that applications can not connect to

• SQLHOSTS changes must made manually to ALL instances that will use / no longer use an SLA

19 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Before showing how to add a new SLA, drop an SLA or modify an SLA through IHQ, there
are some functional issues you need to know

• Second - port and name validation

• Assuming you’ve created the SLA entry in the SQLHOSTS file, as you’ll see in a moment, when
adding an SLA, you have the option to enter a port number (e.g. 60090) or a port alias (e.g.
oltp_sla_port)
• Port aliases correspond to an entry in /etc/services (or the Windows equivalent)
SQLHOSTS /etc/services

20 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Before showing how to add a new SLA, drop an SLA or modify an SLA through IHQ, there
are some functional issues you need to know
• Second - port and name validation
• When adding an SLA, IHQ does NOT validate if the port number / alias entered matches SQLHOSTS
• Similarly, when adding an SLA, IHQ does NOT validate if the SLA name entered matches SQLHOSTS
• This could result in an SLA that no one can connect to because of a port number or name mis-
match

21 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• Before showing how to add a new SLA, drop an SLA or modify an SLA through IHQ, there
are some functional issues you need to know
• Third - Connection Manager configuration file
• On the positive side, when you add, drop or modify an SLA, the configuration file for the CM agent is
modified to reflect the change
• The revised file keeps it’s name while the older, pre-change configuration file is renamed to
file_name.tmp
• Only one “old” file is maintained

Note: only applies to the local configuration file, not any remote files

22 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• For example
• To modify an existing SLA, click it’s
“pencil” / edit button
• You can specify
• Whether it is a direct or proxy agent
• If the policy uses workload or round
robin to assign new connection
requests
• Worker, network and other parameters
• The instances to participate in the SLA

• Be aware however,
• While IHQ can “see” the existing SLA,
it does NOT import its settings
• You must manually add the port
number and instances to the SLA in
the edit process
23 © 2020 IBM Corporation
 IBM Software

Connection Manager functionality

• For example
• To drop an SLA, click the trash can / delete icon

• Remember to make the required SQLHOSTS change

24 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• For example
• To add a new SLA,
• Update SQLHOSTS with the
SLA entry information
• Click the Add SLA button then
enter the required information
then click Save
• You can use either a port number
or a port alias (e.g. sla_port_2)
which references to /etc/
services in the Service field

25 © 2020 IBM Corporation

 IBM Software

Connection Manager functionality

• For example
• The SLA is added and the
configuration file is updated

26 © 2020 IBM Corporation

 IBM Software

27 © 2020 IBM Corporation

 IBM Software

Custom dashboards

28 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• The ability to create a
customized IHQ
dashboard has been
available almost from the
beginning of IHQ
• These dashboards display
sensor information and is
what you see when you
click on an instance
• For example, this is the
dashboard for inst_1

29 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• What is new today is the ability to export the dashboard
• So you can import it across multiple IHQ servers for a consistent look and feel without having to
configure each IHQ server manually

• Additional new functionality is the ability to have a graph in a custom query

• Finally, you can now use bar or pie charts in your visualizations as well as tabular format

30 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• As an example, start by creating a new, custom dashboard

• Click the + Dashboard option

31 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• For each panel, you can select which instance you want for the sensor information
• For example, SLA connections on inst_4

• You can further refine the sensor information in the drop downs for the sensor

32 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• Then click Save to store that panel on the dashboard

33 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• You can have sensors from different instances displayed on the same dashboard
• In this case, I have the SLA connections from inst_4 and the logical log throughput rate from
inst_1

34 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• In addition to the available sensors, you can write a custom query and have its results
displayed in the dashboard

35 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• One of the new features is to change the visualization of the sensor data in the dashboard
• For example, with the logical log apply rate, the default is to use a line
• When you create the panel, or afterwards using the panel Edit option, you can change how the
sensor’s data is displayed

• Not all visualizations will be correct for the metric being displayed as shown below and on the next
slide

36 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• Optional visualizations in dashboards

37 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• Optional visualizations in dashboards

38 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• With the dashboard complete, save it by clicking the pencil icon and giving the dashboard
a name and saving

39 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• Clicking the Dashboards menu option displays the available dashboards
• Selecting one (or more) activates the option to export it

• The dashboard is saved in a json formatted file

• It’s saved in Downloads directory for the informix UID

40 © 2020 IBM Corporation

 IBM Software

Custom dashboards
• You can transfer the file to the other IHQ server environments and, from the Dashboards
menu option, import the file to create the dashboard on that IHQ server

41 © 2020 IBM Corporation

 IBM Software

42 © 2020 IBM Corporation

 IBM Software

Enhancements to the
schema manager

43 © 2020 IBM Corporation

 IBM Software

Schema manager
• In earlier IHQ versions, there was very little functionality in the Schema Manager portion
of the tool
• For example, in Informix v.14.10.xC3

44 © 2020 IBM Corporation

 IBM Software

Schema manager
• With IHQ 1.2.0, there are options for a wide range of database and data type operations
• Let’s look first at a database level

45 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• For stored procedures, you can see system and UDRs with their creation statement

46 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• System and UDTs

47 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• Privileges and installed datablade modules

• And so on

48 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• Clicking on a table, displays table-level options

49 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• Table level information

50 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• If the table contains extended data types, those are shown too

51 © 2020 IBM Corporation

 IBM Software

Schema manager
• For example
• If a table has “hidden columns”
like vercols for updatable
secondary operations, those are
shown

52 © 2020 IBM Corporation

 IBM Software

Schema manager
• You can add or drop indexes on a table by selecting it then clicking the Indexes toggle
• You can create unique, duplicate, clustered, forest of trees, XML or Basic text search indexes through
this option
• There is a View SQL toggle to see the SQL statement that will create the index

53 © 2020 IBM Corporation

 IBM Software

Schema manager
• You can enable or disable indexes as well

54 © 2020 IBM Corporation

 IBM Software

Schema manager
• Clicking the switch by the database selector drop down provides options to
• Create a new database
• Create a demo (stores) database
• Drop the selected database

55 © 2020 IBM Corporation

 IBM Software

Schema manager
• When creating the demo (stores) database, you have most of the command line options
• Including whether or not to include TimeSeries tables
• You do NOT have the option to download the scripts

56 © 2020 IBM Corporation

 IBM Software

Schema manager
• When creating a
regular database,
the usual location,
size and other
options are available
as well as locale

57 © 2020 IBM Corporation

 IBM Software

58 © 2020 IBM Corporation

 IBM Software

Custom system reports

59 © 2020 IBM Corporation

 IBM Software

Customized system reports

• When logged in to IHQ, an instance is selected, you click the Agent Data options and
sensors are running. A series of reports are displayed with information from the sensors
• The default is a 4 hour window but this can be changed from a drop down

60 © 2020 IBM Corporation

 IBM Software

Customized system reports

• Additional reports are available from the System Reports menu option

61 © 2020 IBM Corporation

 IBM Software

Customized system reports

• This list of reports can be modified however it requires the master IHQ admin user ID
• Once logged in, select the System Settings option from the user drop down
• Select the Report Management menu option

62 © 2020 IBM Corporation

 IBM Software

Customized system reports

• Clicking the Create Report
button opens a pane to
select the instance and
database(s) (including
sysmaster) then write the
query you want to execute
• You’ll get a preview of the
results

63 © 2020 IBM Corporation

 IBM Software

Customized system reports

• The default is for the report to output using the columns
names
• You can change the output names here
• You can also determine how the data is displayed by selecting
the output dat type for the column (if available)

64 © 2020 IBM Corporation

 IBM Software

Customized system reports

• You must provide a report name and
description to save it

65 © 2020 IBM Corporation

 IBM Software

Customized system reports

• IHQ stores the report information in
json within the IHQ database

66 © 2020 IBM Corporation

 IBM Software

Customized system reports

• The new report is now available to
run

67 © 2020 IBM Corporation

 IBM Software

Questions

68 © 2020 IBM Corporation