{ "info": { "author": "Alceu Rodrigues de Freitas Junior", "author_email": "glasswalk3r@yahoo.com.br", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3" ], "description": "# siebel-crash-report\nPython project that searchs and aggregates Siebel component crashes information into a nice report.\n\n## Features\n\nAutomates all required steps to retrieve information of a Siebel server\ncomponent crash to send the report to Oracle support.\n\nInformation is searched and retrieve from the following sources:\n\n- the memory dump (`core.dump` files) itself using GDB.\n- FDR files with sarmanalyzer.\n- Siebel enterprise log files.\n- correlate information from the FDR with the enterprise log file.\n- a summary JSON report.\n\nThe CSV (from sarmanalyzer) and the GDB output as text are created as necessary\nin the directory defined by the `crash_dir` entry in the `crash_reporter.ini`\nconfiguration file, together with the summary JSON report and a copy of the\n`crash.txt`.\n\nAll the information (but the CSV and GDB output) is printed to `STDOUT`, so\nit's to run it together in a cron job and pipe it to `mail` program.\n\nHere is an example of the JSON report (two crashes identified):\n\n```javascript\n{\n\t18192 : {\n\t\t'core' : {\n\t\t\t'last_mod' : '2016-09-08 17:46:08',\n\t\t\t'executable' : 'siebprocmw',\n\t\t\t'size' : 211382272,\n\t\t\t'generated_by' : 'SIGABRT',\n\t\t\t'filename' : 'core.18192'\n\t\t},\n\t\t'fdr' : {\n\t\t\t'last_mod' : '2016-09-08 17:46:07',\n\t\t\t'size' : 5000032,\n\t\t\t'filename' : 'T201609081518_P018192.fdr'\n\t\t},\n\t\t'thread' : '-247841904'\n\t},\n\t28019 : {\n\t\t'core' : {\n\t\t\t'last_mod' : '2016-09-09 22:40:22',\n\t\t\t'executable' : 'siebmtshmw',\n\t\t\t'size' : 356610048,\n\t\t\t'generated_by' : 'SIGABRT',\n\t\t\t'filename' : 'core.28019'\n\t\t},\n\t\t'fdr' : {\n\t\t\t'last_mod' : '2016-09-09 22:40:22',\n\t\t\t'size' : 5000032,\n\t\t\t'filename' : 'T201609092237_P028019.fdr'\n\t\t},\n\t\t'thread' : '-171263680'\n\t}\n}\n```\n\nThe core and FDR files might be removed right after (see the configuration file)\nthe analysis is complete.\n\nThis script will work on Linux only. It is expected that the `gdb` program (to\n extract the core dumps backtrace) and the `iniparse` (available as RPM\n package on RedHat, CentOS and Oracle Enterprise Linux) Python module are\n installed.\n\nThe script crash_monitor has also an on-line documentation. You can check it\nwith:\n\n```\n$ pydoc siebel.maintenance.crash\n```\n\nTo generate HTML documentation for this module issue the command:\n\n```\n$ pydoc -w siebel.maintenance.crash\n```\n\n## How to use\n\n### Requirements\n\n - Python 2.X or 3.x.\n - Siebel Server binaries and configuration in place.\n - Linux (all setup is specific to Linux).\n - GNU GDB.\n\n### Install\n\nYou should be able to install this program with `pip`:\n\n```\n$ pip install siebel-crash-report\n```\n\nThen you will need to configure the crash_reporter program and finally run it\nagainst your Siebel Enterprise.\n\n### Configuration\n\nYou must have a INI configuration file located at your home directory as\n`$HOME/.crash.ini`.\n\nHere is a sample INI configuration file:\n\n```Ini\n[main]\n;location of Siebel binaries\nbin_dir = /server/81/siebsrvr/bin\n; location of where the crashes information will be stored. A subdirectory will be created there with filename \"crash_dir\" appended with datetime.date.today string\ncrash_dir = /server/crash_dir\n; location of the Siebel Enterprise log files\nenterprise_log_dir = /server/foobar/siebel/81/siebsrvr/enterprises/foobar/myserver/log\n; location of Siebel Enterprise log archives\nlog_archive = /server/foobar/siebel/81/siebsrvr/enterprises/foobar/myserver/logarchive\n; the file name of the Siebel Enterprise log file (only the file name, not the complete path)\nenterprise_log_file = foobar.myserver.log\nclean_files = yes\n```\n\nFurther information can be checked on the module documentation:\n\n```\n$ pydoc siebel.maintenance.crash.readConfig\n```\n\n## Development\n\nIf you want to get involved with this project develoment, here are some very\nbasic details to start.\n\n### Requirements\n\n - Python 2.X and 3.x.\n - Python modules (see `requirements.txt` and `requirements-3x.txt`).\n - Siebel Server binaries and configuration in place.\n - Linux (all setup is specific to Linux).\n - GNU GDB.\n\n### Running tests\n\nIn order to run tests with `pytest`, setup the `PYTHONPATH` environment\nvariable first:\n\n```\n$ export PYTHONPATH=\"$PWD/src\"\n$ pytest\n```\n\n### Known issues\n\nThis script was created to run on Python 2.4 (I know, very old but that's what\nwe got back in the day) but should work without problems with Python 2.7.\n\nPython 3.X **should** be supported. Use `requirements-3x.txt` file to install\nmodules through venv.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/glasswalk3r/siebel-crash-report", "keywords": "Siebel crash core dump component", "license": "", "maintainer": "", "maintainer_email": "", "name": "siebel-crash-report", "package_url": "https://pypi.org/project/siebel-crash-report/", "platform": "", "project_url": "https://pypi.org/project/siebel-crash-report/", "project_urls": { "Homepage": "https://github.com/glasswalk3r/siebel-crash-report" }, "release_url": "https://pypi.org/project/siebel-crash-report/0.0.1/", "requires_dist": [ "simplejson (>=3.13.2)", "pyyaml (>=3.13)" ], "requires_python": "", "summary": "Searchs and aggregates Siebel component crashes information into a nice report.", "version": "0.0.1" }, "last_serial": 4861694, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "9df7abb181502f2fe41f1967e1a9ada0", "sha256": "bccc15596c39a4093604db137dd0d88a22b7210dbdd16b7de9f5541a05c5e918" }, "downloads": -1, "filename": "siebel_crash_report-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "9df7abb181502f2fe41f1967e1a9ada0", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 23205, "upload_time": "2019-02-24T18:52:16", "url": "https://files.pythonhosted.org/packages/66/c1/bfa0177e0e1f6d7986ce59ea1787d4afa0eb4af66592c8a0b342916a7f2c/siebel_crash_report-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5e2479eb052706e953ca968be5549267", "sha256": "6f47fb16920a8a91213c2af46fea7a64d38f23c7f58393959e539c969c746cd4" }, "downloads": -1, "filename": "siebel-crash-report-0.0.1.tar.gz", "has_sig": false, "md5_digest": "5e2479eb052706e953ca968be5549267", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11624, "upload_time": "2019-02-24T18:52:18", "url": "https://files.pythonhosted.org/packages/48/1b/cb797e9b8ed9af5003307224dd495075a3372c82db8b92a9828d2f315ea4/siebel-crash-report-0.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9df7abb181502f2fe41f1967e1a9ada0", "sha256": "bccc15596c39a4093604db137dd0d88a22b7210dbdd16b7de9f5541a05c5e918" }, "downloads": -1, "filename": "siebel_crash_report-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "9df7abb181502f2fe41f1967e1a9ada0", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 23205, "upload_time": "2019-02-24T18:52:16", "url": "https://files.pythonhosted.org/packages/66/c1/bfa0177e0e1f6d7986ce59ea1787d4afa0eb4af66592c8a0b342916a7f2c/siebel_crash_report-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5e2479eb052706e953ca968be5549267", "sha256": "6f47fb16920a8a91213c2af46fea7a64d38f23c7f58393959e539c969c746cd4" }, "downloads": -1, "filename": "siebel-crash-report-0.0.1.tar.gz", "has_sig": false, "md5_digest": "5e2479eb052706e953ca968be5549267", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11624, "upload_time": "2019-02-24T18:52:18", "url": "https://files.pythonhosted.org/packages/48/1b/cb797e9b8ed9af5003307224dd495075a3372c82db8b92a9828d2f315ea4/siebel-crash-report-0.0.1.tar.gz" } ] }