[![CI](https://github.com/infrasonar/appliance-manager/workflows/CI/badge.svg)](https://github.com/infrasonar/appliance-manager/actions)
[![Release Version](https://img.shields.io/github/release/infrasonar/appliance-manager)](https://github.com/infrasonar/appliance-manager/releases)
# InfraSonar Appliance Manager
This tool simplifies the installation and management of InfraSonar appliances. It streamlines the process of setting up and running your InfraSonar infrastructure, making it easier to monitor and manage your IT environment.
## Prerequisites
Before using the InfraSonar Appliance Manager, ensure you have the following prerequisites installed:
- Python _(inclusing pip)_
- Curl
You can install these prerequisites on Ubuntu or Debian-based systems using the following commands:
```
sudo apt update
sudo apt install python curl pip
```
Additionally, Docker Compose is required for the InfraSonar appliance to function properly. You can install Docker Compose using the following command:
```
sudo curl -sSL https://get.docker.com | bash
```
## Installation
To install the InfraSonar Appliance Manager, use the following command:
```
pip install infrasonar-appliance
```
## Usage
Once installed, simply start the tool using the following command:
```
appliance
```
The tool will handle the installation and management of your [InfraSonar appliance](https://docs.infrasonar.com/collectors/probes/appliance/), allowing you to focus on monitoring and managing your IT infrastructure.
## Additional Notes
- For more detailed instructions and troubleshooting guidance, refer to the official [InfraSonar documentation](https://docs.infrasonar.com).
- If you encounter any issues during installation or usage, feel free to [contact](https://infrasonar.com/contact) the InfraSonar support team for assistance.
## API forwarding
To enable InfraSonar agents to communicate with the API when direct access is blocked by firewalls, this tool can establish a forwarding service. This service acts as an intermediary, relaying agent requests to the API.
If you encounter issues binding to port 443 due to insufficient Docker privileges, you can adjust the system settings using the following command:
```
sudo sysctl net.ipv4.ip_unprivileged_port_start=0
```
To keep this setting after reboot, create or edit `/etc/sysctl.d/local.conf` and add the following line:
```
net.ipv4.ip_unprivileged_port_start=0
```
Raw data
{
"_id": null,
"home_page": "https://github.com/infrasonar/appliance-manager",
"name": "infrasonar-appliance",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "infrasonar monitoring toolkit util",
"author": "Jeroen van der Heijden",
"author_email": "jeroen@cesbit.com",
"download_url": "https://files.pythonhosted.org/packages/e4/78/2debc5606b4bbff003cd9800e2f66af3694c794cdcbae6b4234202b89a07/infrasonar_appliance-0.2.1.tar.gz",
"platform": null,
"description": "[![CI](https://github.com/infrasonar/appliance-manager/workflows/CI/badge.svg)](https://github.com/infrasonar/appliance-manager/actions)\n[![Release Version](https://img.shields.io/github/release/infrasonar/appliance-manager)](https://github.com/infrasonar/appliance-manager/releases)\n\n\n# InfraSonar Appliance Manager\n\nThis tool simplifies the installation and management of InfraSonar appliances. It streamlines the process of setting up and running your InfraSonar infrastructure, making it easier to monitor and manage your IT environment.\n\n## Prerequisites\n\nBefore using the InfraSonar Appliance Manager, ensure you have the following prerequisites installed:\n\n- Python _(inclusing pip)_\n- Curl\n\nYou can install these prerequisites on Ubuntu or Debian-based systems using the following commands:\n```\nsudo apt update\nsudo apt install python curl pip\n```\n\nAdditionally, Docker Compose is required for the InfraSonar appliance to function properly. You can install Docker Compose using the following command:\n```\nsudo curl -sSL https://get.docker.com | bash\n```\n\n## Installation\n\nTo install the InfraSonar Appliance Manager, use the following command:\n```\npip install infrasonar-appliance\n```\n\n## Usage\n\nOnce installed, simply start the tool using the following command:\n```\nappliance\n```\n\nThe tool will handle the installation and management of your [InfraSonar appliance](https://docs.infrasonar.com/collectors/probes/appliance/), allowing you to focus on monitoring and managing your IT infrastructure.\n\n## Additional Notes\n\n- For more detailed instructions and troubleshooting guidance, refer to the official [InfraSonar documentation](https://docs.infrasonar.com).\n- If you encounter any issues during installation or usage, feel free to [contact](https://infrasonar.com/contact) the InfraSonar support team for assistance.\n\n## API forwarding\n\nTo enable InfraSonar agents to communicate with the API when direct access is blocked by firewalls, this tool can establish a forwarding service. This service acts as an intermediary, relaying agent requests to the API.\n\nIf you encounter issues binding to port 443 due to insufficient Docker privileges, you can adjust the system settings using the following command:\n\n```\nsudo sysctl net.ipv4.ip_unprivileged_port_start=0\n```\n\nTo keep this setting after reboot, create or edit `/etc/sysctl.d/local.conf` and add the following line:\n\n```\nnet.ipv4.ip_unprivileged_port_start=0\n```\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "InfraSonar Appliance Manager",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/infrasonar/appliance-manager"
},
"split_keywords": [
"infrasonar",
"monitoring",
"toolkit",
"util"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e4782debc5606b4bbff003cd9800e2f66af3694c794cdcbae6b4234202b89a07",
"md5": "bd77e02975a37966baae54de9cd874b1",
"sha256": "b5e332392170c821042ed6317a75add0409e55c4e3e3ee836b81926c5930464b"
},
"downloads": -1,
"filename": "infrasonar_appliance-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "bd77e02975a37966baae54de9cd874b1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 35074,
"upload_time": "2024-11-18T15:57:58",
"upload_time_iso_8601": "2024-11-18T15:57:58.062724Z",
"url": "https://files.pythonhosted.org/packages/e4/78/2debc5606b4bbff003cd9800e2f66af3694c794cdcbae6b4234202b89a07/infrasonar_appliance-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-18 15:57:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "infrasonar",
"github_project": "appliance-manager",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "aiohttp",
"specs": []
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "setproctitle",
"specs": []
},
{
"name": "configobj",
"specs": []
}
],
"lcname": "infrasonar-appliance"
}