OneStop MPS Agent Install V1.42

OneStop MPS

Agent Install

Revision 1

Copyright © 2009 Business I.T. Systems Ltd www.bits.uk.com

http://www.bits.uk.com/

OneStop MPS Agent Install Revision 1.4.2 Copyright © 2010 Business I.T. Systems. All Rights Reserved. August 2010

Copyright Statement Copyright © 1999 – 2010 Business I.T. Systems Ltd Information contained in this document is the property of Business I.T. Systems Limited. This document should not be reproduced, in part or in full, without the prior written permission of Business I.T. Systems Ltd. Microsoft®, Windows®, and Windows Server®, are registered trademarks of THE Microsoft Corporation. MSFT information on trademarks can be found using the following link http://www.microsoft.com/library/toolbar/3.0/trademarks/en-us.mspx. Other products and companies referred to herein are trademarks or registered trademarks of their respective companies or mark holders.

http://www.microsoft.com/library/toolbar/3.0/trademarks/en-us.mspx

Page 2


OneStop MPS

Contents:

Hardware Requirements .........................................................................................................3 OneStop MPS Agent Service..............................................................................................3

Software Requirements ..........................................................................................................3 OneStop MPS Agent Service..............................................................................................3

Setting up OneStop MPS .......................................................................................................4 Group Settings ...................................................................................................................4

General tab .....................................................................................................................8 Scan Options tab ..........................................................................................................10 Import Options tab ........................................................................................................14

Installing the OneStop MPS Agent....................................................................................18 Known Issues ...............................................................................................................26

Page 3


Hardware Requirements

OneStop MPS Agent Service

The minimum hardware requirements for the OneStop MPS Agent Service software are:

Processor: 1.6 GHz+ processor

RAM: 1 GB+

Hard drive: 100 MB+ available hard disk space

NIC: 100/1000 BaseT

Able to ping all devices that are to be monitored

SNMP must be enabled on devices that are to be monitored

Internet Access to OneStop MPS server

Software Requirements

OneStop MPS Agent Service

The following software must be installed before the OneStop MPS Agent software.

• .Net Framework o .Net Framework 2.0 is required

It will also be necessary to have administrator rights to the Operating System to install the software.

Page 4


Setting up OneStop MPS

Group Settings The first thing that is required to use OneStop MPS is to set up your first group for which you are going to collect data.

Page 5


Now select the Add Child Group button.

You should then see a new screen.

Page 6


Now add the following details.

1. Group Name 2. Group Description 3. Branding

You can also select if you wish to copy settings from the parent group. Click on “Save” to complete the creation of the new group. Once you have created the new group go to the Group Filter menu and select the new group you have added.

Page 7


Page 8


General tab

The first screen you will now see is the General Tab, from here you can review the information you entered for this group and edit them if required.

Also there is a Copy Group Settings button which will allow you to copy settings from any other Group in the system.

Page 9


Page 10


Scan Options tab

The next tab is for the Scan Options.

Scan Schedules is where you set up where and how often you perform a Meter reading scan, click on “Add Scan Schedule” to add a new setting.

Page 11


First give the Scan schedule a name. The Schedule Type determines how often you wish to scan for Meter readings of the devices you are monitoring. First set Weekly or Monthly, Weekly will allow you to select which days of the week you will perform the scan and Monthly will allow you to select 1 day of the month you will perform the scan. Now set what time of the day you will perform the scan. Be aware that it would be wise to pick a time of the day when the devices are likely to be switched on. Next enter the IP addresses you wish to monitor, this can be done by clicking on either “Edit range addresses” or “Edit individual addresses”. If you wish to add an IP address range then enter the range in the following format. 192.168.1.1-192.168.1.254 10.0.0.1-10.0.4.254 192.168.101.55-192.168.101.76

Page 12


If you want to enter individual IP addresses then enter them one per line as shown below. 192.168.1.32 192.168.1.45 10.0.0.77 10.0.4.44 192.168.101.64 You can also enter host names instead of IP Addresses. The next scan option is the Status Scan which will check the current status of the devices. You can decide whether this is enabled or not and how often it will check the status in minutes. When the status scan is performed the OneStop agent will only check IP addresses of devices it has found in the Schedule scan. The next scan option is the Consumables Scan which will check the current consumable levels of the devices. You can decide whether this is enabled or not and how often it will check the status in minutes. When the consumables scan is performed the OneStop agent will only check IP addresses of devices it has found in the Schedule scan. Now the SNMP time out needs to be set, if you are scanning a multiple subnet network with WAN connections it may be necessary to set this figure higher than normal. SNMP community also may need to be changed if the network is not using the standard Public community. Please note that SNMP must be switched on for all devices you wish to monitor via OneStop MPS. Next we need to set a proxy server setting if the customer is using one. This is because the OneStop MPS agent uploads data through the internet via port 80 or port 443 if using SSL. The help of the IT department may be required for these settings. The Heart Beat setting is used to make sure there is constant communication between the OneStop MPS Agent and the OneStop MPS website (Server). If set to zero (0) then no Heart Beat will be sent but any other figure (X) used will send a heart beat message to the server every (X) minutes. The next setting on this tab is the Run in Test Mode setting, this will set the agent to collect information from the devices on the network but not upload them to the OneStop MPS server. This will allow the customer to view the files so that they can see what data is being collected. Next is a set of check boxes for updates to and from the collection agent. The first one is to allow updates from the collection agent when it is installed at the customer’s site. The second is for the agent to check for any updated configurations and download them automatically. The final check box is to allow the agent to be updated automatically. The final setting on the screen is for how often you want the agent to check for any updates in minutes. Once you have entered all of your settings for this group now click on the “Save Settings” button.

