rightfax management pack installation guide · 2019-05-23 · rightfax management pack installation...

RightFax Management Pack Installation Guide

Last Revision: March 2018

Green House Data 340 Progress Circle

Cheyenne, WY 82007

866-995-3282 – 24/7/365

Portland - Seattle - Bellingham - Las Vegas Denver - Cheyenne - Dallas - Atlanta - Toronto - Orangeburg

` RightFax MP Installation Guide – March 2018

Proprietary and Confidential

Copywrite ©2015 Green House Data. All rights reserved. All management packs should be thoroughly tested before being introduced into a production Operations Manager environment. The authors of this management pack accept no responsibility or liability for negative impact as a result of use of this management pack in your Operations Manager environment.



Contents Green House Data Management Pack Features .............................................................. 5

Discoveries ................................................................................................................... 5 Monitoring ..................................................................................................................... 5

Document Version .............................................................................................................. 6

Revision History ............................................................................................................ 6 Getting the Latest Management Pack and Documentation .............................................. 6

Known Issues in this Release ......................................................................................... 6

Supported Configurations ............................................................................................... 7

Files in This Management Pack ......................................................................................... 7

Before Importing the Management Pack ........................................................................... 7

Configure Agent Proxy .................................................................................................... 7

Create a New Management Pack for Customizations ................................................... 7

SNMP Service Configuration on SCOM Management Servers .................................... 7

Import the Green House Data EMC Isilon Management Pack ......................................... 8

After importing the Management Pack .............................................................................. 8

Licensing the Management Pack ................................................................................... 8

Add the SNMP Community String Account (Optional, if SNMP is used) .................... 11

Add the RightFax Windows COM API Access Account ............................................... 13

Add the RightFax Server COM API Access Account ................................................... 13

Understanding Management Pack Operations ............................................................... 15

Discovered Classes ...................................................................................................... 15

Monitors ......................................................................................................................... 16

Rules.............................................................................................................................. 20

Tasks ............................................................................................................................. 22

Views ............................................................................................................................. 24

Monitoring Scenarios .................................................................................................... 30

How to Configure Synthetic Transactions ....................................................................... 34

RightFax Reports .............................................................................................................. 42

RightFax Add-In for OMS ................................................................................................. 43

RightFax Installation and MP Configuration, Sample Scenario ...................................... 44

Install SQL Server 2012 .................................................................................................... 44



Install RightFax 10.6 ......................................................................................................... 46

Run Discovery of RightFax Server in SCOM ................................................................... 52

Change Use NT Authentication Parameter for Performance Rules to “Yes” ................. 56



Green House Data Management Pack Features

Green House Data RightFax Management Pack is featuring discovery and monitoring for RightFax application server infrastructure components:

Discoveries - RightFax deployment(s) - common database - RightFax Fax Server - RightFax Work Server and Work Server Module(s) (local or remote) - RightFax Doc Transport (local or remote) - Common Disk Storage - RightFax Database

- RightFax SNMP Agent - RightFax Transport Channel - RightFax SAP Connectors - RightFax MSMQ Queues - RightFax MSMQ Queue Service - RightFax Services

Monitoring - Services (all RightFax services per roles) - Availability

o Database o Common Disk Storage o SNMP agent o Transport Channel o SAP Connectors o Email Gateways o Work Server Modules o Work Server Remote Modules o Services

- Licensing for RightFax SNMP agent - Listen to all RightFax SNMP traps (with duplicate suppression) - Current Faxes Queue against configurable threshold

- RightFax Performance Counters collection o Available Disk Space % o Internal Event Queue in Use % o Faxes Sent o Faxes Received o Faxes Scheduled o Faxes Queued o Pages Queued

- RightFax Send Test Fax - RightFax Send External Test Faxes - RightFax Performance Data connector to OMS - Tasks - get Time Running for RightFax critical services



Document Version

This guide was updated based on version 1.0.0.127 of the Infront RightFax Management Pack.

Revision History

Release Date Changes

April 2014 MP Version 1.0.0.1

October 2014 MP Version 1.0.0.2

June 2015 Documentation Updated

November 2015 MP Version 1.0.0.45

December 2015 MP Version 1.0.0.60

January 2016 MP Version 1.0.0.65

May 2016 MP Version 1.0.0.85

June 2016 MP Version 1.0.0.92

April 2017 MP Version 1.0.0.104

October 2017 MP Version 1.0.0.119

January 2018 MP Version 1.0.0.125

March 2018 MP Version 1.0.0.127

Getting the Latest Management Pack and Documentation You can find the Green House Data RightFax Management Pack at https://www.greenhousedata.com/software Known Issues in this Release

There are no known issues with the Green House Data RightFax Management Pack.

The current release v1.0.0.127 is addressing some issues, not related to the

Management Pack itself, where performance counters collection and

monitoring via SNMP were not available, and as they required some RightFax

modules licensed and working. To overcome this limitation, version 1.0.0.127

is providing (in addition to SNMP) another method of collecting and

https://www.greenhousedata.com/software



monitoring RightFax statistics (performance counters), making use of RightFax

COM API library.

Supported Configurations

The Green House Data RightFax Management Pack is designed and tested to work with:

- System Center Operations Manager 2012 R2, 2016;

- Open Text RightFax 10.5 or 10.6

Files in This Management Pack

The Green House Data RightFax Management Pack consists of the following files:

File Version Description

InfrontRightFaxMP.msi 1.0.0.127 The downloadable installer

Infront.RightFax.mpb 1.0.0.127 The sealed management pack file (installed by the msi)

Infront.RightFax.OMS.mp 1.0.0.127 The sealed management pack file add-in for OMS (installed by the msi)

InfrontRightFaxMP.pdf 1.0.0.127 Management Pack documentation (installed by the msi)

Before Importing the Management Pack Configure Agent Proxy

IMPORTANT STEP. Enable Agent proxy on all SCOM agents deployed on RightFaxservers.

Create a New Management Pack for Customizations

The Green House Data RightFax Management Pack is sealed. None of the

original settings in the management pack file can be changed. However,

customizations, such as overrides or new monitoring objects, may be created

by saving them to a different management pack (suggested MP name:

Infront.RightFax.Overrides)

SNMP Service Configuration on SCOM Management Servers

There is NO need to install and configure SNMP Service feature on SCOM

Management Servers.



For SNMP Service configuration of the RightFax Server(s) please follow the

OpenText RightFax Installation and Administration guides.

Import the Green House Data EMC Isilon Management Pack

Execute the Management Pack Installer and then follow the normal procedure to import the Green House Data RightFax Management Pack.

After importing the Management Pack Licensing the Management Pack In this version of the Management Pack there is a new console task available from the Windows Computers view to be executed.

- Overwrite it with the number of target license to be used

- The task output will show you the location of the request license file.



- Send us this file to provide the License Key and follow these steps:

1. In the SCOM OpsMgr Console, click on the Authoring tab

2. Select Scope and enter RightFax Common in the “Look for:”

3. Select the discovery



4. Override for all objects of class: RightFax Common (Seed)

5. Enter the license key and save the override in

Infront.RightFax.Overrides MP (suggested).

6. To add the required Registry keys, depending in the version you are running 32 or 64 bits, to specify which servers will be considering for monitoring. Just run the new task from the Windows Computer View. This task will create the following registry keys according to your 32 or 64 bits RightFax installation. This is only setting to define if you are using NT Authentication or RightFax Authentication.



32 Bits: SOFTWARE\RightFax\AddToSCOM

64 Bits: SOFTWARE\Wow6432Node\RightFax\AddToSCOM

Add the SNMP Community String Account (Optional, if SNMP is used)

1. In the SCOM Console, click on the Administration tab

2. Create a Community String account to be used by the Management

Pack SNMP workflows (example below)

Note. Credentials must match the accepted community name in the

configuration (Security tab) of the SNMP service that is running on the

RightFax servers.



3. Make sure you distribute the account to the Health Service on

the Management Servers.

4. Add the account to the Run As Profile

Click on “Profiles” under “Run as Configuration” and locate the SNMP

Monitoring Account. Configure it as in the screenshot below:

This Management Pack Supports 2 ways for COM API Security

• Windows NT Authentication

• RightFax Credentials



Add the RightFax Windows COM API Access Account


2. Create a Windows account to be used by the

Management Pack workflows that make calls to

RightFax COM API.

3. Make sure you distribute the account to the Health Service on the RightFax

Fax Servers.


Click on “Profiles” under “Run as Configuration” and locate the RightFax

RFCOMAPI Account Run as Profile. Configure it as in the screenshot

below:

Add the RightFax Server COM API Access Account




2. Create a Basic Authentication to be used by the

Management Pack workflows that make calls to

RightFax COM API.

3. Make sure you distribute the account to the Health Service on the RightFax Fax Servers.


Click on “Profiles” under “Run as Configuration” and locate the RightFax

RFCOMAPI Account Run as Profile. Configure it as in the screenshot below:

Note: Required permissions of the action account in RightFax as follow.



Understanding Management Pack Operations Discovered Classes

Here are the classes defined and discovered by Green House Data RightFax MP.

Name Is Singleton Type

RightFax ALL EDC Modules False Object

RightFax ALL EDC Processors False Object

RightFax ALL EDC Services False Object

RightFax ALL EDC Services False Object

RightFax All Exchange Email Gateways

True Group

RightFax All Fax Servers True Group

RightFax ALL Features False Object

RightFax All Instances True Group

RightFax All SAP Connectors True Group

RightFax All User Groups False Dynamic Group

RightFax Common False Object

RightFax Common (Seed) False Object

RightFax Common Disk Storage Watcher

False Watcher

RightFax Database Watcher False Watcher

RightFax Deployment False Distributed Application



RightFax Deployments True Group

RightFax Doc Transport False Object

RightFax Doc Transport OEM Module False Object

RightFax EDC Module False Object

RightFax EDC Processor False Object

RightFax EDC Service False Object

RightFax Service False Object

RightFax EDC Service False Object

RightFax Fax Server False Object

RightFax Feature False Object

RightFax SNMP Agent Watcher False Watcher

RightFax Work Server False Object

RightFax Work Server Remote False Object

RightFax Work Server Module False Object

RightFax Work Server Module Remote

False Object

RightFax User Group False Object

RightFax Transport Channel False Object

RightFax Email Gateway False Object

RightFax SAP Connector False Object

RightFax MSMQ Queue False Object

RightFax MSMQ Service False Object

Monitors

Here is the list of the monitors defined by the Green House Data RightFax MP:

Monitor Target Description

RightFax DocTransport

Module Service Monitor

RightFax

DocTransport

Service Monitor

RightFax RPC Server


RightFax

DocTransport

Service Monitor

RightFax Conversion

Engine Service Monitor

RightFax

WorkServer

Service Monitor



RightFax Conversion

Engine Remote

Service Monitor

RightFax

WorkServer

Remote

Service Monitor

RightFax Database

Module Service

Monitor

RightFax Fax Server Service Monitor

RightFax eTransport

Module Service

Monitor


RightFax Licensing

Service Monitor


RightFax MSMQ

Service Monitor


Right Fax Licensing

State Error Monitor

RightFax Fax Server Events Log Monitor that checks for license state events.

RightFax Paging Server



RightFax Queue

Handler Service

Monitor


RightFax Remoting

Service Monitor


RightFax Server

Module Service

Monitor


RightFax Sync Module

Service Monitor


RightFax SAP

Connector Module

Service

RightFax SAP Connector

Service Monitor

RightFax Shared

Path Availability

Monitor

RightFax Common

Disk Storage

Watcher

Monitoring availability of the

Common Disk Storage in a

shared services

configuration

RightFax Database

Availability Monitor

RightFax

Database

Watcher

Monitoring availability of

the database



RightFax Current

Faxes Queued

Monitor

RightFax SNMP

Agent Watcher

Monitoring that Current Faxes

Queued does not raise above

configurable threshold

(default 50)

(disabled by default)

RightFax SNMP

Agent Availability

Monitor

RightFax SNMP

Agent Watcher

Monitoring for failing

SNMP operations


RightFax Work

Server Module

Service Monitor

RightFax Work

Server Module

Service Monitor

RightFax Service Monitor RightFax Service Service Monitor

RightFax Work Server

Module Service


RightFax

Work

Server

Module


RightFax Work

Server Remote

Module Service

Monitor

RightFax

Work

Server

Module

Remote

Service Monitor

RightFax Work

Server Remote

Module Service


RightFax

Work

Server

Module

Remote


RightFax Documents

Queued for

Transmission Monitor

RightFax Fax Server Monitoring the number of documents queued for transmission

(thresholds are overridable and set to 50 as warning level and 100 as error level)

RightFax Doc Transport OEM Module Service Monitor

RightFax Doc Transport OEM Module

Service Monitor

RightFax EDC Processor Monitor

RightFax EDC Processor

Service Monitor

RightFax EDC Service Monitor

RightFax EDC Service

Service Monitor

RightFax Email Gateway Service Monitor

RightFax Email Gateway Service

Service Monitor

RightFax Email Gateway Availability Monitor

RightFax Email Gateway Service




RightFax Attachment Filename Monitor

RightFax Fax Server Monitors to ensure only

valid en-US characters are

present in attachment

filenames.

RightFax Exchange Gateway Mail data monitor

RightFax EDC Service Monitors Mail data folder

for the number of files

present. Monitor features

overridable thresholds.

RightFax Send Test Fax Monitor

RightFax Fax Server Attempts to send a test fax

using the RightFax API

Run as profile user. This

monitor is disabled by

default. You should

override it to enable it.

Sending and receiving fax

timeout, User to send and

routing code to use, and

try count could be

override to a desired

values.

RightFax Send External Test Faxes Monitor

RightFax Fax Server Attempts to send external

test faxes using the

RightFax API Run as

profile user. This monitor

is disabled by default.

You should override it to

enable it. Sending fax

timeout, User to send and

fax numbers to send from

and to, and try count

could be override to a

desired value.

RightFax Check Faxes

With Error Monitor

RightFax User Group Checks within the User Group for faxes with errors and raised alerts

RightFax Hardware

Service Monitor


RightFax Transport

Channel State Monitor

RightFax Transport Channel

Channel State Monitor



RightFax Transport

Channel Availability

Monitor

RightFax Transport Channel

This monitor checks the availability of Transport channels

RightFax SAP

Connector Availability

Monitor

RightFax SAP Connector


Rollup and Aggregate monitors are also defined to complete the distributed application health model. Rules

Here is the list of the rules defined by the Green House Data RightFax MP:

Rule Target Description

RightFax Server Not

Licensed for SNMP

Agent

RightFax Fax

Server

Raises a warning alert in

case SNMP Agent is not

licensed

RightFax SNMP Trap

Listener Rule (Filtered)

RightFax SNMP

Agent Watcher

Raises critical alert in case

RightFax specific SNMP is

received (with duplicate

suppression) RightFax SNMP Trap

Listener Rule (Not

Filtered)

RightFax SNMP

Agent Watcher

Raises critical alert in case

ANY SNMP is received


RightFax SNMP Trap

Listener Event

Collection Rule (Not

Filtered)

RightFax SNMP

Agent Watcher

Writes event in case ANY

SNMP is received


RightFax FaxServer

Current Faxes Queued

Collection Rule

RightFax SNMP

Agent Watcher

Collects FaxServer Current

Faxes Queued counter

(every 15min) (disabled by

default) RightFax FaxServer

Current Pages Queued

Collection Rule

RightFax SNMP

Agent Watcher

Collects FaxServer Current

Pages Queued counter


default) RightFax Faxes

Received Collection

Rule

RightFax SNMP

Agent Watcher

Collects Faxes Received

counter (every 15min)


RightFax Faxes Sent

Collection Rule

RightFax SNMP

Agent Watcher

Collects Faxes Sent



(disabled by default) RightFax Faxes

Scheduled Collection

Rule

RightFax SNMP

Agent Watcher

Collects Faxes Scheduled





RightFax FaxServer

Disk Space Available

For Fax Images

Percentage Collection

Rule

RightFax SNMP

Agent Watcher

Collects FaxServer Disk

Space Available For Fax

Images Percentage


(disabled by default) RightFax FaxServer

Internal Event Queue

Currently In Use

Percentage Collection

Rule

RightFax SNMP

Agent Watcher

Collects FaxServer Internal

Event Queue Currently In

Use Percentage counter


default) RightFax Number of

faxes received

Collection Rule

RightFax Fax

Server

Collects ActLogFaxesRcdv

statistic (every 5 min)

RightFax Number of

pages received

Collection Rule

RightFax Fax

Server

Collects ActLogPagesRcvd


RightFax Number of

faxes sent Collection

Rule

RightFax Fax

Server

Collects ActLogFaxesSent


RightFax Number of

server events

processed Collection

Rule

RightFax Fax

Server

Collects

FsEventsProcessed


RightFax Number of

pages sent Collection

Rule

RightFax Fax

Server

Collects ActLogPagesSent


RightFax Queue Depth

(faxes) Collection Rule

RightFax Fax

Server

Collects

FSBrdsQueueDepthFaxes


RightFax Queue Depth

(pages) Collection Rule

RightFax Fax

Server

Collects

FSBrdsQueueDepthPages


RightFax Number of

events in server queue

Collection Rule

RightFax Fax

Server

Collects FsNumberEvents


RightFax Status records

queued for transmission

Collection Rule

RightFax Fax

Server

Collects

FsStatusQueueDepth


RightFax Documents

queued for transmission

Collection Rule

RightFax Fax

Server

Collects

FsScheduleQueueDepth


RightFax Percentage of

disk space available on

Image drive Collection

Rule

RightFax Fax

Server

Collects

FsPercentAvailableImageS

pace statistic (every 5 min)

RightFax Exchange

Gateway queue

Collection Rule

RightFax EDC

Service

Collects the number of

items in the Queue (every

15 minutes)



RightFax Not Enough

Licensed Targets Rule

Infront RightFax

MP License

Raises an alert if an

insuffienct number of CALs

have been purchases from

Infront to monitor your

RightFax environment. RightFax Possible

Phone Line Failure Rule

RightFax Fax

Server

Raise an alert if a phone

line reports a possible

failure

RightFax Cannot Find

User Or Group With

Routing Code Rule

RightFax Fax

Server

Raise an alert if cannot find

user or group when

receiving a fax by a routing

code used RightFax Format Error

Routing Fax To

Telephony Server

Mailbox Rule

RightFax Fax

Server

Raise an alert when a

format error when routing a

fax to the telephony server

mailbox RightFax Error

Executing Telephony

Server Fax To VM Rule

RightFax Fax

Server

Raise an alert when

processing a Telephony

Server Fax to VM action

RightFax Attempt To

Use A PDF Or Post

Script Functionality Rule

RightFax Fax

Server

Raise an alert for

conversion errors when

tried to use PDF or Post

script functionality without

license. RightFax Troubleshoot

Events Collection Rule

Windows

Computer

Collects all RightFax MP

events related

* Note: for more information on the counters listed in bold in the table

above please consult the OpenText RightFax COM API Reference

Guide – Chapter 9.

Tasks

Task Target Description

Get RightFax Database

Module Time Running

RightFax SNMP

Agent Watcher

Retrieves the Database

Module Time Running

Get RightFax Doc

Transport Time

Running

RightFax SNMP

Agent Watcher

Retrieves the Doc

Transport Time

Running

Get RightFax Queue

Handler Time Running

RightFax SNMP

Agent Watcher

Retrieves the Queue Handler

Time Running

Get RightFax RPC

Server Time Running

RightFax SNMP

Agent Watcher

Retrieves the RPC

Server Time Running

Get RightFax Server

Time Running

RightFax SNMP

Agent Watcher

Retrieves the Server Time Running



Verify RightFax COM

API Access

RightFax Fax Server Checks the correct

configuration for accessing

RightFax COM API

Deploy Infront

RightFax MP

SCOM Keys

Windows Computer Creates required SCOM

keys for discovery and

monitoring usage

Generate Infront

RightFax MP License

Request File

Windows Computer Creates the MP license request file

By selecting one of the RightFax Fax Server objects you have the

option to execute the following tasks:

Here is the task output if executing “Verify RightFax COM API Access”:

In case an error is returned while executing this task, the following things need to be verified:

- The account, with proper access, specified in RightFax RFCOMAPI Account Run As Profile

- The RightFax COM API installation and configuration.

(Optional) By selecting one of the RightFax SNMP Agent Watcher objects

you have the option to execute the following tasks:



Here is the task output if executing “Get RightFax Server Time Running”:

Views

The following views are made available by the Infront RightFax MP:

The RightFax Deployments Diagram should look like in the sample below:



The RightFax All Alerts will have all open alerts that are raised by one

(any) RightFax Class Instance:

The RightFax Performance Counters (via COM API):

RightFax Fax Servers State



RightFax DocTransport Server State

RightFax Work Server Module State



RightFax University Web Page View

RightFax User Group State



RightFax Transport Channels State

RightFax SAP Connectors State

RightFax MSMQ Queue State



RightFax MSMQ Service State

RightFax Services State

RightFax Troubleshoot Events View



Monitoring Scenarios

Monitoring Scenario MP Action

RightFax Service Stopped (Not Running) Critical Alert is generated

Note. Alert is generated in case service is configured as Automatic startup type. Some services are configured as Manual startup type. In case these services are to be monitored as well there are 2 choices:

- Configure the service as Automatic startup type or

- Configure an override as per http://blogs.technet.com/b/kevinholman/archive/2010/11/07/monitoring-windows- services-automatic-manual-and-disabled-using-checkstartuptype.aspx

RightFax Database Unavailable Critical Alert is generated

RightFax Common Disk Storage Unavailable

Critical Alert is generated

RightFax Specific SNMP Trap Is Received Critical Alert is generated

http://blogs.technet.com/b/kevinholman/archive/2010/11/07/monitoring-windows-services-automatic-manual-and-disabled-using-checkstartuptype.aspx






RightFax SNMP probe operation failed Warning Alert is generated

RightFax Current Faxes Queued Exceeding

Threshold


RightFax MP License Violation

Not enough licensed targets; the

number of discovered and monitored

FaxServers (targets) are exceeding

the number of the licensed targets


RightFax Faxes with Error Found

Faxes with errors found within the User Group




RightFax Hardware Service is not Running

The configured Hardware Service is not running. Need to check if the service is active and running. Usually the hardware used is the “Dialogic Corporation Boston Host Service”


RightFax Transport Channel Is Not Active

If any of the Channels State is changed to Not

Active this alert is raised.


RightFax Transport Channel Is Not Available

If any of the Channels State is changed to Not

available this alert is raised.


RightFax Email Gateway Is Not Available

If any of the Email Gateways State is changed

to Not available this alert is raised.




RightFax Work Server Module Is Not Available

If any of the Work Server Module State is

changed to Not available this alert is raised.


RightFax SAP Connector Is Not Available

If any of the SAP Connector State is changed to Not

available this alert is raised.


RightFax SAP Connector Service Is Not Running

If any of the SAP Connector Service State is

changed to Not running this alert is raised.


Note. In case alert RightFax MP License Violation is received there are

2 actions that can be taken:

- Contact Infront Consulting Group to purchase additional MP licenses

- In case some RightFax servers are not intended to be

monitored, they have to be excluded from discovery using the

procedure below.



In OpsMgr Console go to Authoring / Object Discoveries

Scope to “RightFax Fax Server”

Create override for a specific object of class “RightFax Common”; select the

server(s) that are needed to be excluded.

Select Action parameter and change the override value to Exclude

Save the setting in the overrides MP.

How to Configure Synthetic Transactions

There are 2 monitors that provide this functionality:

1. RightFax Send Test Fax Monitor:



This monitor checks the status of sending and receiving Test Faxes internally using RightFax engine.

a. Navigate to the RightFax Server view

b. Then open the Health Explorer of the desire server you wanted to activate this monitor.

c. Select the monitor for sending faxes internally

d. Open the monitor properties and select the following parameters:

- Enabled: True

- Count Limit: Is the number of tries to process each fax included in the



Test. The default value is 10

- Fax Send Timeout: Is the milliseconds before cancel sending each fax

Included in the test. The default value is 5000

- Fax Received Timeout: Is the milliseconds before cancel waiting for the receipt

of each fax sent included in the test. The default value is 15000

- Fax to Number: Is the RightFax Routing code to use for sending the faxes

To include in the test. This must be a defined Routing Code, like in this sample is 102.

- Fax To User: Is the User Name that will send to fax included in the Test. This can be any given Internal User Name, like in This sample is BILL. (Note this value is case sensitive as is Defined in RightFax

- Interval Seconds: Amount of seconds to wait between each state Evaluation. The default value is 300. Note that this value Is the maximum time that the overall monitor will use to Complete all the tests, so if you set to fax send timeout For 5 seconds with 10 count limit and 15 seconds to receive it, the total time spend in this must not be higher than the interval seconds.



e. Save these new values in an override MP and wait for the updated settings to be applied.

f. Note that you don’t need to specify any credentials for this monitor, because it will use the already configured credentials obtained from the corresponding run as account used in this management pack. (See section for configuring them)

g. When the monitor executes will create a temporary folder "C:\TestFaxes\" and file "TestFax.txt" attachment that will be used during the transaction. Note this file will be deleted after its usage and recreated back again with every execution.

h. Some events are logged in the Operations Manager log, every time this monitor is executed, with event Id 18080, which will show you the progress or any possible issue during the execution.

2. RightFax Send External Test Fax Monitor:

This monitor checks the status of sending and receiving Test Faxes externally using RightFax engine.

i. Navigate to the RightFax Server view



j. Then open the Health Explorer of the desire server you wanted to activate this monitor.

k. Select the monitor for sending faxes internally

l. Open the monitor properties and select the following parameters:

- Enabled: True

- Count Limit: Is the number of tries to process each fax included in the

Test. The default value is 4

- Fax Send Timeout: Is the milliseconds before cancel sending each fax

Included in the test. The default value is 5000



- Fax Received Timeout: Is the milliseconds before cancel waiting for the receipt

of each fax sent included in the test. The default value is 5000

- Fax from Number: Is the Real Fax Phone Number that will send the fax from

Included in the test. This usually is the user Fax Number

- Fax to Number: Is the Real Fax Phone Number that will send the fax to

Included in the test. This can be any external Fax Number

- Fax from User: Is the User Name that will send from each fax

included in The test. You must define this value according to your Defined User Names

- Fax To User: Is the User Name that will send to fax included in the Test. This can be any given User Name (Internal or External)

- Sample Number: Is the number of faxes to send included in the test. The

Default value is 3

- Interval Seconds: Amount of seconds to wait between each state Evaluation. The default value is 300. Note that this value Is the maximum time that the overall monitor will use to Complete all the tests, so if you set to fax send timeout For 5 seconds with 10 count limit and 15 seconds to Receive it, multiply by the sample number the total time Spend in this must not be Higher than the interval Seconds.



i. Save these new values in an override MP and wait for the updated settings to be applied.

j. Note that you don’t need to specify any credentials for this monitor, because it will use the already configured credentials obtained from the corresponding run as account used in this management pack. (See section for configuring them)

k. When the monitor executes will create a temporary folder "C:\TestFaxes\"

and file "TestBulkFax.txt" attachment that will be used during the transaction. There is also another file “TestSendBulkFaxes.cmd” used for running the tests. Note these files will be deleted after its usage and recreated back again with every execution.

l. Some events are logged in the Operations Manager log, every time this monitor is executed, with event Id 18080, which will show you the progress or any possible issue during the execution.



RightFax Reports

In this Management Pack version there are 2 new reports:

1. RightFax Faxes Sent and Received Last Month



2. RightFax All Instances Availability Last 30 Days

RightFax Add-In for OMS

To provide support for OMS, you need to import first all the different references Management Packs for OMS:

- Microsoft.IntelligencePack.Core.mpb - Microsoft.IntelligencePacks.Performance.mpb

Then after configuring all the channel communication configurations you will import the following MP, that is part of this msi:

- Infront.RightFax.OMS.mp

After a while, at least 1 hour, you will start to see the data coming to OMS. Here is a sample of dashboard built in OMS:



RightFax Installation and MP Configuration, Sample Scenario

The sample scenario provided below is provided to outline the basics of Installing RightFax

10.6 Server and then discovering it in SCOM. This scenario below is for a single vanilla RightFax

10.6 Server that does not use NT Authentication and is reporting into SCOM.

Additionally, the following environment items are assumed:

1. The RightFax Server is joined to a domain

2. There is a single Domain Service Account for RightFax called DOMAIN\svc_rfax

3. The DOMAIN\svc_rfax Service Account is a member

of the Local Administrators Group on the RightFax

Server

4. The Password for the DOMAIN\svc_rfax Service Account is: P@ssw0rd

5. UAC is disabled on the RightFax Server

6. Windows Firewall Service is disabled on the RightFax Server

7. IE ESC is disabled on the RightFax Server

8. .NET 3.5 is installed

9. IIS is installed with the following additional components

• Enable Basic Authentication

• Enable Windows Authentication

• Enable IIS 6 Management Compatibility

Install SQL Server 2012 These instructions assume that you have access to at least SQL Server 2012

Standard. Below are basic instructions on how to install and configure SQL

Server 2012 Standard for RightFax.

1. Launch the setup.exe for the SQL Server 2012 binaries.

2. In the SQL Server Installation Center click on Installation

and then choose New SQL Server stand-alone installation

or add features to an existing installation. 3. The SQL Server 2012 Setup will start with Setup Support Rules,

click on OK.

4. Enter the product key or use the Evaluation on the Product Key Page and click Next.

5. Put a check mark next to I accept the license terms on the License Terms Page

and click Next.

6. On the Product Updates Page the installer will attempt to check

for SQL Updates (which requires internet access). Regardless of

this succeeding or not, click Next.

7. On the Install Setup Files Page, setup files will be installed and

the installer will continue automatically.

8. On the Setup Support Rules Page, the setup checks will run



automatically, if there are no Failed items, click Next.

9. On the Setup Role Page, choose SQL Server Feature Installation and click Next.

10. On the Feature Selection Page, leave the default path of where

to install Shared Feature directories and choose the features to

install as shown in the Image below. Afterwards, click Next.

11. On the Instance Configuration Page, leave the default values in

place and click Next.

12. On the Disk Requirements Page, click Next.

13. On the Server Configuration Page, use the DOMAIN\svc_rfax

account credentials for the SQL Services shown in the image

below. Make sure all the services have the Startup Type set to

Automatic. Afterwards, click Next.

14. On the Database Engine Configuration Page, make sure to click



on Add Current User and then add the DOMAIN\svc_rfax service

account. Afterwards, click Next.

15. On the Analysis Services Configuration Page, make sure to

click on Add Current User and then add the DOMAIN\svc_rfax

service account. Afterwards, click Next.

16. On the Reporting Services Configuration Page, Choose Install and Configure

under Reporting Services Native Mode and click Next.

17. On the Error Reporting Page, ignore the option(s) available and click Next.

18. On the Installation Configuration Rules Page, unless a

Failed item appears, click Next.

19. On the Ready to Install Page, click Install.

20. Hurry up and wait as shown below

21. Once the installation is finished, verify that all of the SQL Services are running

Install RightFax 10.6 The instructions below are only for RightFax 10.6 and may not work for

previous version of RightFax.

1. After mounting the RightFax ISO or extracting the binaries,

launch the setup.exe as shown in the image below. You must

use the one selected in the image below or else the installation

will not run!



2. On the RightFax Product Suite Setup Page, click Next.

3. On the next page, select I accept the terms in the license agreement and click Next.

4. Choose Typical RightFax Server and Include fax board and

FOIP drivers and click Next.

5. On the preview requirements for selected features page, click

Next.

6. Choose Install Microsoft Message Queuing and click Next.

7. Choose Use an existing SQL Server and click Next.

8. Keep the default values for the Reserved TCP/IP Ports and click Next.


Green House Data – of 57

9. On the following page, click on Apply. The RightFax prerequisites will

then be installed.

10. When the ready to install page appears, click Next.

11. Keep the defaults on the Select the RightFax installation folder page and click Next.

12. On the following page, click on Apply. The RightFax Product Suite will

then be installed.

13. On the Ready to configure page, click Next.

14. On the Select the Windows account for RightFax services page,

type in the credentials for the DOMAIN\svc_rfax service account and

click Next.



15. On the Select the configuration mode for this server page,

choose Create New RightFax Database and click Next.

16. On the Define a SQL connection for Setup page, type in the

Hostname of the RightFax Server and click Next.

17. On the Choose a name for the RightFax database page, leave the

default name of RightFax and click Next.

18. On the Define a SQL connection for RightFax services page, leave

the default values and click Next.

19. On the RightFax Activation page, click on Launch License Utility.



20. On the Introduction page, click on Activate.

21. On the RightFax Activation page, type in the Email Address and SUID

values or choose Evaluation License. Once those values are in place,

click on Activate. Note: Activation requires Internet Access

22. On the next page, Accept the EULA. If you used the Evaluation

License, you have 30 days to obtain a permanent license.

23. On the RightFax License Summary page, click Close.

24. Back on the RightFax Product Suite Setup, click on Apply. The

installation will then continue.

25. Once the RightFax Setup is complete, click on Restart Now. The

RightFax Server will then restart.

26. Once the RightFax Server comes back online, mount the RightFax ISO

or extracting the binaries, launch the setup.exe as shown in the image

below. You must use the one selected in the image below or else the

installation will not run!



27. On the RightFax Product Suite Setup Page, choose Add or remove

features and click Next.

28. On the Select features page, make sure to put a check mark next

to the following features, and click Next.

• Administrative Utilities

• Web Applications (except RightFax SharePoint Web Service)

• RightFax Print Driver (except RightFax eDOCS)

• RightFax AutoReply

29. On the Preview requirements for selected features page, click Next.

30. On the Remote RightFax services must be shutdown page, select I

have shut down all remote RightFax services and click Next. (you

can ignore the fact that you have not shutdown all the RightFax

services.)

31. On the Applications and Services page, click Next.

32. On the Apply Settings page, click Apply. Some of the options you

selected earlier will be installed.

33. On the Ready to install page, click Next.



35. On the Ready to configure page, click on Next.

36. On the Configure Web Applications page, take the defaults and click Next.

37. On the Microsoft Internet Information Services (IIS) page, click Next.



39. Once the RightFax Setup is complete, click on Restart Now. The

RightFax Server will then restart.

40. Login to the RightFax Server and then verify that all of the RightFax Services are running.



Run Discovery of RightFax Server in SCOM

1. Login to SCOM, click on Administration, right-click on any item in

Administration Pane on the left hand side and click on Discovery Wizard… 2. Under Discovery Type, make sure Windows computers is selected and click

Next.

3. Click on Advanced Discovery and leave the Verify discovered computers

can be detected option unchecked.



4. Choose the option, Browse for, or type-in computer names and type in

the name of the RightFax Server and click Next.

5. Leave the option Use selected Management Server Action Account as is

and click on Discover.



6. Put a checkmark next to the name of the RightFax Server and click Next.

7. Leave the Summary defaults and click Finish.



8. The Agent Installation should finish in a few minutes. 9. Once the Host is reporting into SCOM make sure to Enable the Allow this agent

to act as a proxy and discover managed objects on other computers option under the Agent Managed section under Administration.

For the new RightFax Server to be picked up and start populating data into the

RightFax Views in SCOM could take some time depending on the size of your

environment.



Change Use NT Authentication Parameter for Performance Rules to “Yes” By default, all of the Performance Collection Rules for the Management Pack are

NOT going to use NT Authentication in order to retrieve the Performance Data from

the RightFax Server.

You MUST execute the “Deploy Infront RightFax MP SCOM Keys” from windows

computer view, override this task with “Enable NT Authentication” parameter with

“yes” to enabled NT Authentication and set the run as account with the

Windows NT credentials in SCOM, or leave it with “no”. This value will be

updated in the next discovery execution.

In RightFax you should be already set the Enable NT Authentication and Link

using the RightFax Enterprise Fax Manager Console.

Additionally, the ADMINISTRATOR password in RightFax by default is blank.

To use RightFax credentials in SCOM, you MUST ADD AS PASSWORD, otherwise this credential could not be created in SCOM.

Because we have not enabled this feature, we need to disable it for the following

RightFax Performance Collection Rules:

- RightFax Number of server events processed Collection Rule

- RightFax Number of pages received Collection Rule

- RightFax Queue Depth (pages) Collection Rule

- RightFax Documents queued for transmission Collection Rule

- RightFax Status records queued for transmission Collection Rule

- RightFax Queue Depth (faxes) Collection Rule

- RightFax Number of faxes received Collection Rule



- RightFax Percentage of disk space available on Image drive Collection Rule

- RightFax Number of pages sent Collection Rule

- RightFax Number of events in server queue Collection Rule

- RightFax Number of faxes sent Collection Rule

Within the next few minutes, you should start seeing performance data populate

into the RightFax Performance Counters (via COM API) Performance View

as all RightFax Performance Counters run every 5 minutes by default.