{ "info": { "author": "Fr\u00e9d\u00e9ric MOHIER", "author_email": "frederic.mohier@alignak.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)", "Natural Language :: English", "Programming Language :: Python", "Topic :: System :: Monitoring", "Topic :: System :: Systems Administration" ], "description": "Alignak checks package for Windows WMI\n======================================\n\n*Checks pack for monitoring hosts with Windows Management Instrumentation (WMI)*\n\n\n.. image:: https://badge.fury.io/py/alignak_checks_wmi.svg\n :target: https://badge.fury.io/py/alignak-checks-wmi\n :alt: Most recent PyPi version\n\n.. image:: https://img.shields.io/badge/IRC-%23alignak-1e72ff.svg?style=flat\n :target: http://webchat.freenode.net/?channels=%23alignak\n :alt: Join the chat #alignak on freenode.net\n\n.. image:: https://img.shields.io/badge/License-AGPL%20v3-blue.svg\n :target: http://www.gnu.org/licenses/agpl-3.0\n :alt: License AGPL v3\n\nInstallation\n------------\n\nThe installation of this checks pack will copy some configuration files in the Alignak default configuration directory (eg. */usr/local/etc/alignak*). The copied files are located in the default sub-directory used for the packs (eg. *arbiter/packs*).\n\nFrom PyPI\n~~~~~~~~~\nTo install the package from PyPI:\n::\n\n sudo pip install alignak-checks-wmi\n\n\nFrom source files\n~~~~~~~~~~~~~~~~~\nTo install the package from the source files:\n::\n\n git clone https://github.com/Alignak-monitoring-contrib/alignak-checks-wmi\n cd alignak-checks-wmi\n sudo pip install .\n\n**Note:** *using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)*\n\n\n\nDocumentation\n-------------\n\nConfiguration\n~~~~~~~~~~~~~\n\n**Note**: this pack embeds the ``wmic`` binary that is not always easy to find for Linux distributions :/\n\n\nThe embedded version of ``wmic`` is only compatible with Linux distros. For Unix (FreeBSD), you can simply install the wmic port:\n::\n\n pkg install wmi-client\n cd /var/cache/pkg/\n tar Jxvf wmi-client-1.3.16_1.txz\n # winexe and wmic scripts are available in /usr/local/bin/\n\nThe *check_wmi_plus.pl* script assumes that the executable *wmic* is installed in the Alignak plugins directory.\nEdit the *check_wmi_plus.conf* configuration file to change the *wmic* location if necessary. The variable to set is **$wmic_command**.\n\n**Note:** The files *check_wmi_plus.pl* and *check_wmi_plus.conf*, located in the */usr/local/var/libexec/alignak*, need some configuration. Edit them and search for the ALIGNAK keyword to find out what is to be configured and set according to your server.\n\nEdit the */usr/local/etc/alignak/arbiter/packs/resource.d/wmi.cfg* file and configure the domain name, user name and password allowed to access remotely to the monitored hosts WMI.\n::\n\n #-- Active Directory for WMI\n # Replace MYDOMAIN with your domain name or . for local user account\n $DOMAIN$=MYDOMAIN\n # Replace MYUSER with the WMI authorized user (domain or local user account)\n $DOMAINUSERSHORT$=MYUSER\n $DOMAINUSER$=$DOMAIN$\\\\$DOMAINUSERSHORT$\n # Replace MYPASSWORD with the WMI authorized user password\n $DOMAINPASSWORD$=MYPASSWORD\n\n\nInstall PERL dependencies for check_wmi_plus plugin\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nYou must install some PERL dependencies for the *check_wmi_plus.pl* script.\n\nOn some Linux distros, you can::\n\n su -\n apt-get install libnumber-format-perl\n apt-get install libconfig-inifiles-perl\n apt-get install libdatetime-perl\n\nOr you can use the PERL *cpan* utility::\n\n cpan install Config::IniFiles\n cpan install Number::Format\n cpan install DateTime\n\n\nMore information is available on `Check WMI Plus Web site`_.\n\n\nPrepare Windows host\n~~~~~~~~~~~~~~~~~~~~\nSome operations are necessary on the Windows monitored hosts if WMI remote access is not yet activated.\n\nCreate a user account:\n\n- username/password (example): alignak/alignak\n- member of following groups: Administrators, Remote DCOM users\n- Deactivate interactive login permissions (more secure)\n\nCheck that WMI and RPC services are started\n\nThe Windows Firewall must allow inbound trafic for:\n- Windows Firewall Remote Management (RPC)\n- Windows Management Instrumentation (DCOM-In)\n- Windows Management Instrumentation (WMI-In)\n\nThis page contains more information about remote WMI configuration: https://kb.op5.com/display/HOWTOs/Agentless+Monitoring+of+Windows+using+WMI\n\nTest remote WMI access with the plugins files:\n::\n\n # Basic wmic command ...\n $ /usr/local/var/libexec/alignak/wmic -U .\\\\alignak%alignak //192.168.0.20 'Select Caption From Win32_OperatingSystem'\n\n # Alignak plugin command ...\n $ /usr/local/var/libexe/alignak/check_wmi_plus.pl -H 192.168.0.20 -u \".\\\\alignak\" -p \"alignak\" -m checkdrivesize -a '.' -w 90 -c 95 -o 0 -3 1 --inidir=/usr/local/var/libexec/alignak\n\n\n**Note**: these commands assume that you created an *alignak* user account with *alignak* as a password.\n\nAs a default, WMI opens random TCP ports to communicate with the requesting customer. The Windows WMI service can be configured to use only one port as explained here:\nhttps://msdn.microsoft.com/en-us/library/bb219447(v=vs.85).aspx.\n\nAn abstract of this article::\n\n To set up a fixed port for WMI\n 1. Stop the WMI service by typing the command: net stop \"Windows Management Instrumentation\", or net stop winmgmt\n 2. At the command prompt, type: winmgmt -standalonehost\n 3. Restart the WMI service again in a new service host by typing: net start \"Windows Management Instrumentation\" or net start winmgmt\n 4. Establish a new port number for the WMI service by typing: netsh firewall add portopening TCP 24158 WMIFixedPort\n\n To undo any changes you make to WMI, type: winmgmt /sharedhost, then stop and start the winmgmt service again.\n\n\nAlignak configuration\n~~~~~~~~~~~~~~~~~~~~~\n\nYou simply have to tag the concerned hosts with the template `windows-wmi`.\n::\n\n define host{\n use windows-wmi\n host_name host_windows_wmi\n address 127.0.0.1\n }\n\nThe main `windows-wmi` template declares macros used to configure the launched checks. The default values of these macros listed hereunder can be overriden in each host configuration.\n::\n\n _DOMAIN $DOMAIN$\n _DOMAINUSERSHORT $DOMAINUSERSHORT$\n _DOMAINUSER $_HOSTDOMAIN$\\\\$_HOSTDOMAINUSERSHORT$\n _DOMAINPASSWORD $DOMAINPASSWORD$\n\n _WINDOWS_DISK_WARN 90\n _WINDOWS_DISK_CRIT 95\n _WINDOWS_EVENT_LOG_WARN 1\n _WINDOWS_EVENT_LOG_CRIT 2\n _WINDOWS_REBOOT_WARN 15min:\n _WINDOWS_REBOOT_CRIT 5min:\n _WINDOWS_MEM_WARN 80\n _WINDOWS_MEM_CRIT 90\n _WINDOWS_ALL_CPU_WARN 80\n _WINDOWS_ALL_CPU_CRIT 90\n _WINDOWS_CPU_WARN 80\n _WINDOWS_CPU_CRIT 90\n _WINDOWS_LOAD_WARN 10\n _WINDOWS_LOAD_CRIT 20\n _WINDOWS_NET_WARN 80\n _WINDOWS_NET_CRIT 90\n _WINDOWS_EXCLUDED_AUTO_SERVICES\n _WINDOWS_AUTO_SERVICES_WARN 0\n _WINDOWS_AUTO_SERVICES_CRIT 1\n _WINDOWS_BIG_PROCESSES_WARN 25\n\n #Default Network Interface\n _WINDOWS_NETWORK_INTERFACE Ethernet\n\n # Now some alert level for a windows host\n _WINDOWS_SHARE_WARN 90\n _WINDOWS_SHARE_CRIT 95\n\n\nTo set a specific value for an host, declare the same macro in the host definition file.\n::\n\n define host{\n use windows-wmi\n contact_groups admins\n host_name sim-vm\n address 192.168.0.16\n\n # Specific values for this host\n # Change warning and critical alerts level for memory\n # Same for CPU, ALL_CPU, DISK, LOAD, NET, ...\n _WINDOWS_MEM_WARN 10\n _WINDOWS_MEM_CRIT 20\n\n # Exclude some services from automatic start check\n # Use a regexp that matches against the short or long service name as it can be seen in the properties of the service in Windows.\n # The matching services are excluded in the resulting list.\n # Example: (ShortName)|(ShortName)| ... |(ShortName)\n _WINDOWS_EXCLUDED_AUTO_SERVICES (IAStorDataMgrSvc)|(MMCSS)|(ShellHWDetection)|(sppsvc)|(clr_optimization_v4.0.30319_32)\n }\n\n\nBugs, issues and contributing\n-----------------------------\n\nContributions to this project are welcome and encouraged ... `issues in the project repository `_ are the common way to raise an information.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Alignak-monitoring-contrib/alignak-checks-wmi", "keywords": "a,l,i,g,n,a,k, ,m,o,n,i,t,o,r,i,n,g, ,p,a,c,k, ,c,h,e,c,k,s, ,w,m,i", "license": "GNU Affero General Public License, version 3", "maintainer": "", "maintainer_email": "", "name": "alignak_checks_wmi", "package_url": "https://pypi.org/project/alignak_checks_wmi/", "platform": "", "project_url": "https://pypi.org/project/alignak_checks_wmi/", "project_urls": { "Homepage": "https://github.com/Alignak-monitoring-contrib/alignak-checks-wmi" }, "release_url": "https://pypi.org/project/alignak_checks_wmi/1.0.0/", "requires_dist": null, "requires_python": "", "summary": "Alignak checks pack for Windows Management Instrumentation", "version": "1.0.0" }, "last_serial": 3167362, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "05fb9db969a84d6b4faf32829f787e4d", "sha256": "34a62112902c450d69d85b34e7c72b292302f4abd67963d1b097cd49ba168842" }, "downloads": -1, "filename": "alignak_checks_wmi-0.1.0.tar.gz", "has_sig": false, "md5_digest": "05fb9db969a84d6b4faf32829f787e4d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 164538, "upload_time": "2015-11-22T11:49:29", "url": "https://files.pythonhosted.org/packages/da/94/f8196c67f40d523fe80b1793951ce11e14abd791135b806c7ce837d34fde/alignak_checks_wmi-0.1.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "ac28f74407f9c209ecd78f496b628142", "sha256": "18a4e071b3e764896f6a0187d9bedf5ca3874410dc34ea62236d3a7d63455dc7" }, "downloads": -1, "filename": "alignak_checks_wmi-0.2.1.tar.gz", "has_sig": false, "md5_digest": "ac28f74407f9c209ecd78f496b628142", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 169073, "upload_time": "2016-10-03T08:17:01", "url": "https://files.pythonhosted.org/packages/fb/69/76a214dd9847f419aa4b90268bcc11b1c6e648d0279191c5d75ebea92167/alignak_checks_wmi-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "f3637d9fc2b92c239780836d568ad696", "sha256": "b755b04eb46fb4ce26d597cc7dffa4d0662497278a6504d2b1a229eb5a288542" }, "downloads": -1, "filename": "alignak_checks_wmi-0.2.2.tar.gz", "has_sig": false, "md5_digest": "f3637d9fc2b92c239780836d568ad696", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3958271, "upload_time": "2016-10-03T18:44:36", "url": "https://files.pythonhosted.org/packages/a1/82/97398dfe07c4f8edaef99df7e6bf7b2c2a04ffb8bd6e6c0ee876654b9abb/alignak_checks_wmi-0.2.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "7661a28e563b3f2448a977c25705940f", "sha256": "39b604fced03e991b0f204d7b9d1407012ac9571b8b5cc29b28c66a9322aae32" }, "downloads": -1, "filename": "alignak_checks_wmi-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7661a28e563b3f2448a977c25705940f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3958206, "upload_time": "2017-01-05T06:25:21", "url": "https://files.pythonhosted.org/packages/66/82/868d69952c6e0a2c2bba0fc7840cd5272155572a55341c1bdc48b64a979e/alignak_checks_wmi-0.3.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "0dd6550f63f09c558de76a233bbeeca6", "sha256": "5032afade603b3654b6301b43fc477d170219f4eb2eb26eb0eeb64b308570a93" }, "downloads": -1, "filename": "alignak_checks_wmi-1.0.0.tar.gz", "has_sig": false, "md5_digest": "0dd6550f63f09c558de76a233bbeeca6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3958207, "upload_time": "2017-09-12T08:31:31", "url": "https://files.pythonhosted.org/packages/ff/fd/8101546a51fe8517a596c79bc5ec6f85e65fb332d602045fcea715fef3fb/alignak_checks_wmi-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0dd6550f63f09c558de76a233bbeeca6", "sha256": "5032afade603b3654b6301b43fc477d170219f4eb2eb26eb0eeb64b308570a93" }, "downloads": -1, "filename": "alignak_checks_wmi-1.0.0.tar.gz", "has_sig": false, "md5_digest": "0dd6550f63f09c558de76a233bbeeca6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3958207, "upload_time": "2017-09-12T08:31:31", "url": "https://files.pythonhosted.org/packages/ff/fd/8101546a51fe8517a596c79bc5ec6f85e65fb332d602045fcea715fef3fb/alignak_checks_wmi-1.0.0.tar.gz" } ] }