{ "info": { "author": "Mike Timm", "author_email": "mtimm@cisco.com", "bugtrack_url": null, "classifiers": [], "description": "==========\nAryaLogger\n==========\n\nUse the SimpleAciUiLogServer and arya to convert UI REST API calls to ACI\nPython SDK code.\n\nInstall\n-------\n\nInstallation of AryaLogger depends on several other modules that are not part\nof the Python standard library. Here is a basic list of those modules:\n\n1. acicobra - Not yet available on Pypi\n2. arya - available on Pypi\n3. SimpleAciUiLogServer - available on Pypi\n\nInstalling Dependancies\n+++++++++++++++++++++++\n\nThe difficult dependancy at this point is acicobra as it is not on Pypi yet.\n\nInstalling acicobra\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\nIf you have at least APIC version 1.0(3f) installed on your APIC, installation\nof acicobra can be done by simply pointing pip at your APIC's cobra/_downloads\ndirectory using the --find-links option using one of these two commands:\n\n easy_install -Z --find-links http://apic/cobra/_downloads acicobra\n\nOr:\n\n easy_install -Z --find-links https://apic/cobra/_downloads acicobra\n\nIf your APIC has http disabled (the default), you must either use https or\nenable http on the APIC. Note: As of the 1.1(1j) version of the APIC,\nTLSv1 has been disabled by default on the APIC for HTTPS. So if you are\nusing HTTPS and your python install uses an older openssl that does not\nsupport TLSv1_1 or TLSv1_2 you may have issues handshaking with the APIC\nGUI. This is especially the case on the default installation of python on\nMacOSX which usually utilizes the default installation of openssl which is\nextremely old. Generally speaking, one should not be using such an old\nversion of openssl. Homebrew may be your best bet.\n\nIf you have an older version of software on your APIC, you can either download\nacicobra from the Cisco.com software download site (APIC specific contract\nrequired to be tied to the Cisco.com id doing the download) or you can download\nthe acicobra egg from the APIC itself and rename it:\n\n https://developer.cisco.com/media/apicDcPythonAPI_v0.1/install.html\n\nInstalling arya\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\nInstalling arya from pypi is as simple as using pip:\n\n pip install arya\n\nInstalling AryaLogger\n+++++++++++++++++++++\n\nAryaLogger is available on pypi so installation is fairly straight forward:\n\n pip install AryaLogger\n\nThis should also pull in SimpleAciUiLogServer if you don't have it installed\nalready.\n\nRun AryaLogger\n--------------\n\nThere are two possible commands to run AryaLogger on your system. You only need\nto run one of these commands:\n\n aryalogger\n\nOr:\n\n AryaLogger\n\nThere are additional options available that can be seen via the -h option:\n\n * -h: Help\n * -a/--apicip: The ip address or hostname of an APIC to help resolve which\n ip address to print when showing the server is started.\n * -po/--port: The port for the HTTP server to listen on - default is 8987\n * -l/--location: The URI path to listen for - default is apiinspector\n * -s/--sslport: The port for the HTTPS server to listen on - default is\n 8443\n * -c/--cert: The certificate file to use for TLS/SSL negotiation.\n * -e/--exclude: There are three types of queries the GUI doe constantly\n to keep the session up or to request information to update the GUI. This\n option allows you to selectively exlude these queries from the output.\n options are: \n\n - subscriptionRefresh - Refreshes a subscription request for the GUI.\n - aaaRefresh - Refreshes the GUI connection to the APIC.\n - topInfo - Retrieves basic info from the APIC to update the GUI.\n\n * -r/--logrequests: Log the HTTP request along with the CobraSDK code.\n * -n/--nice-output: Pretty print any XML or JSON (has no affect currently\n in AryaLogger)\n * -i/--indent: The number of spaces to indent when pretty printing (has\n no affect currently in AryaLogger)\n\nFor HTTPS, AryaLogger does come with a default certificate file but it should\nnot be used for production. Instead you should create your own certificate file\nusing openssl and pass it to the server:\n\n openssl req -new -x509 -keyout server.pem -out server.pem -days 36500 -nodes\n\nPass it in to AryaLogger using the -c/--cert option.\n\nSetup your APIC\n---------------\n\nSetting up your APIC to send log messages to AryaLogger is very simple as well.\nWhen you run AryaLogger it will output the addresses and ports it is listening\nto:\n\n $ aryalogger\n serving at:\n http://10.1.1.100:8987/apiinspector\n https://10.1.1.100:8443/apiinspector\n\nIf you are going to be using the https address to access the AryaLogger server,\nbe sure to browse to the https address printed out by the server when it starts\nso that you can accept the certificate exception.\n\nIf you connect to the APIC graphical user interface (GUI) via http, take note of\nthe http URL otherwise if you connect to the GUI using https take note of\nthe https URL.\n\nUse this URL in the 'Start Remote Logging' pop-up that is available from the \n'Welcome' menu at the top right of the GUI.\n\nOnce you have started remote logging to the URL provided by AryaLogger, when you\nclick around the APIC GUI you should see auto generated Cobra SDK code from\nAryaLogger.\n\nProblems & Issues\n-----------------\n\nThe most common problem seen when running AryaLogger is that the AryaLogger\nserver starts, remote logging is setup on the APIC but then no data is seen\never being transferred to the server. This can be caused by many things but\nthe most common is that a security exception has not been accepted for the http\ncertificate. This can be resolved by connecting to the AryaLogger https\naddress from your browser and accepting the security exception for the server\ncertificate. The second most common issue is that there is a firewall running\non the host that the AryaLogger server is running on. We have even seen hosts\nwith multiple firewalls running when the end user had no idea.\n\nThe simplest form of troubleshooting involves going into the same browser\ntab that the APIC is connected to with and opening the developer tools in\nyour browser. Look at the javascript console and see if any errors are being\nprinted about communication to the host the AryaLogger is running on.\n\nIf you run into issues please feel free to open an issue on github.", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/datacenter/AryaLogger/releases/tag/v1.1.7", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/datacenter/AryaLogger", "keywords": null, "license": "AryaLogger\n\nMike Timm - mtimm@cisco.com\n\nCopyright (C) 2014 Cisco Systems Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.", "maintainer": null, "maintainer_email": null, "name": "AryaLogger", "package_url": "https://pypi.org/project/AryaLogger/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/AryaLogger/", "project_urls": { "Download": "https://github.com/datacenter/AryaLogger/releases/tag/v1.1.7", "Homepage": "https://github.com/datacenter/AryaLogger" }, "release_url": "https://pypi.org/project/AryaLogger/v1.1.7/", "requires_dist": null, "requires_python": null, "summary": "Use the SimpleAciUiLogServer and arya to convert UI REST API calls to ACI Python SDK code.", "version": "v1.1.7" }, "last_serial": 1679775, "releases": { "1.1.0": [ { "comment_text": "", "digests": { "md5": "f9a1e3deee27f0850d1ad3a280399e23", "sha256": "23515ac50b24b585dd41bd60694917adcca744d9654bdae3923d2fb11cb09dfc" }, "downloads": -1, "filename": "AryaLogger-1.1.0.tar.gz", "has_sig": false, "md5_digest": "f9a1e3deee27f0850d1ad3a280399e23", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9785, "upload_time": "2015-03-09T22:03:16", "url": "https://files.pythonhosted.org/packages/1c/95/4647e934331a45b6f0531de0d5ade27b81986d35e172b4ef1179cd6ecf54/AryaLogger-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "f01edc5f3d174795668336bdc966595f", "sha256": "7a6c685e347e6f5423856bf1870817dd72255322349751c0735f062691bcd164" }, "downloads": -1, "filename": "AryaLogger-1.1.1.tar.gz", "has_sig": false, "md5_digest": "f01edc5f3d174795668336bdc966595f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9797, "upload_time": "2015-03-09T22:28:37", "url": "https://files.pythonhosted.org/packages/24/57/3e201f40d9358fbff3e80a783c763ee15311b95a882b05ceef25de3cc7f4/AryaLogger-1.1.1.tar.gz" } ], "1.1.2": [ { "comment_text": "", "digests": { "md5": "837ba82832f4e27ebecca386977a7af9", "sha256": "173cfb27a6b1e02662f90a0223fcf4bfbd2a7cbe673453c748e843a485872dfc" }, "downloads": -1, "filename": "AryaLogger-1.1.2.tar.gz", "has_sig": false, "md5_digest": "837ba82832f4e27ebecca386977a7af9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9865, "upload_time": "2015-03-09T23:35:32", "url": "https://files.pythonhosted.org/packages/fa/46/8a04d3ea2238cafd4970010f9d0db876bcc09671f8524ef26f4f2d4c5c0c/AryaLogger-1.1.2.tar.gz" } ], "1.1.3": [ { "comment_text": "", "digests": { "md5": "7c961812754060d107a2c692a253c259", "sha256": "d69c16b0d6cd3d800e6d3c18c300b09f46e369a02a06088ebcfaaadcf20ef549" }, "downloads": -1, "filename": "AryaLogger-1.1.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "7c961812754060d107a2c692a253c259", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 20446, "upload_time": "2015-03-14T22:00:15", "url": "https://files.pythonhosted.org/packages/42/0a/c12abccc13ec5216385c07759addd5232082d1198aef642068664fdda578/AryaLogger-1.1.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "116cbc7977d8fc4638b680db8293a32e", "sha256": "93940da5c4cd123186a01a67029418349e1b4f2ec8d5c5b7b415be6fe5c7d199" }, "downloads": -1, "filename": "AryaLogger-1.1.3.tar.gz", "has_sig": false, "md5_digest": "116cbc7977d8fc4638b680db8293a32e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9991, "upload_time": "2015-03-14T21:58:18", "url": "https://files.pythonhosted.org/packages/00/c7/f428cf4a36b14e864b6972b3613e4689a11fdc5e2dc84ce73434b002ebaf/AryaLogger-1.1.3.tar.gz" } ], "1.1.4": [ { "comment_text": "", "digests": { "md5": "d81f7808d3113ebe8350bb6c8095c4e2", "sha256": "6374a62b20de507e51ca2ab615d6a2c6bbd1ab3a2c25e1fde7b5f6f89570dc1a" }, "downloads": -1, "filename": "AryaLogger-1.1.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d81f7808d3113ebe8350bb6c8095c4e2", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 21126, "upload_time": "2015-03-20T20:34:37", "url": "https://files.pythonhosted.org/packages/1b/01/d435cb73e902c5684b403f04b03b79dd958bb8b796050c21071f2f159b2f/AryaLogger-1.1.4-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ea63dafc38cc078581bfcf4ed7c49c91", "sha256": "209e3cd8b845fefcad94fca4677b984fa09a321d6a32e4962027942938e93d08" }, "downloads": -1, "filename": "AryaLogger-1.1.4.tar.gz", "has_sig": false, "md5_digest": "ea63dafc38cc078581bfcf4ed7c49c91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10464, "upload_time": "2015-03-20T20:34:16", "url": "https://files.pythonhosted.org/packages/72/1b/dd23ba427490846baf716adccd9e9138dda63022c49740cf533a5a45fd04/AryaLogger-1.1.4.tar.gz" } ], "1.1.5": [ { "comment_text": "", "digests": { "md5": "a35b2e48d38906f45051a2e37c977e7d", "sha256": "755be6ec8a23d0f760c94ea48c32dc5dcdd8ea8603238fcb3ff893c224cba7f9" }, "downloads": -1, "filename": "AryaLogger-1.1.5-py2.7.egg", "has_sig": false, "md5_digest": "a35b2e48d38906f45051a2e37c977e7d", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 29455, "upload_time": "2015-07-16T21:57:20", "url": "https://files.pythonhosted.org/packages/09/49/5cfb3599d4fc390d5b38499af238349c1b4a788003ff5b573a844e8484d1/AryaLogger-1.1.5-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "d9419f5e322316d9dd837e47a56f95b0", "sha256": "7cb45bf71cfd3e52661b4dcef828eed9e179677c302001b3d26a5c256015ac72" }, "downloads": -1, "filename": "AryaLogger-1.1.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d9419f5e322316d9dd837e47a56f95b0", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 22586, "upload_time": "2015-07-16T21:54:20", "url": "https://files.pythonhosted.org/packages/52/af/5c36517c9c4129724242ac9d2972d7a86fe6e8d9273b783eb1325e0c811d/AryaLogger-1.1.5-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ae1a913b497b54d3d9b441be9e4674ce", "sha256": "577fc0000adc18dcc9f36840b4a697a9572fc23a3f4ee1dd4cdebc883191cd6d" }, "downloads": -1, "filename": "AryaLogger-1.1.5.tar.gz", "has_sig": false, "md5_digest": "ae1a913b497b54d3d9b441be9e4674ce", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11187, "upload_time": "2015-07-16T21:54:09", "url": "https://files.pythonhosted.org/packages/34/25/09750a08f31a31f4bdfca32e10b6cc4c5ba21be5d36d73e87a769f57d006/AryaLogger-1.1.5.tar.gz" } ], "1.1.6": [ { "comment_text": "", "digests": { "md5": "2622433fa9f0e0bbece832a0a7ef7065", "sha256": "b64e1ad73cb961d8379c4d09113c4848fe8c5015489f6c12c4a608ae82c8a5d4" }, "downloads": -1, "filename": "AryaLogger-1.1.6-py2.7.egg", "has_sig": false, "md5_digest": "2622433fa9f0e0bbece832a0a7ef7065", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 29587, "upload_time": "2015-08-10T18:00:05", "url": "https://files.pythonhosted.org/packages/4c/75/92bf335183981ed873f59e02dbaf13b408dba50e78b5a056c4b7deadac46/AryaLogger-1.1.6-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "d82e86975db3b363f3076843ab2e5083", "sha256": "b104b369b171316704f125744b0b57ef9c9ad30ecbd0bfc1f1a72bd9f290a043" }, "downloads": -1, "filename": "AryaLogger-1.1.6.tar.gz", "has_sig": false, "md5_digest": "d82e86975db3b363f3076843ab2e5083", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11241, "upload_time": "2015-08-10T17:59:54", "url": "https://files.pythonhosted.org/packages/f7/8e/198be440142d033505306b3d116a4595630d038a5c7d1f9a00445a1c8ae7/AryaLogger-1.1.6.tar.gz" } ], "v1.1.7": [ { "comment_text": "", "digests": { "md5": "90120fc6b42fafac53f0a0426aa681ef", "sha256": "bfc1b9e44546925f68b5cefd52975c1a7ddea4665a801c669e2157b05b4d3c37" }, "downloads": -1, "filename": "AryaLogger-v1.1.7-py2.7.egg", "has_sig": false, "md5_digest": "90120fc6b42fafac53f0a0426aa681ef", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 31697, "upload_time": "2015-08-16T22:51:52", "url": "https://files.pythonhosted.org/packages/d4/cb/218b25fecfcd75c1c2b1aab4844230ead6acffb04f79419faaeb22c0691b/AryaLogger-v1.1.7-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "1545bc114203b18cac0665c8190749d1", "sha256": "6563e6e4809c993fea9e373780a8e65fac0de412a43d7cb52a5f19c66d1a7a99" }, "downloads": -1, "filename": "AryaLogger-v1.1.7.tar.gz", "has_sig": false, "md5_digest": "1545bc114203b18cac0665c8190749d1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11853, "upload_time": "2015-08-16T22:51:48", "url": "https://files.pythonhosted.org/packages/41/78/99b71f374016f9f9ffea6c1f9bc4bd551b53894d3080d2a544447529ddee/AryaLogger-v1.1.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "90120fc6b42fafac53f0a0426aa681ef", "sha256": "bfc1b9e44546925f68b5cefd52975c1a7ddea4665a801c669e2157b05b4d3c37" }, "downloads": -1, "filename": "AryaLogger-v1.1.7-py2.7.egg", "has_sig": false, "md5_digest": "90120fc6b42fafac53f0a0426aa681ef", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 31697, "upload_time": "2015-08-16T22:51:52", "url": "https://files.pythonhosted.org/packages/d4/cb/218b25fecfcd75c1c2b1aab4844230ead6acffb04f79419faaeb22c0691b/AryaLogger-v1.1.7-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "1545bc114203b18cac0665c8190749d1", "sha256": "6563e6e4809c993fea9e373780a8e65fac0de412a43d7cb52a5f19c66d1a7a99" }, "downloads": -1, "filename": "AryaLogger-v1.1.7.tar.gz", "has_sig": false, "md5_digest": "1545bc114203b18cac0665c8190749d1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11853, "upload_time": "2015-08-16T22:51:48", "url": "https://files.pythonhosted.org/packages/41/78/99b71f374016f9f9ffea6c1f9bc4bd551b53894d3080d2a544447529ddee/AryaLogger-v1.1.7.tar.gz" } ] }