Setup instructions for sending SMS from HP Systems Insight Manager (HP SIM)
On this page you will find information on how
to setup an SMS system in your corporate IT environment with the help of Ozeki
NG SMS Gateway. In this article a detailed installation guide will be provided
on how to add SMS functionality to HP Systems Insight Manager and how to
configure the SMS gateway as well. Please follow our step by step setup
instructions and helpful video tutorials.
HP Systems Insight Manager makes it possible to monitor and
manage your corporate IT network from a central console. In this way corporate
network management will be easier and more effective. Though you can still
improve this system with the implementation of SMS technology. With SMS
functionality you can ensure that information detected by HP SIM will be
forwarded to the intended administrator. It is especially important in cases of
emergency that the IT staff have to be available. Speed is also critical in
those cases. So if you add SMS functionality to HP Systems Insight Manager you
can relieve these problems. You can be sure that all the competent people will
be informed about network failures in the right time. In practice it means that
they can intervene immediately to solve problems or to avoid further harms.
These functions can be achieved by Ozeki NG SMS Gateway software which makes
this SMS functionality possible. With the implementation of this software you
will be able to send SMS text messages from your IT network to given mobile
phones. In this way you can further improve efficiency and performance in your
corporate network. This will result in noticeable changes in your company. Your
IT staff will be more happier and efficient as their workload will be decreased.
Managers and customers also will be more satisfied as network errors will be
avoided or solved before these failures affect them. If you setup this solution
you will gain a stable, well-functioning and effective SMS system based on Ozeki
NG SMS Gateway.
Prerequisites
In order to setup this solution you need to find a way
to connect your system to the mobile network. You can do this
by using an Internet connection or you can
setup a wireless connection by attaching a GSM phone/GSM modem to your computer. To help you make a
decision, we have prepared a webpage for you:
Internet based SMS connections vs. GSM modem based (wireless) SMS connections.
Depending
on what you select, you need the following prerequisites.
Prerequisites for Internet based connection to the Mobile network
If you wish to connect your system to an SMS service
provider over the Internet you need the following components:
Figure 1/a - Prerequisites for Ozeki NG SMS
Gateway IP SMS connection
In this case you need to find an SMS service
provider who can reach the mobile phones in your area. This SMS
service provider should be able to provide SMS service through
the Internet. To find such a provider, you can check our
website where we list some of them:
SMPP SMS Service providers.
Once you have found such a provider, you need to sign up for
their service to get the connection parameters. You can use these parameters
to configure your Ozeki NG SMS Gateway software.
Prerequisites for wireless (GSM modem) connection to the Mobile network
If you wish to connect your system to the mobile
network wirelessly, you need a GSM modem or GSM phone, that you
can attach to your computer with a data cable. In this case your Ozeki
NG SMS Gateway software will operate this phone and will send and receive
SMS messages wirelessly. To setup this connection method, you need the following
components:
Figure 1/b - Prerequisites for Ozeki NG SMS
Gateway GSM modem connection
Your checklist (for GSM modem connection):
*The SIM card will come with a plan, that will
determine how much money you will spend on each SMS.
System architecture
After you browse our checklist above and make sure that you
meet all the requirements, you can start to setup this solution that will
work as follows: If an error occurs in your IT network, HP SIM will detect this
failure. In HP SIM there is an "Automatic Event Handling Task" that will process
the error. In this rule you need to pre-define some criteria (for example, the
system is not available). If this criterion is met during processing the error,
the created custom tool will be executed. This will automatically open the
directory of Ozeki NG SMS Gateway and execute SendSMS.exe file with the
necessary parameters. This SendSMS.exe file ensures the connection with Ozeki NG
SMS Gateway. The SMS software will process the file and sends the SMS message
to the given mobile phones. It forwards the SMS messages to the mobile
network either with the help of a GSM modem attached to the computer or it
directly connects to the SMS center of the mobile service provider. Figure 1.
demonstrates an overview of this solution and the basic inter-operation of the
components.
|
Figure 2 - Ozeki NG SMS Gateway - solution
for how to send SMS from HP Systems Insight Manager
Please note that the GSM modem connection is recommended as
it is more secure and reliable than sending SMS messages over the Internet using
IP SMS connection.
Installation guide
To install and configure Ozeki's solution for HP Systems
Insight Manager, please follow the steps below and watch this video tutorial.
I installed HP Systems Insight Manager on the computer named:
"insight.ozekisms.org". Now I will configure the system to be monitored
(Figure 3).
Figure 3 - Computer name
To start configure the system, log into HP Systems Insight
Manager with username and password. The Domain name also needs to be provided
(Figure 4).
Figure 4 - Admin credentials
After login a "First Time Wizard" is automatically launched.
(If you have already installed HP SIM on your computer you can start this
program at Options /First Time Wizard). Its first step is an introduction so
click on "Next" (Figure 5).
Figure 5 - Introduction
Now specify the operating systems of the systems you want to
manage. In our example it is "Windows". Click on "Next" (Figure 6).
 > |
