background image

ver. 4.4 – © 2014 MMSOFT Design Ltd. 

www.pulseway.com 

 

 

 

 

 

 

 

Pulseway 

User Manual 

 

 

 

 

 

 

 

Summary of Contents for Pulseway

Page 1: ...ver 4 4 2014 MMSOFT Design Ltd www pulseway com Pulseway User Manual ...

Page 2: ...a new account 11 3 1 2 Validating Account 11 3 1 3 Recovering Account s Username 12 3 1 4 Recovering Account s Password 12 3 1 5 Changing Account s Password 13 3 2 Account Management 14 3 2 1 Account Details 14 3 2 2 Subscription Details 18 3 2 3 Managing Registered Computers 18 3 2 4 Managing Registered Devices 21 3 3 Computer Information 22 3 4 Dedicated Server 22 4 System Configuration 24 4 1 G...

Page 3: ...ent Protocol SNMP 53 6 Notification Settings 56 6 1 Status Notifications 56 6 2 Performance Notifications 57 6 3 Service Notifications 57 6 4 Process Notifications 58 6 5 Ping Notifications 58 6 6 Storage Notifications 58 6 6 1 Low Disk Space Notifications 59 6 6 2 File Change Notifications 59 6 7 Event Log Notifications 60 6 7 1 Exporting Event Log Notification s Configuration 60 6 7 2 Importing ...

Page 4: ...Plugins 71 9 Display Settings 72 10 Device Settings 73 11 Settings 74 11 1 Proxy Configuration 74 11 2 Runtime Configuration 74 11 3 Diagnostic Collection 75 11 4 Syslog Forwarding 76 11 5 PagerDuty Forwarding 77 11 6 ZenDesk Forwarding 78 12 Manager Security Lock 80 13 Exporting Configuration 81 14 Importing Configuration 82 15 Maintenance Mode 83 16 Unattended Installation 84 17 Support 85 ...

Page 5: ... and managing your computers using a securely encrypted mobile app that gives you total control of your systems from anywhere anytime This manual is made to guide the reader through the installation configuration and use process without the need for any background experience in the domain 1 Description ...

Page 6: ...ices Google Android based Mobile Devices Microsoft Windows Phone based Mobile Devices Blackberry based Mobile Devices Windows 8 Devices 2 1 Installing Pre requirements Microsoft Windows Operating Systems Pre requirements Microsoft NET Framework 4 0 http www microsoft com en us download details aspx id 17718 2 2 Installing on Microsoft Windows OS s Before you start downloading Pulseway you need to ...

Page 7: ...ppropriate version http www pulseway com downloads Pulseway for Mac After you have the dmg file in your computer double click on it and a license agreement will show up After you have read the license agreement and if you agree with it click on the Agree button and a window like this will show up Now you need to select the Pulseway icon from the left and drag it into the Applications folder the ic...

Page 8: ...ocess where you don t know what to type just leave the default value 2 6 Installing on RaspberryPi Raspbian Open up your terminal a ssh connection will work too and run the linux installer Then start the installation process Follow the instruction process where you don t know what to type just leave the default value 2 7 Installing on Apple Mobile Devices rpm Ivh http www pulseway com download pul...

Page 9: ...id based Mobile Devices To install Pulseway on your Android device open up the Market application and search for Pulseway The application is free of charge so you will be able to download it without having to pay for anything at all After the application description page opens tap to install it After a few seconds depending on your connection speed you will find Pulseway in your application list 2...

Page 10: ... Bring up the start menu with the Metro UI and click on the Microsoft Store icon then search for Pulseway Pulseway app should be among the first applications in the search results Once it s installed you will find Pulseway in your applications list ...

Page 11: ...not allow you to configure or start the service until you provide a valid account 3 1 1 Creating a new account In order to create a new account Pulseway requires you to input some personal information such as Name Company Country Email Address and Username This information is only used to identify you as the owner of your account and for billing purposes Read our Privacy Policy to learn more about...

Page 12: ...the right of the username field and you will be prompted for your email address that is associated with your account Your email address is requested to confirm account ownership After 5 minutes usually instantly you will receive an email containing your username 3 1 4 Recovering Account s Password If by any chance you forgot your password click the Reset Password link on the right of the password ...

Page 13: ... password to automatically update it to the new one After 5 minutes usually instantly you will receive an email containing your new password reset code that will be used to change your password and propagate the changes to your computers 3 1 5 Changing Account s Password If you would like to change your password click the Change Password button under the password field and the following window wil...

Page 14: ...sword to prevent unauthorized changes 3 2 1 Account Details From Account Details Management you can change your account information you inserted when you created your account and changing your notification settings Please note that the notification settings are global This means that if you disable push notifications all mobile devices will stop receiving push notifications 3 2 1 1 Modifying Accou...

Page 15: ...nager Access the registered devices from Pulseway Manager Access the Web Application 3 2 1 3 IP Restrictions IP Restrictions prevent unauthorized access to the Dashboard application and Web Application by adding authorized IP addresses to your account You can mix accesses to web application and dashboard using single IP addresses or even IP ranges 3 2 1 4 Associated Accounts Associating accounts g...

Page 16: ...ing accounts Monitor and control a machine and give your client access to see the status of their machine Share access to servers with all your technicians so that when a problem arises they will know Share a computer with a support technician in read only mode to look at the logs without actually having access to the computer itself To add an associated account just click on Add enter the person ...

Page 17: ...s A report contains values that are critical on understanding an ongoing situation or detecting new problems before they occur In order for Pulseway to start gathering report data you must agree with Report Privacy Policy and activate it from Account Details Current report types are Average CPU Usage Average Memory Usage Installed Software ...

Page 18: ...ns its display name the group OS version online status and the version of the Pulseway Agent Clicking on Remove Computer will remove the selected computer from your account and if the target is online the Pulseway agent will be instructed to remove the configuration 3 2 3 1 Changing Registered Computer s Configuration Changing a computer s configuration can be very useful if you don t have access ...

Page 19: ... in the group Group Policies is commonly used in enterprise environments to quickly configure new computers and to ease the configuration update process Once a Group Policy has been created all computers will automatically update their configuration based on the policy Also computers that are added in a group that has a policy will change its configuration according to the policy Note Both agents ...

Page 20: ...t decide if you would like to affect all computers or only a specific group After you select the group from the Manage Group Policies window you can choose to create a policy or to update if it already exists A policy setting has three states Checked Unchecked Undecided If a setting is Checked or Unchecked will be propagated to computers thus overwriting its value Leaving a setting as Undecided wi...

Page 21: ...t process from Manage Group Policies window by clicking the Import Policy button after you have selected an existing group An open dialog will show asking you to where is the exported file located 3 2 4 Managing Registered Devices The Registered Devices form lets you control the mobile devices that use your account You will get a list with all the devices that are registered on your account their ...

Page 22: ...t opens you will see a list of all the computers that are registered on your account From here you can set the Access for each computer and default access for new computers 3 3 Computer Information Computer Information keeps the identification settings for the specific computer Computer Name Group Name These settings will not affect your existing computer name and workgroup and will only be used t...

Page 23: ...Manual Page 23 of 85 This field will represent the hostname of your server however incorrectly changing this setting will result in loss of communication with the cloud servers and loss of the ability to view the device on mobile clients ...

Page 24: ...em features are System Commands Process Commands Event Log Browsing Hardware Sensors Wake on WAN Commands Screen View Webcam View Service Commands Network Monitoring Scheduled Task Commands Performance Counter Browsing File Browser 4 1 General Settings General System Settings controls which features will be available to the mobile device and their configuration 4 System Configuration ...

Page 25: ... cause data loss By default all System Commands are enabled however you get the option to customize their availability For example if you would like to allow only restart commands to be sent just uncheck all boxes except restart 4 1 2 System Command Force Attribute The force attribute forces the application to close so that you will know for sure that the system will execute your command This can ...

Page 26: ...know processes like system idle pulseway 4 1 4 Event Log Browsing Browsing through the event logs of an operating system is crucial to understand the current status of the hardware and software components Pulseway offers the ability to limits the amount of log entries per page in order to increase browsing speed and reduce bandwidth usage ...

Page 27: ...e On WAN requires A motherboard that supports Wake on Lan A wired network adapter that supports Wake on Lan Wake on Lan activate on BIOS Proper port forwarding if computer is behind a router firewall By default Wake on Lan is using UDP port 9 so if your computer is behind a router or a firewall you will need to forward that port More information can be found at www portforward com Note Tapping on ...

Page 28: ...its user to view the screen of any user session extremely useful for terminal servers where multiple user sessions are used This feature requires an active subscription to be activated Trial users cannot use Screen View Note You need to have Pulseway User Agent Chapter 11 2 enabled in order to use User Chat ...

Page 29: ...dministrators to engage on a live chat with any user session on the monitored computer One or more administrators starts the chat session from the mobile client and then the user will notice a chat window on their desktop During the chat session the administrator has the option to close the chat thus disabling user s message sending ability Note You need to have Pulseway User Agent Chapter 11 2 en...

Page 30: ...ment tools an administrator can quickly identify and resolve even complex problems with ease while on the go using just the mobile clients 4 2 Service Monitoring Service Monitoring gives you the ability of viewing the status of monitored services getting notified when a service is stopped and the ability to start stop monitored services Note You need to have Pulseway User Agent Chapter 11 2 enable...

Page 31: ...Network Monitoring Network monitor consists in three important parts Network Interface Monitoring Port Monitoring Performance Monitoring 4 3 1 Network Interface Monitoring Network interface monitoring gives you details about current traffic and its configuration ...

Page 32: ... Configuration Pulseway User Manual Page 32 of 85 4 3 2 Port Monitoring Keeping under control your opened ports can indicate a lot of problems such as network overflow service failure or even server downtime ...

Page 33: ...System Configuration Pulseway User Manual Page 33 of 85 Port Monitoring supports Local and Remote TCP ports Local UDP ports ...

Page 34: ...on Pulseway User Manual Page 34 of 85 4 3 3 Performance Monitoring Performance Monitoring gives you a hint on the ping of your monitored IP This can help you understand if your network is being overloaded at that moment ...

Page 35: ...y User Manual Page 35 of 85 4 4 Scheduled Task Monitoring Scheduled Tasks are crucial for a stable backup system for most scenarios having the ability to monitor and fire them from a mobile client just makes them even more useful ...

Page 36: ...Performance Counter Monitoring Counters are used to provide information as to how well the operating system or an application service or driver is performing The counter data can help determine system bottlenecks and fine tune system and application performance ...

Page 37: ...he following fields Server Name Hostname of the server Port Port of the service you wish to monitor You will be informed when A certificate has expired is no longer trusted revoked or has become invalid A certificate will expire soon The certificate is valid however does not secure the identify of specified host 4 6 2 Web Sites Monitoring Sometimes port and service monitoring is not enough to moni...

Page 38: ...g fields Name A friendly name for the website that will be displayed on the device URL Target URL that will be tested URL must contain the protocol Method HEAD or GET 4 7 File Browser Configuration File Browser allows you to view the directory file structure of the target computer preview files and if configured email them ...

Page 39: ...r mailbox 4 8 Maintenance Schedule If you have Scheduled Maintenance on your servers you can use this feature enabled Maintenance Mode Chapter 15 To schedule maintenance for a specific Monday at 10PM you need to click on the white block on the Monday row and the 20 column If your Maintenance happens Saturday and Sunday from 10PM to 3AM your schedule should look like this ...

Page 40: ...Configuration Pulseway User Manual Page 40 of 85 Legend A filled block means that Maintenance Schedule is active during select hour An empty block means that Maintenance Schedule is inactive during select hour ...

Page 41: ... SCOM Microsoft SQL Server Windows Server Backup VMware vSphere Server Citrix XenServer Amazon Web Services Windows Azure Simple Network Management Protocol SNMP 5 1 Active Directory AD A lot of companies that use Active Directory are having trouble managing it Pulseway is here to help you overcome the problem To enable Active Directory monitoring just enable it from the Server Modules tab in the ...

Page 42: ...e settings if the server is not locally installed you can monitor a remote one Note If Require users to change their password at next logon after a password reset is checked note that after each password reset of a user via Pulseway the user s password will be marked to be changed at next logon Until the user changes the password Windows Server by design denies any security logins to Windows Share...

