[](https://github.com/alertlogic/alcli/actions)
[](https://github.com/alertlogic/alcli/actions)
[](https://badge.fury.io/py/alcli)
# Installing the Alert Logic CLI
The `pip` package manager for Python is used to install, upgrade and remove Alert Logic CLI.
## **Installing the current version of the Alert Logic CLI**
Alert Logic CLI only works on Python 3.7 or higher.
Please follow this instructions on how to install Python on your system: <https://www.python.org/downloads/>
Use `pip3` to install the Alert Logic CLI
$ pip3 install alcli --upgrade --user
Make sure to use `--user` to to install the program to a subdirectory of your user directory to avoid modifying libraries used by your operating system.
### Windows installer
For windows users there is self-contained Alert Logic CLI distribution is available, please download latest version from here:
* [executable installation package](https://github.com/alertlogic/alcli/releases/latest/download/AlertlogicCLISetup.exe)
* [msi installation package](https://github.com/alertlogic/alcli/releases/latest/download/AlertlogicCLISetup.msi)
Alternatively, please view [history](https://github.com/alertlogic/alcli/releases/) of the releases.
## **Upgrading to the latest version of the Alert Logic CLI**
We regularly introduce support for new Alert Logic services.
We recommend that you check installed packages version and upgrade to the latest version regularly.
```
$ pip3 install --upgrade --force-reinstall alcli
```
## Configure the Alert Logic CLI with Your Credentials
Before you can run a CLI command, you must configure the Alert Logic's CLI with your credentials.
By default, `alcli` uses ~/.alertlogic/config configuration file in a user's home directory. File can contain multiple profiles. Here's an example of a configuration file that has credentials for an integration and production deployments:
[default]
access_key_id=1111111111111111
secret_key=eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
global_endpoint=integration
[production]
access_key_id=2222222222222222
secret_key=dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
global_endpoint=production
The location of the configuration file can be also specified by setting `ALERTLOGIC_CONFIG` environment variable to contain file's location.
## Notes:
`--query` option requires JMESPath language expression. See
<http://jmespath.org/tutorial.html> for language tutorial.
=======
History
=======
1.0.1 (2020-02-06)
------------------
* First release on PyPI.
1.0.7 (2020-02-07)
------------------
* First version of main help page and bug fixes.
Raw data
{
"_id": null,
"home_page": "https://github.com/alertlogic/alcli",
"name": "alcli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "alcli, almdr, alertlogic, alertlogic-cli",
"author": "Alert Logic Inc.",
"author_email": "devsupport@alertlogic.com",
"download_url": "https://files.pythonhosted.org/packages/c0/40/5c291176169ef2b69c444bb2e368c997f44478c1d53c97e57e3c9a6bb4ee/alcli-1.0.70.tar.gz",
"platform": "any",
"description": "\n[](https://github.com/alertlogic/alcli/actions)\n[](https://github.com/alertlogic/alcli/actions)\n[](https://badge.fury.io/py/alcli)\n\n# Installing the Alert Logic CLI\nThe `pip` package manager for Python is used to install, upgrade and remove Alert Logic CLI.\n\n## **Installing the current version of the Alert Logic CLI**\n\nAlert Logic CLI only works on Python 3.7 or higher. \nPlease follow this instructions on how to install Python on your system: <https://www.python.org/downloads/>\n\n\nUse `pip3` to install the Alert Logic CLI\n\n $ pip3 install alcli --upgrade --user\n\n\nMake sure to use `--user` to to install the program to a subdirectory of your user directory to avoid modifying libraries used by your operating system.\n\n### Windows installer\n\nFor windows users there is self-contained Alert Logic CLI distribution is available, please download latest version from here: \n* [executable installation package](https://github.com/alertlogic/alcli/releases/latest/download/AlertlogicCLISetup.exe)\n* [msi installation package](https://github.com/alertlogic/alcli/releases/latest/download/AlertlogicCLISetup.msi)\n\nAlternatively, please view [history](https://github.com/alertlogic/alcli/releases/) of the releases. \n\n## **Upgrading to the latest version of the Alert Logic CLI**\nWe regularly introduce support for new Alert Logic services.\nWe recommend that you check installed packages version and upgrade to the latest version regularly.\n\n```\n$ pip3 install --upgrade --force-reinstall alcli\n```\n\n## Configure the Alert Logic CLI with Your Credentials\nBefore you can run a CLI command, you must configure the Alert Logic's CLI with your credentials.\n\nBy default, `alcli` uses ~/.alertlogic/config configuration file in a user's home directory. File can contain multiple profiles. Here's an example of a configuration file that has credentials for an integration and production deployments:\n\n [default]\n\taccess_key_id=1111111111111111\n\tsecret_key=eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\n\tglobal_endpoint=integration\n\t\n\t[production]\n\taccess_key_id=2222222222222222\n\tsecret_key=dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd\n\tglobal_endpoint=production\n\n\nThe location of the configuration file can be also specified by setting `ALERTLOGIC_CONFIG` environment variable to contain file's location.\n\n## Notes:\n`--query` option requires JMESPath language expression. See \n<http://jmespath.org/tutorial.html> for language tutorial.\n\n\n\n=======\nHistory\n=======\n\n1.0.1 (2020-02-06)\n------------------\n\n* First release on PyPI.\n\n1.0.7 (2020-02-07)\n------------------\n\n* First version of main help page and bug fixes.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "The Alert Logic Command Line Utility (CLI).",
"version": "1.0.70",
"project_urls": {
"Homepage": "https://github.com/alertlogic/alcli"
},
"split_keywords": [
"alcli",
" almdr",
" alertlogic",
" alertlogic-cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6e285cba5b54c55b8d7f6e20227705aa71e23e21d1ac6fb3736e64a19d2a2b19",
"md5": "a797b0a25758e547091791e84629c787",
"sha256": "c265d9cd9d13b5c20f3393e65b042ce0928b5f3e909601c8e95fd40449e9424a"
},
"downloads": -1,
"filename": "alcli-1.0.70-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a797b0a25758e547091791e84629c787",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 15523,
"upload_time": "2024-09-24T21:27:04",
"upload_time_iso_8601": "2024-09-24T21:27:04.635728Z",
"url": "https://files.pythonhosted.org/packages/6e/28/5cba5b54c55b8d7f6e20227705aa71e23e21d1ac6fb3736e64a19d2a2b19/alcli-1.0.70-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c0405c291176169ef2b69c444bb2e368c997f44478c1d53c97e57e3c9a6bb4ee",
"md5": "033d83eed91f0da6bd0cf397aa62e71a",
"sha256": "1c9426acd6702de9de5905de80d69f35f243900da1a3bf1006010afe24e3a211"
},
"downloads": -1,
"filename": "alcli-1.0.70.tar.gz",
"has_sig": false,
"md5_digest": "033d83eed91f0da6bd0cf397aa62e71a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 88045,
"upload_time": "2024-09-24T21:27:05",
"upload_time_iso_8601": "2024-09-24T21:27:05.856995Z",
"url": "https://files.pythonhosted.org/packages/c0/40/5c291176169ef2b69c444bb2e368c997f44478c1d53c97e57e3c9a6bb4ee/alcli-1.0.70.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-24 21:27:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alertlogic",
"github_project": "alcli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "alcli"
}
JSON