Figure 6 - Managed environment
Next provide the IP address or IP ranges of the systems you
want to manage (Figure 7).
Figure 7 - Ping range
Now it can be checked in the monitored computer. Its name will
be "ozeki-monitored" in our example (Figure 8).
Figure 8 - Monitored host
The IP address of this monitored system is:
"192.168.91.150"
(Figure 9).
Figure 9 - Monitored system's IP address
This IP address can be provided in the IP address field of the
system you want to manage (Figure 10).
Figure 10 - Monitored host
In the next window you can provide the "Sign-in" and "SNMP"
credentials. If it is done click on "Next" (Figure 11).
Figure 11 - Sign-in and SNMP credentials
Next you can provide the sign-in credentials for Configure and
Repair Agents. Click on "Next" (Figure 12).
Figure 12 - Managed system's repair agent
Now the name of the computer on which HP SIM runs can be
provided in "Hostname" line. This name will identify this computer among
clients. Click on "Next" (Figure 13).
Figure 13 - WMI mapper proxy host
Next enter SMTP host for e-mail communication. Click on "Next"
(Figure 14).
Figure 14 - E-mail settings
Finally, you will get a summary about your configuration. Click
on "Finish" to close "First Time Wizard" (Figure 15).
Figure 15 - Wizard summary
By clicking on "All Systems" on "System and Event Collection"
tab, monitored systems can be seen (Figure 16).
Figure 16 - Monitored systems
Now click on "Tools" menu / "Custom Tools" / "New Custom
Tools" menu item (Figure 17).
Figure 17 - New Custom Tool
At first select "CMS tool" then click on "Next" (Figure 18).
Figure 18 - New CMS tool
Provide a name for this tool (in our example it will be "ozeki
command sms") then enter the follows (Figure 19):
Command with parameters:
cd C:\Program Files\Ozeki\OzekiNG - SMS Gateway & sendsms.exe -h
127.0.0.1:9500 -u admin -p abc123 -r '+36301234567' -m 'An error occurred on
%%DEVICENAME%%. Severity:%%NOTICESEVERITYSTR%%. Description: %%NOTICELABEL%%.'
|
To execute this command the following environment variables
need to be created:
| Name: | NOTICELABEL | Value: | %NOTICELABEL% |
| Name: | NOTICESEVERITYSTR | Value: |
%NOTICESEVERITYSTR%
|
| Name: | DEVICENAME | Value: | %DEVICENAME% |
Figure 19 - Command with parameters
If it is done click on "Next".
This table enlists the environment variables that can be
created:
| Names | Values | Descriptions |
|---|
| NOTICLABLE | %NOTICLABLE% | The short string type of event
(like
Discovered Device) |
| NOTICESTATE | %NOTICESTATE% | Shows whether the event has
been
cleared |
| NOTICEPLAINTEXT | %NOTICPLAINTEXT% | Plain text description
of the event
and also includes whether it is set
to In Progress,
Cleared, or Not
Cleared |
| NOTICERAWDATA | %NOTICRAWDATA% | The raw data of the event
that was
sent and in a string format. It is in
a pipe (|) delimited
format that can be used
for simple parsing |
| NOTICESEVERITYSTR | %NOTICESEVERITYSTR% | Can be Critical,
Major, Minor,
Unknown, Normal, Warning, or
Informational |
| NOTICESEVERITY | %NOTICESEVERITY% | An integer format of
the severity
0 - Unknown
1 – Normal
2 – Warning
3 – Minor
4 – Major
5 – Critical
100 - Informational |
| NOTICEQUERYNAME | %NOTICEQUERYNAME% | Displays the event
list that generated
the event. In the format of:
This device or event meets the
following query criteria: +QueryName;
This device or event now meets
the following query criteria: +QueryName;
This device or event no longer
meets the following query criteria:
QueryName |
| DEVICENAME | %DEVICENAME% | Name of the device that
generated
the event |
| DEVICEIPXADDRESSCOUNT | %DEVICEIPXADDRESSCOUNT% | Number
of IPX addresses that are mapped to this device |
| DEVICEIPADDRESSCOUNT | %DEVICEIPADDRESSCOUNT | Number of
IP addresses that are
mapped to this device |
| DEVICEIPADDRESS%D | %DEVICEIPADDRESS%D% | Based on the
count of IP
addresses, %d is an integer that shows the
actual IP
address.
For example, if DeviceIPAddressCount=2 then DeviceIPAddress0
=111.111.111.111
and DeviceIPAddress1
=222.222.222.222. |
| DEVICEMACADDRESS%D | %DEVICEMACADDRESS%D% | Based on the
MAC address count,
%d is an integer that references
the actual MAC
address variable. If DeviceMACAddressCount=2 then,
DeviceMACAddress0
=00:80:5E:7F:B0:81 and
DeviceMACAddress1
=00:80:C7:29:EF:B6 |
| GENERICTRAPID | %GENERICTRAPID% | If tied to an event list
and the
event was a SNMP trap, then this is
set to the SNMP
generic trap ID of the
trap received |
| SPECIFICTRAPID | %SPECIFICTRAPID% | If tied to an event
list and
the event was a SNMP trap, then it is set
to the SNMP
specific trap ID |
| PATH | %PATH% | Path variable received from the
operating system (received in
context of the windows service account)
|
| SYSTEMROOT | %SYSTEMROOT% | Variable received from the
operating system (received in context of the windows service
account) |
| WINDIR | %WINDIR% | Variable received from the operating
system (received in context of the windows service
account) |
| COMPUTERNAME | %COPUTERNAME% | Variable received from the
operating system (received in context of the windows service
account) |
| MPIP | %MPIP% | The IP address of the associated
management processor |
| MPNAME | %MPNAME% | The name of the associated management
processor |
| RELATEDDEVICECOUNT | %RELATEDDEVICECOUNT% | The number of
associated systems |
| RELATEDDEVICENAME%D | %RELATEDDEVICENAME%D% | The name of
the associated system, where %d is the iteration number.
For example:
IF, RELATEDDEVICECOUNT = 2
Then, RELATEDDEVICENAME()
=DeviceName()
RELATEDDEVICENAME1
=DeviceName1 |
| RELATEDDEVICEIP%D | %RELATEDDEVICEIP%D% | The IP address
of the associated system, where %d is the iteration number. For example:
IF, RELATEDDEVICECOUNT=2
Then, RELATEDDEVICEIP0
=111.111.111.111
RELATEDDEVICEIP1
=222.222.222.222 |
| RELATIONSHIP%D | %RELATIONSHIP%D% | The relationship
string with the associated system, and %d is the iteration number. For
example:
IF, RELATEDDEVICECOUNT=2
Then, RELATIONSHIP0
=ServerToEnclosure
RELATIONSHIP1=
VMGuestToVMHost |
You can test the created tool if you select it in the next
window and click on "Run Now/Schedule" (Figure 20).
Figure 20 - Run custom tool
Then select target systems. In our example it will be "All
systems". Click on "Apply" (Figure 21).
Figure 21 - Target systems
Next verify target systems. If you click on "Run now" then
"ozeki command sms" tool will be executed (Figure 22).
Figure 22 - Verify target systems
If you take a look at Ozeki NG SMS Gateway you can see the sent
message (Figure 23).
Figure 23 - Test at Ozeki NG SMS Gateway
Now click on "Options" / "Events" / "Automatic Event Handling"
/ "New Task" menu item (Figure 24).
Figure 24 - New Automatic Event Handling Task
Provide a name for the task (in our example it is: "ozeki sms
notification") and click on "Next" (Figure 25).
Figure 25 - Provide a name
If you select "use event attributes that I will specify" option,
you can customize which events should this task react to. Click on "Next"
(Figure 26).
Figure 26 - Use custom event attributes
Next you can select events and their criteria. Click on "Next"
(Figure 27).
Figure 27 - Monitor critical severity
If you select "use system attributes that I will specify"
option you can select for which monitored system you want to apply this rule.
Click on "Next" (Figure 28).
Figure 28 - Custom system attributes
Select the name of the monitored computer and click on "Next"
(Figure 29).
Figure 29 - Monitored system name
Next check the "Run custom CMS tool" menu item, select the
created custom tool (in our example it is "ozeki command sms") and click on
"Next" (Figure 30).
Figure 30 - Select custom cms tool
In the next window check the check box if you wish to use a
time filter. If it is selected, then actions will be run only if the events
match the criteria occur during the times specified by the time filter. If
you do not want to use this option click on "Next" (Figure 31).
Figure 31 - Time scheduling
In the end a summary will be provided about your configuration.
If you click on "Finish" the created task will be applied (Figure 32).
Figure 32 - Automatic task summary
If you click on "All Systems" on "System and Event Collection"
tab you can see the monitored systems (Figure 33).
Figure 33 - Monitored systems
To test the system I will generate an error. To do so I disable
the network connection in the monitored system (Figure 34) and (Figure 35).
Figure 34 - Disable network connection
Figure 35 - Connection is disabled
After a short period of time the error will be detected in HP
SIM (Figure 36).
Figure 36 - System is unreachable in HP SIM
If you take a look at Ozeki NG SMS Gateway you can see that the
message has been sent (Figure 37).
Figure 37 - Sent message in Ozeki NG SMS
Gateway
Thank you for reading this guide!
If you wish to add SMS extension to your HP Systems
Insight Manager software, please go to the download page to download Ozeki NG
SMS Gateway
FAQ
Feature list of Ozeki NG SMS Gateway
User Guide for Ozeki NG SMS Gateway
Product manual
| 