Page 43: ... Hyper V Server is Microsoft s virtualization technology that is embedded into Microsoft Windows Server 2008 and above It provides quick and easy access to virtualization configuration and parameters right from the Server Manager To control the Hyper V server just enable its server module ...

Page 44: ...erver Modules Pulseway User Manual Page 44 of 85 5 4 Internet Information Server IIS Internet Information Server is Microsoft s Web Server It supports all popular technologies including html php asp aspx ...

Page 45: ...ment you need to copy the SDK Software Development Kit from the Management Group Server to your Pulseway installation directory You can find the SDK assemblies at ProgramFiles System Center 2012 Operations Manager Server SDK Binaries Required assemblies Microsoft EnterpriseManagement Core dll Microsoft EnterpriseManagement Runtime dll Microsoft EnterpriseManagement OperationsManager dll Connection...

Page 46: ...main Username User with access to the SCOM Console Password The password for the user 5 6 Microsoft SQL Server Microsoft SQL Server is one of the most popular database servers available on the market With Pulseway you can view the table data execute queries view logs and much more ...

Page 47: ...rver Backup and Windows Server Backup Command Line Tools features installed Windows PowerShell User in Backup Operators or Administrators user group configured in Pulseway Manager at PowerShell impersonation Installing Windows Server Backup Command Line Tools Feature Install Windows Server Backup Command Line Tools by starting up ServerManager right clicking on Features on the left side of the scr...

Page 48: ...alled and configure you can test Windows Server Backup configuration by clicking on the Validate Requirements and Settings button 5 8 VMware vSphere Server Pulseway supports VMware ESXi and vCenter To enable the server module just type in your server IP username and password ...

Page 49: ...trix XenServer Citrix XenServer is a free hypervisor from Citrix Systems Just like VMware vSphere Xen Server allows you to create multiple virtualized environments and make use of enterprise ready features like vApps Snapshots High Availability and many more ...

Page 50: ...lso called web services that together make up a cloud computing platform offered over the Internet by Amazon com The most central and well known of these services are Amazon EC2 and Amazon S3 The service is advertised as providing a large computing capacity potentially many servers much faster and cheaper than building a physical server farm ...

Page 51: ...he Access Key Field to show the Secret Access Key Copy your Secret Access Key into Pulseway Manager and click on Test Connection to verify it 5 11 Windows Azure Windows Azure is a cloud computing platform and infrastructure created by Microsoft for building deploying and managing applications and services through a global network of Microsoft managed datacenters It provides both platform as a serv...

Page 52: ...he name is a friendly label to help you identify monitored subscriptions Type or paste your Windows Azure Subscription ID Generate or Load an existing Management Certificate Locating your Windows Azure Subscription ID Go to https manage windowsazure com Workspace AdminTasks ListUsers Login using your Administrator s or delegated Administrator live account Copy Subscription ID that s associated wit...

Page 53: ...rtificate file Click on OK 5 12 Simple Network Management Protocol SNMP Simple Network Management Protocol SNMP is an Internet standard protocol for managing devices on IP networks Devices that typically support SNMP include routers switches servers workstations printers modem racks and more It is used mostly in network management systems to monitor network attached devices for conditions that war...

Page 54: ... inside the Variables tab In order to correctly identify each of the variable s type and usage you need to consult the SNMP MIB Reference Guide released by the vendor of the agent The MIB Document contains information regarding each variable exposed by the SNMP agent It is possible to manually write the variable Oid Object identifier or using the crawl button in the Add Variable dialog feature ...

Page 55: ...t which variables you would like to be displayed on the mobile devices Inside the Notifications tab in Pulseway Manager Server Modules sub tab in SNMP sub tab you can configure notifications for monitored SNMP variables Note Choosing not to display a variable does not affect the ability to get notifications for that variable ...

Page 56: ... can use the Send a test notification to all devices button to test your notification delivery method and the end devices 6 1 Status Notifications Status notifications are Offline notification Online notification Shutting down notification Entering a suspended state notification Resumed a suspended state notification Battery low notification User logged in notification User logged out notification...

Page 57: ... performance service downtime free memory bellow required threshold processor usage below or above normal values or port is detected as closed 6 3 Service Notifications Service notifications can be configured to only notify a specific service out of the full monitored services list The notification timer is defaulted to send notifications after one minute of the service status change Note You will...

