Professional Documents
Culture Documents
Agent Install
Revision 1
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.
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
Hardware Requirements
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.
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.
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.
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.
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
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
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.
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.
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.
Now click the “Select Manufacturer” button which will allow you to select which
manufacturers you wish to monitor.
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.
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.
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.
Click “Next”.
Now select where you want to install the agent, then click “Next”.
Click “Next”.
Now click “Close” to finish the install and run the agent test application.
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.
If you wish to use these ranges then click on “Yes”, then click “Close”.
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.
If the communication is fine then you will see the screen above.
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
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.
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.