Page 13


Now you have saved the settings you will notice the 2 links at the bottom of the screen have been activated. These links will allow you to download the agent installer as an .msi or .zip file. This installer contains the collection agent and the config.xml file for the group you have just set up. If you wish to email a customer the links then just click the “Email Links” button and the following email will be produced.

Finally click on the “Retrieve config” file button and save the config.xml file to be used by the OneStop Agent Service.

Page 14


Import Options tab

This tab gives you the option to filter devices imported into the OneStop server.

The default setting is to Monitor all devices found, but this can be changed to not monitor any devices found or only monitor devices made by a specific Manufacturer. If you decide to filter the devices by manufacturer then select the “Monitor Devices From Selected Manufacturer” radio button.

Page 15


Now click the “Select Manufacturer” button which will allow you to select which manufacturers you wish to monitor.

Page 16


Once you have selected the manufacturers you wish to monitor click on the close button to save your settings. Also if you have purchased the survey license then you have the option to import devices using this function. This will monitor the devices for up to 45 days without using your normal licenses. The always update the device location tick box will update changes to the location field to the OneStop server if the location is change on the device. For Sharp devices you have the option to only use the first 8 digits of the serial number if you

wish. To use this option just tick the “Limit Sharp serial numbers to 8 characters” tick box and click on the Save Settings button.

Page 17


Page 18


Installing the OneStop MPS Agent Find a suitable PC or server to install the OneStop MPS Agent on, this normally would be the print server as it is able to communicate with most devices you wish to monitor and is on 24 hours a day. Next follow the instructions on how to add and configure a new Group in OneStop MPS Group Settings. Now that you have created your new group and saved the scan settings you can use one of the 2 links at the bottom on the page to download the OneStop MPS collection agent. Once the agent is downloaded you can run the msi file to install the agent.

Note: If you are installing the agent on Windows 2008 server, Vista or Windows 7 then you

must run the MSI as an administrator. To achieve this you will have to run the “Command Prompt” as an administrator as shown below.

Depending on what the security settings are you will get some warning messages, please answer “yes” to these messages. Now change directory to where you have downloaded and saved the MSI file.

Page 19


To run the MSI just type the full name of the file and press enter.

This completes the additional steps required to install on Windows 2008 server, Vista or Windows 7.

Page 20


Click “Next”.

Now select where you want to install the agent, then click “Next”.

Page 21


Click “Next”.

Page 22


Now click “Close” to finish the install and run the agent test application.

Page 23


The test application will now list all available networks that it can scan for devices.

If you have not set any IP address ranges you can use this tool to discover any devices you wish to monitor. If you wish to start the discovery then click “Yes”, but if you wish to enter the IP address ranges manually then click “No”. If you click “Yes” then you will see the following screen.

If the tool was unable to discover any devices then the next screen will be shown.

Now Click “OK” and then “Close”.

Page 24


If devices where discovered then the following screen will be shown.

If you wish to use these ranges then click on “Yes”, then click “Close”. You should now see a screen similar to below.

Now you should see the IP address range discovered by the test tool entered above. At this time you can add further IP Address ranges if needed. You will also see that you can add individual IP addresses if required. If you add further IP addresses or ranges you can test these by Clicking on the “Test Scan Settings” button. Now use the “Test Connection to OneStop Server” button to make sure you can communicate with the OneStop Server.

Page 25


If the communication is fine then you will see the screen above. If there is a problem then the follow screen will be displayed.

If this occurs then check the log by clicking on the “View Log” button.

This hopefully should tell you why you cannot communicate with the OneStop MPS server. One of the reasons that you unable to communicate with the OneStop MPS server is that you need to enter the Proxy server settings. These can be entered into the test tool along with a username and password for the proxy server. Once you have entered the correct proxy settings then run the communication test again. If you are still having problems with communication this maybe down to the firewall settings on the network blocking access to the OneStop MPS server. In the test application you will see a URL for the OneStop MPS

Page 26


server (http://62.49.120.60/OneStopImporter), give this to the IT department who should then be able to unblock access to the server. Once communication has been confirmed click on the “Save Settings” button to save all setting locally to the config.xml file and to the OneStop server if allowed. Once you have saved the settings you can now close the test application by clicking on the red X in the top right hand corner.

You will now be asked if you wish to start the OneStop Collection Agent Service, click on “Yes” to continue. Now the agent is installed and running, so within a short period of time you will see a “DiscoveredDevices.csv” appear in the folder where the agent is installed.

Once this file has appeared logon to the OneStop server web site and you should see the new devices for this group appear.

Known Issues

1. One issue you may come across is that the OneStop MPS server URL is being

blocked either by the proxy, ISA server or firewall. The URL that the OneStop MPS Agent uses to upload the files can be located in the Config.xml file and looks like this –

<OneStopServer>http://78.136.28.91/OneStopImporter</OneStopServer> Just give this to the network administrator and they should be able to open this link to the OneStop service.

Page 27


2. We have seen an issue where the OneStop agent stops scanning the network when

it comes across a Watch Guard Server. To get round this issue just set your IP Address range to avoid this server.

3. Make sure you are using the correct Proxy server settings. These can usually be found in the set up for your web browser. You will also need to make sure you have a user name and password for the Proxy server as well. In some cases it has been necessary to run the OneStop services under the username and password for the proxy instead of the local system account.

Documents

OneStop MPS Agent Install V1.42