Page 58: ...ble for configurable minute s 6 5 Ping Notifications Monitoring ping replies is very useful to know when your network becomes unresponsive or overloaded The first field represents the IP address or hostname FQDN of the target computer device The Alias short part of hostname of the computer device 6 6 Storage Notifications Pulseway supports Low Disk Space Notifications Note All process notification...

Page 59: ... using a percentile value or a fixed amount of megabytes 1 gigabyte is 1024 megabytes Priority field controls the priority of the low disk space notification 6 6 2 File Change Notifications File notifications allows monitoring a file or folder for changes When configured you may receive a notification for the following file changes Last Write Date Last Access Date File Security File Size File Name...

Page 60: ...that can be used all at the same time 6 7 1 Exporting Event Log Notification s Configuration If you would like to use the same configuration for your event log monitoring you can export only the event log monitoring configuration to a file and import it back to all your computers 6 7 2 Importing Event Log s Notification s Configuration Importing Event Log notification s configuration requires the ...

Page 61: ... that you either are running Pulseway inside a virtualized environment or your hardware is not yet supported We are constantly upgrading our supported hardware so check frequently for upgrades or ask on our forums to see if anyone else is having a similar problem with their hardware 6 9 Performance Counter Notifications Performances counters provide you an easy access to complex parameters of your...

Page 62: ...counter notification s settings can be useful if you would like to apply the same configuration to multiple devices Just export your settings in files and import them into as many computers as you need 6 9 2 Importing Performance Counter Notification s Settings To import performance counter notification s settings you will need to provide a valid path and to make sure that the local user has read ...

Page 63: ...ve server modules 6 11 1 Active Directory Also in the Active Directory tab you can choose to be notified whenever an active directory user gets locked out 6 11 2 Microsoft Exchange Server Exchange server module can send notifications for the following conditions Database gets Mounted Dismounted Message Queue exceeds preconfigured limit Mailbox size exceeds preconfigured limit To add a monitored ma...

Page 64: ...cation pool is stopped for more than five minutes 6 11 4 SCOM SCOM module can notify whenever an alert triggers or reaches warning state 6 11 5 Windows Backup Windows Server Backup module can notify whenever a backup operation has failed or completed successfully 6 11 6 VMware Note When possible Pulseway will automatically fill in the required values ...

Page 65: ...otification when alarms get triggered 6 11 8 SNMP SNMP tab contains a list of notification rules for monitored SNMP Variables To configure SNMP notifications you must first add a SNMP agent and the variables that you are interested in Consult the MIB Document released by the device s or software s vendor to get an accurate information of each variable s purpose Note The check for triggered alarms ...

Page 66: ...on Add button select a variable from the monitored variables list by pressing the button and double clicking or selecting a variable and pressing OK input variable s type and choose a notification condition Note You may have more than one notification rule for one SNMP variable ...

Page 67: ...lue Service status and Time of day and the only action supported is starting scheduled tasks So let s create a rule that will run FixDNSClient Scheduled task if my DNSClientservice is stopped You can add any Logical condition if you only add one value for it And for actions we instructed Pulseway to fire our scheduled task 7 2 Exporting Rules Rules can become troublesome configuring on a lot of ma...

Page 68: ...g Rules After you have exported your rules into a file copy it at some accessible path make sure your user has read permissions on the file and click Import from the Rules tab on the Pulseway Manager You will be prompted to choose which rules you would like to import ...

Page 69: ...le device 8 1 Installing Plugins To install plugins you must first have them in your computer Our community is a great place to start looking for them After you have downloaded a plugin extract it and read its installation notes Most plugins only require you to install them however some require extra configuration For this example we chose Power of the Shell plugin released by Cptrico Extract the ...

Page 70: ...ger click on the Plugins tab and click on Add Point to the PowerOfTheShell dll file and click Ok On the next window make sure that PowerOfTheShell is selected and click Ok 8 2 Configuring Plugins After you have installed your plugin click on it from the Pulseway s Manager Plugins tab and then select Configure from the right Then configure the plugin with your Impersonation details ...

