Skip to content
Snippets Groups Projects
Commit 099a803d authored by Hahn Axel (hahn)'s avatar Hahn Axel (hahn)
Browse files

update docs

parent 53e03c0b
Branches
No related tags found
No related merge requests found
......@@ -8,14 +8,23 @@ All our web projects running with PHP were simple to integrate. But what about a
This project was initiated to create a compiled client from PHP sources that can be configured with an ini file to perform needed checks. Such a binary is independent from any programming language.
### Requirements
### The result
#### For usage of the client
A single binary without dependencies can be put on a Linux target host.
It can perform all checks that the current Appmonitor client as Php client can execute.
With command line parameter `--ini=<INIFILE>` it processes the checks that are defined there.
![alt text](images/screesnhot_test_php_modules.png)
## Requirements
### For usage of the client
* A binary for your platform must be available for download or must be built. Linux x86_64 is the 1st target platform
* no other requirements
* no other requirements/ dependencies
#### To built a new binary
### To built a new binary
* git
* wget
......
## Installation
TODO
TODO: there is no uploaded binary yet.
You need a local copy of the compiled single binary.
......
......@@ -2,7 +2,7 @@
```text
./src/amcli -h
IML Appmonitor as CLI client 0.1
IML Appmonitor as CLI client 0.2
This client performs appmonitor checks and puts the results as JSON to stdout.
You can use the compiled binary on non PHP systems.
......@@ -108,7 +108,7 @@ The binary uses the php function `parse_ini_file` - see <https://www.php.net/man
* a string with letters, digits, underscore
* Use multiple `<VARNAME>[]` to create an an array with list items
* `<VARNAME>[<KEY>]` is unused so far
* `<VARNAME>[<KEY>]` is used for slack notifications and one of the possible options for [check] -> params
* **values**
......
docs/images/screesnhot_test_php_modules.png

528 KiB

......@@ -2,67 +2,13 @@
💡 **Idea**: For non PHP systems we prepare a compiled binary containing all written PHP checks. Then those non PHP systems do not need to implement the checks again.
## Requirements
👤 Author: Axel Hahn; Institute for Medical Education; University of Bern \
📄 Source: <https://git-repo.iml.unibe.ch/iml-open-source/appmonitor-cli-client> \
📜 License: GNU GPL 3.0 \
📗 Docs: <https://os-docs.iml.unibe.ch/appmonitor-cli-client/>
* wget
* git
* PHP 8 cli (no webserver needed)
## Screenshots
## Installation
How to bring up this project to live:
Clone this repository.
You get this initial structure:
```txt
.
├── build.php
├── inc_functions.php
├── inc_vars.php
├── installer.php
├── readme.md
└── src
└── amcli.php
```
Run the `./installer.php` to download spc and prepare the micro build.
The newly created dirs:
```txt
.
├── build << working directory for builds
├── external
│ ├── appmonitor << cloned IML appmonitor project
│ └── bin
│ └── spc << downloaded spc binary
:
```
## Update
Run the installer again.
if you want to install a newer version of spc: remove the external/bin/ directory and run the installer again.
## Start over
Remove the dirs
- built_packages
- build
- external
And this file
- src/include_checks.php
Then start `./installer.php` and `./build.php`
## Compile
To compile `src/amcli.php`to `built_packages/amcli` start the `./build.php`
The binary has parameter support. It parses an ini file that containes metadata and all checks.
![alt text](docs/images/screesnhot_test_php_modules.png)
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment