| Name | wbclient JSON |
| Version |
2.0.1
JSON |
| download |
| home_page | None |
| Summary | Monitor and control FileMaker Servers |
| upload_time | 2025-08-31 17:48:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | <!DOCTYPE html>
<html id="home" lang="en">
<head>
<title>MIT License</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<meta name="description"
content="The MIT License is a permissive free software license originating at the Massachusetts Institute of Technology. As a permissive license, it puts only very limited restriction on reuse and has, therefore, an excellent license compatibility.">
<script>
document.createElement('article');
document.createElement('footer');
</script>
<link rel="stylesheet" href="/themes/default.css">
</head>
<body>
<article>
<h1>The MIT License (MIT)</h1>
<p>Copyright © 2024 <copyright holders></p>
<p>Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:</p>
<p>The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.</p>
<p>THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.</p>
</article>
<footer>
</footer>
</body>
</html>
|
| keywords |
filemaker
filemaker server
monitor
log
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# WhistleBlower
A tool to monitor and control FileMaker Server processes, and a managing FileMaker solution.
## In detail
WhistleBlower is a combination of a locally running Python script, and a monitoring FileMaker solution.
WhistleBlower can log information of a locally running FileMaker Server, and processes command line instructions on the server machine.
It can read all log files, it can log memory and cpu usage of all FileMaker Server processes, as well as gather information about all attached storage volumes.
WhistleBlower can also execute command line instructions, and return the results.
Communication with the monitoring FileMaker Server is done through the FileMaker Data API.
## Installation
WhistleBlower runs on all FileMaker Server platform (Ubuntu/WIndows/macOS), and requires a centrally running FileMaker Server that supports the FileMaker Data API (18+). There are not local FileMaker Server requirements.
Whistelblower als requires python3 to be installed,
### to install:
(Ubuntu 22.04)
running as root
<code></br>
cd ~</br>
mkdir wbclient</br>
cd wbclient</br>
apt install python3.10-venv</br>
</code>
(this will restart fmshelper!)
<code>
<br>
python3 -m venv wbclient </br>
source wbclient/bin/activate</br>
</code>
Using pip:
<code>
</br>
pip install wbclient </br>
</code>
Using a folder containing the distribution:
<code>
</br>
pip install ~/dist/wbclient-1.0.0-py3-none-any.whl </br>
</code>
If you just launch wbclient by typing
<code></br>
wbclient
</code>
The application will have created a wb_config.json file in
/root/.config/wbclient/wb_config.json
edit thei
### to configure
<code></br>
nano /root/.config/wbclient/wb_config.json
</code>
The file contains the following JSON entries:
#### serverid
The is the account used to log in to the central monitoring FileMaker Serve WhistleBlower FileMaker file.
#### host_name
The DNS name of the server that is hosting the WhistleBlower FileMaker file.
#### use_ssl
We strongly recommend setting this to "true".
#### port
Normally 443, but can be changed if your FileMaker Server is e.g. behind a NAT firewall.
#### database_name
Normally "whistleblower", but you can change this name.
#### post_layout
"wb_post" by default, this is the name of the FileMaker layout used during the logging Data API calls.
#### command_layout
"wb_commands" by default, this is the name of the FileMaker layout where the queue table for giving commands resides.
#### post_script
"process_data" by default, this is the name of the script that is execcuted after Data API calls that log information.
#### password
Enter the serverid value and the password entered here, also in the security settings of the WhistleBlower FileMaker file, and give this user the "whistleblower" privilege set.
#### post_interval
This is the time in seconds that the Python code pauses between subsequent actions - checking log files, querying system information and processing commands.
#### keyboard_control
"False" by default, use this if you want to control the python code using the keyboard. Can be handy when running the WhistleBlower tool from the console.
#### command_user
"fmserver" being the default account, because this is the default account FileMaker Server runs as. Theis can be altered to have less or more privileges on the FileMaker Server when executing commands.
#### command_whitelist
This JSON arrary can contain a number of commands that will be executed with elevated privileges, whatever the command_user.
### Running the WhistleBlower tool
the command "wbclient" can be invoked from the console, or the server can be configured to run whistleblower at startup.
#### important
wbclient should be run with elevated privileges. This means using sudo on Ubuntu or macOS, or running a PowerShell as Administrator on Windows.
Raw data
{
"_id": null,
"home_page": null,
"name": "wbclient",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "FileMaker, FileMaker Server, Monitor, Log",
"author": null,
"author_email": "Peter Wagemans <twinge_sophism.04@icloud.com>, Ian Jempson <ianjempson@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/07/ed/c0c3ac184821aaba3a1f4c68972bd7c3e3f8194446b31d3d6f403b9cdf07/wbclient-2.0.1.tar.gz",
"platform": null,
"description": "# WhistleBlower\nA tool to monitor and control FileMaker Server processes, and a managing FileMaker solution.\n## In detail\nWhistleBlower is a combination of a locally running Python script, and a monitoring FileMaker solution.\nWhistleBlower can log information of a locally running FileMaker Server, and processes command line instructions on the server machine.\nIt can read all log files, it can log memory and cpu usage of all FileMaker Server processes, as well as gather information about all attached storage volumes.\nWhistleBlower can also execute command line instructions, and return the results.\nCommunication with the monitoring FileMaker Server is done through the FileMaker Data API.\n## Installation\nWhistleBlower runs on all FileMaker Server platform (Ubuntu/WIndows/macOS), and requires a centrally running FileMaker Server that supports the FileMaker Data API (18+). There are not local FileMaker Server requirements.\nWhistelblower als requires python3 to be installed,\n### to install:\n(Ubuntu 22.04)\nrunning as root\n\n<code></br>\ncd ~</br>\nmkdir wbclient</br>\ncd wbclient</br>\napt install python3.10-venv</br>\n</code>\n\n(this will restart fmshelper!)\n\n<code>\n<br>\npython3 -m venv wbclient </br>\nsource wbclient/bin/activate</br>\n</code>\n\nUsing pip:\n<code>\n</br>\npip install wbclient </br>\n</code>\n\nUsing a folder containing the distribution:\n<code>\n</br>\npip install ~/dist/wbclient-1.0.0-py3-none-any.whl </br>\n</code>\n\nIf you just launch wbclient by typing\n<code></br>\nwbclient\n</code>\n\nThe application will have created a wb_config.json file in\n/root/.config/wbclient/wb_config.json\nedit thei\n\n### to configure\n<code></br>\nnano /root/.config/wbclient/wb_config.json\n</code>\n\nThe file contains the following JSON entries:\n#### serverid\nThe is the account used to log in to the central monitoring FileMaker Serve WhistleBlower FileMaker file.\n#### host_name\nThe DNS name of the server that is hosting the WhistleBlower FileMaker file.\n#### use_ssl\nWe strongly recommend setting this to \"true\".\n#### port\nNormally 443, but can be changed if your FileMaker Server is e.g. behind a NAT firewall.\n#### database_name\nNormally \"whistleblower\", but you can change this name.\n#### post_layout\n\"wb_post\" by default, this is the name of the FileMaker layout used during the logging Data API calls.\n#### command_layout\n\"wb_commands\" by default, this is the name of the FileMaker layout where the queue table for giving commands resides.\n#### post_script\n\"process_data\" by default, this is the name of the script that is execcuted after Data API calls that log information.\n#### password\nEnter the serverid value and the password entered here, also in the security settings of the WhistleBlower FileMaker file, and give this user the \"whistleblower\" privilege set.\n#### post_interval\nThis is the time in seconds that the Python code pauses between subsequent actions - checking log files, querying system information and processing commands.\n#### keyboard_control\n\"False\" by default, use this if you want to control the python code using the keyboard. Can be handy when running the WhistleBlower tool from the console.\n#### command_user\n\"fmserver\" being the default account, because this is the default account FileMaker Server runs as. Theis can be altered to have less or more privileges on the FileMaker Server when executing commands.\n#### command_whitelist\nThis JSON arrary can contain a number of commands that will be executed with elevated privileges, whatever the command_user.\n### Running the WhistleBlower tool\nthe command \"wbclient\" can be invoked from the console, or the server can be configured to run whistleblower at startup.\n#### important\nwbclient should be run with elevated privileges. This means using sudo on Ubuntu or macOS, or running a PowerShell as Administrator on Windows.\n",
"bugtrack_url": null,
"license": "<!DOCTYPE html>\n <html id=\"home\" lang=\"en\">\n <head>\n <title>MIT License</title>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <meta http-equiv=\"X-UA-Compatible\" content=\"ie=edge\">\n <meta name=\"description\"\n content=\"The MIT License is a permissive free software license originating at the Massachusetts Institute of Technology. As a permissive license, it puts only very limited restriction on reuse and has, therefore, an excellent license compatibility.\">\n <script>\n document.createElement('article');\n document.createElement('footer');\n </script>\n <link rel=\"stylesheet\" href=\"/themes/default.css\">\n </head>\n \n <body>\n <article>\n \n <h1>The MIT License (MIT)</h1>\n \n <p>Copyright \u00a9 2024 <copyright holders></p>\n \n <p>Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \u201cSoftware\u201d), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:</p>\n \n <p>The above copyright notice and this permission notice shall be included in\n all copies or substantial portions of the Software.</p>\n \n <p>THE SOFTWARE IS PROVIDED \u201cAS IS\u201d, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n THE SOFTWARE.</p>\n </article>\n <footer>\n </footer>\n \n </body>\n \n </html>\n ",
"summary": "Monitor and control FileMaker Servers",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://github.com/DataManixFM/WhistleBlower"
},
"split_keywords": [
"filemaker",
" filemaker server",
" monitor",
" log"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fbdd900d4bbcc0c25587e37c493875c2894702b10a580a7690cb0535a7764e47",
"md5": "63e807d6a9c0425ec355ad5071e2cd8f",
"sha256": "c71b8a139b3c8aef825ab587ff98518fd089c0a18bf352bf5c337cd9505ee640"
},
"downloads": -1,
"filename": "wbclient-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "63e807d6a9c0425ec355ad5071e2cd8f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 14920,
"upload_time": "2025-08-31T17:48:15",
"upload_time_iso_8601": "2025-08-31T17:48:15.059276Z",
"url": "https://files.pythonhosted.org/packages/fb/dd/900d4bbcc0c25587e37c493875c2894702b10a580a7690cb0535a7764e47/wbclient-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "07edc0c3ac184821aaba3a1f4c68972bd7c3e3f8194446b31d3d6f403b9cdf07",
"md5": "5ab6aa2d30af9a3932d25d495148a62b",
"sha256": "f42d6191c56023ce8f9ee35ff1f2f70248979e9fe106d12d18b497611fc7859e"
},
"downloads": -1,
"filename": "wbclient-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "5ab6aa2d30af9a3932d25d495148a62b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 14272,
"upload_time": "2025-08-31T17:48:16",
"upload_time_iso_8601": "2025-08-31T17:48:16.171484Z",
"url": "https://files.pythonhosted.org/packages/07/ed/c0c3ac184821aaba3a1f4c68972bd7c3e3f8194446b31d3d6f403b9cdf07/wbclient-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 17:48:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DataManixFM",
"github_project": "WhistleBlower",
"github_not_found": true,
"lcname": "wbclient"
}