Page 71: ...ugins If you are interested in creating your own plugins we have some tutorials for each type of implementation needs Click here to visit our API page Please note that we do not offer API level support If you require API level support feel free to ask at our community here ...

Page 72: ...ble features you can restrict some fields to be shown on mobile clients By default all configured modules will automatically show up on your device however there are situations when you would like to prevent this without changing any configuration such as maintenance 9 Display Settings ...

Page 73: ...s Policies you can set another layer of security by specifically allowing only a list of pre approved devices to control your computer regardless of any policies set for the computer or device Click on Authorize New Device to add devices the authorized devices list 10 Device Settings ...

Page 74: ... a server a computer system or an application that acts as an intermediary for requests from clients seeking resources from other servers If your internet connection relies on such connection then you must configure it here If you are unsure what to do contact your network administrator 11 2 Runtime Configuration Runtime configuration covers settings for Pulseway s core modules Auto Updater Perfor...

Page 75: ...tion will run PowerShell commands as the user configured Compile the domain box only if your computer is part of a domain 11 3 Diagnostic Collection Enabling Diagnostic Logging will force Pulseway s modules and plugins to write debugging logs to a file called trace txt This is something you don t want to enable on a production environment as it slows down Pulseway s services Developers use this fe...

Page 76: ...r Manual Page 76 of 85 11 4 Syslog Forwarding Syslog is a standard for computer data logging It separates the software that generates messages from the system that stores them and the software that reports and analyzes them ...

Page 77: ...eams It collects alerts from your monitoring tools gives you an overall view of all of your monitoring alarms and alerts an on duty engineer if there s a problem In order to be able to forward notifications to PagerDuty you must have a service key Steps on creating a PagerDuty service 1 Log into your PagerDuty dashboard 2 Click on Services tab 3 From the right hand side of the screen click the Add...

Page 78: ...ervice support Zendesk Configuration Account Subdomain The subdomain assigned to your account It s the name you type before zendesk com Example If the console url would be pulseway zendesk com the subdomain is pulseway Email Email address you use to login to Zendesk console Authentication Type Select Password if you wish to quickly get Zendesk forwarding or go to Zendesk and get your API Token Set...

Page 79: ... sent to Zendesk Critical Elevated Normal or Low Getting a ZenDesk API Token 1 Login to Zendesk console usually companyname zendesk com 2 Go to Settings click the gear icon 3 Look for Channels section and click on API 4 Make sure that Token Access is enabled and copy your API Token then paste it into Pulseway Manager ...

Page 80: ...ettings To enable it click the lock in the lower left corner of the Pulseway Manager icon After the lock is activated every time you start Pulseway the entire configuration will be locked for changes To temporary or permanently disable the security lock just click the lock icon again insert the password and everything will unlock 12 Manager Security Lock ...

Page 81: ... fully configuring the current Pulseway installation After you are ready click on Export Settings link in the bottom on the screen You get to choose if you would like to include account details authorized mobile devices and proxy settings Also for security reasons you can encrypt the configuration file with a password that will be asked when you try to restore the configuration 13 Exporting Config...

Page 82: ...ave the exported configuration file in your computer or at an accessible path with read rights on the file and if you used one the encryption password at the export process Click on Import Settings from the lower side of the Pulseway Manager application to start the import process 14 Importing Configuration ...

Page 83: ...all switch for notifications When Maintenance Mode is enabled all notifications modules are disabled thus decreasing the load Pulseway inflicts on the computer so that the maintenance process will be a smooth one Note During Maintenance Mode s Activity no notifications email or push will be delivered ...

Page 84: ...the installation kit you must place it in a folder where it will be accessible by all the computers you wish to install it Now you must instruct all computers that you want to install the computer to run one of the following commands UNC_PATH Pulseway_xNN msi qn config FFF configpassword PPP Replace the following placeholders NN Architecture of the Operating System 86 or 64 FFF The UNC path for th...

Page 85: ...ote support for installation configuration and troubleshooting during normal office hours 9am 5pm BST Monday to Friday excluding public holidays Technical support requires the purchase of technical support incidents TSIs Enterprise servers have bundled TSIs Please contact your reseller for more information Support Email TS only support pulseway com Support Phone TS only 353 1 6190234 Sales Email s...

Reviews: