3a8768e85f
DOCS-1071: mc.RELEASE.2023-11-15T22-45-58Z PARTIAL ( #1075 )
...
Partially addresses #1071
Just documenting `mc alias import` and `mc alias export`, the former of
which we seem to have missed a year or so back.
Staged:
http://192.241.195.202:9000/staging/DOCS-1071/linux/reference/minio-mc/mc-alias-import.html
http://192.241.195.202:9000/staging/DOCS-1071/linux/reference/minio-mc/mc-alias-export.html
2023-11-22 14:21:55 -05:00
09ce8edb48
Updates for two October releases ( #1065 )
...
- Adds additional flag for `mc admin trace`
- Adds info about supported secret types for k8s
Closes #1039
For the `mc admin trace --stats` flag, also adding example output.
Closes #1045
2023-11-15 11:58:16 -05:00
abee6a35d6
Updates for two Oct 2023 mc releases ( #1066 )
...
Updates for October 2023 MinIO Client releases
- Adds output sample for `mc support top locks`
- Adds `mc idp ldap accesskey` and subcommands
Closes #1056
- Adds environment variables for most global flags
- Adds --retry flag to mc mirror
- Adds --bucket-bandwidth flag to mc admin replicate update
Partially addresses #1045
- Removes unsupported `--noncurrent-transition-newer` flags from
commands.
2023-11-10 14:05:07 -05:00
eb94513104
Breaking up envvars and config settings into separate settings pages ( #1028 )
...
- Creates a slew of folders and pages nested under the mc-server page to store settings.
- Breaks up all of the environment variable options formerly in the mc-server page into these separate pages.
- Moves the config settings formerly in the mc admin config page to the appropriate new settings pages.
- Adds a MiniO Client settings page and document `mc-host-<alias>`
Closes #1017
2023-11-03 07:55:22 -04:00
2a10ceabdc
remove out of context doc ( #1053 )
2023-10-30 15:50:31 -04:00
1747558ffc
Doc updates for mc RELEASE.2023-10-04T06-52-56Z ( #1044 )
...
Doc updates for mc release
[2023-10-04T06-52-56Z](https://github.com/minio/docs/issues/1035 )
- [x] `resource` type for Prometheus metrics
- [x] Doc `mc admin trace --request-query`, ~maybe it and some other
should be hidden from `mc --help`?~
Staged:
http://192.241.195.202:9000/staging/DOCS-1035/linux/operations/monitoring/collect-minio-metrics-using-prometheus.html
Fixes https://github.com/minio/docs/issues/1035
2023-10-23 15:17:50 -06:00
6a1697c9f5
DOCS-1022: Use 'mc idp ldap policy' for AD/LDAP policy assignments ( #1026 )
...
---------
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-10-05 16:59:43 -04:00
091a321e32
Improve mc deprecated reference: cleanup, move mc admin top ( #1019 )
...
First batch of mc deprecation cleanup:
[x] Reorder section TOC: `mc` alphabetical, then `mc admin`
alphabetical.
[x] Standardize deprecation notice format and wording.
[x] Move `mc admin top` to deprecated section.
Staged
http://192.241.195.202:9000/staging/DOCS-896-cleanup-mc-admin-top/linux/reference/minio-mc-deprecated.html
Partially addresses https://github.com/minio/docs/issues/896
2023-10-05 10:29:02 -06:00
20124c9a59
Updates for mc RELEASE.2023-09-20T15-22-31Z ( #1015 )
...
- Deprecates mc admin heal flags
- Adds info about healing colors
- Adds mc mirror --exclude-storageclass flag
Closes #1009
Closes #1005
2023-09-29 17:47:55 -04:00
962835b758
Updates for mc RELEASE.2023-08-30T08-02-26Z ( #1013 )
...
Adds example output for `mc admin replicate status` to reflect expanded
output.
Closes #988
2023-09-28 14:00:23 -04:00
958269a4d1
Clarify webhook auth token details ( #996 )
...
Update text about webhook auth tokens to clarify MinIO uses the value
specified as it is. So if it needs `Bearer` or `Basic` or something
else, that must be included in the string.
Affected items:
- `MINIO_LOGGER_WEBHOOK_AUTH_TOKEN`
- `MINIO_AUDIT_WEBHOOK_AUTH_TOKEN`
- `MINIO_NOTIFY_WEBHOOK_AUTH_TOKEN`
- `mc admin config set logger_webhook auth_token`
- `mc admin config set audit_webhook auth_token`
- `mc admin config set notify_webhook auth_token`
Staged:
_Publish Server or Audit Logs to an External Service_
http://192.241.195.202:9000/staging/DOCS-407/linux/operations/monitoring/minio-logging.html#publish-server-logs-to-http-webhook
http://192.241.195.202:9000/staging/DOCS-407/linux/operations/monitoring/minio-logging.html#publish-audit-logs-to-http-webhook
_mc admin config_
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-mc-admin/mc-admin-config.html#mc-conf.logger_webhook.auth_token
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-mc-admin/mc-admin-config.html#mc-conf.audit_webhook.auth_token
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-mc-admin/mc-admin-config.html#mc-conf.notify_webhook.auth_token
_MinIO Server_
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-server/minio-server.html#envvar.MINIO_LOGGER_WEBHOOK_AUTH_TOKEN
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-server/minio-server.html#envvar.MINIO_AUDIT_WEBHOOK_AUTH_TOKEN
http://192.241.195.202:9000/staging/DOCS-407/linux/reference/minio-server/minio-server.html#envvar.MINIO_NOTIFY_WEBHOOK_AUTH_TOKEN
Fixes https://github.com/minio/docs/issues/407
2023-09-11 09:06:58 -06:00
388cc6c9f3
Adds information about role policy and roleARN for OpenID docs. ( #983 )
...
Closes #933
- Adds envvar and config param
- Adds Role Policy openID authentication flow
2023-09-01 16:37:59 -05:00
28e415fd8c
Updates for mc RELEASE.2023-08-29T22-55-06Z ( #979 )
...
mc
[RELEASE.2023-08-29T22-55-06Z](https://github.com/minio/mc/releases/tag/RELEASE.2023-08-29T22-55-06Z )
has changes that impact the docs:
- Adds `list` command to `mc admin kms key`
- Adds new group of `scanner` event types
There is no issue to track this release.
2023-08-31 09:53:21 -05:00
e7e83d91b4
Documents the scanner.speed config and minio_scanner_speed envvar ( #973 )
...
Closes #796
And a few other paragraphs here there and yon.
2023-08-29 10:49:10 -05:00
27e2f48b2d
Standardize wording of envvar/mc admin config links ( #966 )
...
This change standardizes the text for the "`foo` corresponds with `bar`"
links between the list of envvars and `mc admin config` settings.
(Thanks to @djwfyi for the suggestion.)
It also includes some opportunistic rejoining of hard wrapped lines.
Staged:
http://192.241.195.202:9000/staging/DOCS-919-5-envvar-cmd-links/linux/reference/minio-mc-admin/mc-admin-config.html
http://192.241.195.202:9000/staging/DOCS-919-5-envvar-cmd-links/linux/reference/minio-server/minio-server.html
2023-08-23 14:40:09 -06:00
34cf55934a
Updates for several July 2023 mc releases ( #964 )
...
mc RELEASE.2023-07-18T21-05-38Z
- Replaces mc replicate diff with mc replicate backlog
- Adds mc support top net
mc RELEASE.2023-07-07T05-25-51Z
- Adds mc support perf site-replication
- Deprecates mc admin replicate --sync flag in favor of new mc admihn
replicate --mode flag
- Updates output example of mc admin user info to show authentication
info
Partially addresses #930
2023-08-22 13:54:51 -05:00
f05a8aae32
Updates for RELEASE.2023-07-18T17-49-40Z ( #962 )
...
- Adds information about 3 attempts at site or bucket replication tasks
- Adds note about additional info for delete markers
- Updates mc admin info command example output
Partially addresses #931 .
Not staged, but can do if needed.
2023-08-21 13:07:36 -05:00
ac72345962
DOCS-898: Synchronous Bucket Notifications, config API secret redaction ( #960 )
...
Closes #898
- Adds a short section on synchronous vs asynchronous bucket
notifications
- Adds a note on specific configs which now return redacted data on `mc
admin config get`
- Found a few new webhook lambda envvars to add
2023-08-21 11:19:20 -04:00
20644952de
Grafana and metric updates ( #953 )
...
- Adds a new page for Grafana to overview.
- Replaces the list of metrics in the Metrics and Alerts page with an
include to pull the list of metrics maintained in GitHub.
- Removes use of the :metric: role throughout the docs.
- Adds note about the introduction of a new bucket metric endpoint.
Partially addresses #930
Partially addresses #931
Partially addresses #898
Closes #864
Staged:
-
http://192.241.195.202:9000/staging/grafana/operations/monitoring/grafana.html
-
http://192.241.195.202:9000/staging/grafana/operations/monitoring/grafana.html
2023-08-17 09:01:46 -05:00
389d338b6f
Remove sts_expiry, username_format; add srv_record_name ( #947 )
...
Remove long-gone LDAP settings and add docs for a recent one.
Gone:
- `sts_expiry`, `MINIO_IDENTITY_LDAP_STS_EXPIRY`
- `username_format`, `MINIO_IDENTITY_LDAP_USERNAME_FORMAT`
- Username-Bind mode
Related code change: https://github.com/minio/minio/pull/13165
Recent:
- `srv_record_name` for lookup via DNS SVR records
Added in https://github.com/minio/minio/pull/16201
RELEASE.2022-12-12T19-27-27Z
Staged:
http://192.241.195.202:9000/staging/DOCS-919-2-svc-record/linux/html/reference/minio-server/minio-server.html#envvar.MINIO_IDENTITY_LDAP_SRV_RECORD_NAME
http://192.241.195.202:9000/staging/DOCS-919-2-svc-record/linux/html/reference/minio-mc-admin/mc-admin-config.html#mc-conf.identity_ldap.srv_record_name
2023-08-10 18:53:20 -06:00
8f598693f0
Updated LDAP docs ( #939 )
...
Update the AD/LDAP configuration instructions, including adding details
about configuring with Console.
Includes reformatting some existing content.
Questions:
- What, exactly, is the status of the `mc admin config identity_ldap`
settings? Deprecated? There, but not recommended for new configurations?
- Are the "all settings" examples correct and appropriate? I'm not clear
if `mc idp ldap` supports the same settings with the same names as
`identity_ldap`.
Staged:
http://192.241.195.202:9000/staging/DOCS-919/linux/html/operations/external-iam/configure-ad-ldap-external-identity-management.html
Fixes https://github.com/minio/docs/issues/919
---------
Co-authored-by: Ravind Kumar <ravind@min.io >
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-08-10 09:44:12 -06:00
2ab9e51d34
Updates NATS notification docs to point to JetStream service ( #937 )
...
Streaming configs and envvars are deprecated.
Closes #903
2023-08-04 14:07:02 -05:00
6e3d3c56ae
Document audit kafka queue config/envvars ( #926 )
...
Add audit_kafka `queue_dir`, `queue_size`, and their corresponding
envvars.
See https://github.com/minio/docs/issues/886 and
https://github.com/minio/docs/pull/906 for related updates.
Staged:
http://192.241.195.202:9000/staging/DOCS-860-part-n/linux/html/reference/minio-server/minio-server.html#envvar.MINIO_AUDIT_KAFKA_QUEUE_DIR
http://192.241.195.202:9000/staging/DOCS-860-part-n/linux/html/reference/minio-mc-admin/mc-admin-config.html#mc-conf.audit_kafka.queue_dir
Fixes https://github.com/minio/docs/issues/860 (final item)
2023-07-20 14:03:44 -06:00
2c172e8bde
oops missing commit for DOCS-830: data compression ( #920 )
...
See https://github.com/minio/docs/pull/915
---------
Co-authored-by: Klaus Post <klauspost@gmail.com >
2023-07-17 12:59:58 -06:00
bb1600952e
Data compression docs ( #915 )
...
Document data compression, including security concerns with encrypting
compressed objects.
Staged:
http://192.241.195.202:9000/staging/DOCS-830/linux/html/administration/object-management/data-compression.html
http://192.241.195.202:9000/staging/DOCS-830/linux/html/reference/minio-mc-admin/mc-admin-config.html#data-compression
http://192.241.195.202:9000/staging/DOCS-830/linux/html/reference/minio-server/minio-server.html#data-compression
---------
Co-authored-by: Klaus Post <klauspost@gmail.com >
2023-07-17 12:33:15 -06:00
0a1006711d
TASK: Include config backup prereq for decom and rebalance
2023-07-10 17:35:45 -04:00
c6b87ee0ee
Fixing multiple issues ( #906 )
...
DOCS-902: Add "M' and "Mi" units to --limit-upload and --limit-download
DOCS-895: Take Bucket/IAM snapshot before site replication config
DOCS-886: Add audit_kafka config settings and envvars.
2023-06-30 16:06:48 -04:00
9302e4fd86
ftp call type for mc admin trace ( #905 )
...
New `ftp` call type for `mc admin trace`.
Fixes https://github.com/minio/docs/issues/879
2023-06-30 09:34:26 -06:00
f5643ea7a5
mc ping --exit and mc admin user svcacct add/edit --expiry ( #901 )
...
Doc updates from [mc
RELEASE.2023-05-30T22-41-38Z](https://github.com/minio/docs/issues/870 ):
[x] New --exit option for mc ping
[x] Expiration date can be set when adding or editing a service account
Staged:
http://192.241.195.202:9000/staging/DOCS-870/linux/html/reference/minio-mc/mc-ping.html#mc.ping.-exit
http://192.241.195.202:9000/staging/DOCS-870/linux/html/reference/minio-mc-admin/mc-admin-user-svcacct-add.html#mc.admin.user.svcacct.add.-expiry
http://192.241.195.202:9000/staging/DOCS-870/linux/html/reference/minio-mc-admin/mc-admin-user-svcacct-edit.html#mc.admin.user.svcacct.edit.-expiry
Fixes https://github.com/minio/docs/issues/870
2023-06-29 15:11:52 -06:00
c45ac2b0f1
DOCS-867: MINIO Server Release.2023-05-27T05-56-19Z ( #904 )
...
Partially addresses DOCS-898: MINIO Server RElease.2023-06-23T20-26-00Z
2023-06-29 16:50:46 -04:00
a6aa72c7d8
Fix docs for gateway/filesystem deployment migration ( #894 )
...
The instructions to migrate a MinIO Gateway or filesystem mode
deployment are incorrect. Separate out the steps that differ for each
into tabs and clean up where needed. Several migration steps for
filesystem mode don't apply to gateway, and tiers don't apply to either.
Staged:
http://192.241.195.202:9000/staging/DOCS-818/linux/html/operations/install-deploy-manage/migrate-fs-gateway.html
Fixes https://github.com/minio/docs/issues/818
2023-06-29 14:46:43 -06:00
45d18ddef8
Docs 860 part2: persistant queues ( #883 )
...
Docs updates for persistent queues added in
https://github.com/minio/minio/pull/17121
Kafka bit needs additional attention, see
https://github.com/minio/docs/issues/886
Staged:
http://192.241.195.202:9000/staging/DOCS-860-part2/linux/html/reference/minio-server/minio-server.html#logging
http://192.241.195.202:9000/staging/DOCS-860-part2/linux/html/reference/minio-mc-admin/mc-admin-config.html#http-webhook-log-target
Partly addresses https://github.com/minio/docs/issues/860
2023-06-19 09:56:14 -06:00
afc7a03071
Docs 860 part1: max policy document size, webhook metrics ( #882 )
...
Docs updates for two items from [MinIO
RELEASE.2023-05-18T00-05-36Z](https://github.com/minio/docs/issues/860 ):
* Max policy size of 2KiB for service accounts
I _think_ this change now means json policy documents have the same max
size in all cases. The limit wasn't documented previously. This change
adds max size info throughout, not only for service accounts.
* Webhook usage metrics
Staged:
http://192.241.195.202:9000/staging/DOCS-860-part1/linux/html/reference/minio-mc-admin/mc-admin-user-svcacct-add.html
http://192.241.195.202:9000/staging/DOCS-860-part1/linux/html/reference/minio-mc-admin/mc-admin-user-svcacct-edit.html
http://192.241.195.202:9000/staging/DOCS-860-part1/linux/html/reference/minio-mc-admin/mc-admin-policy-create.html
http://192.241.195.202:9000/staging/DOCS-860-part1/linux/html/administration/identity-access-management/policy-based-access-control.html#policy-document-structure
Partly addresses https://github.com/minio/docs/issues/860
---------
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-06-14 15:32:03 -06:00
c840f368f4
mc admin user info: view inherited policies from groups ( #878 )
...
Remaining item from https://github.com/minio/docs/issues/866 :
`mc admin user info --JSON` includes the policies the user inherited
from their group membership in the `memberOf` property.
Staged:
http://192.241.195.202:9000/staging/DOCS-866-mc-admin-user-info/linux/html/reference/minio-mc-admin/mc-admin-user-info.html
Fixes https://github.com/minio/docs/issues/866
---------
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-06-12 13:34:57 -06:00
874b56eaeb
Partial update for mc RELEASE.2023-05-26T23-31-54Z ( #877 )
...
Update reference docs for recent changes:
* `mc admin user svcacct ls` service account expiration date
* `mc ilm rule ls` `updateAt` policy mod time
Staged:
http://192.241.195.202:9000/staging/DOCS-866/linux/html/reference/minio-mc-admin/mc-admin-user-svcacct-list.html
file:///Users/andrealongo/repos/docs/build/DOCS-866/linux/html/reference/minio-mc/mc-ilm-rule-ls.html#show-policy-modification-time
Partially addresses https://github.com/minio/docs/issues/866
2023-06-09 14:51:19 -06:00
4c735072f7
Move reference docs for mc admin idp commands to mc idp ( #873 )
...
All the `mc admin idp *` commands have been renamed `mc idp *`.
Deprecate everything under `mc admin idp` and create pages for their new
names in the MinIO Client section.
Affects the following commands and subcommands;
* `mc admin idp ldap`
* `mc admin idp openid`
* `mc admin idp ldap policy`
The new pages maintain the existing content and page structure. New
pages for each subcommand are out of scope for this PR.
Partly addresses https://github.com/minio/docs/issues/859 and
https://github.com/minio/docs/issues/866
Staged:
http://192.241.195.202:9000/staging/DOCS-859-part-2-idp/linux/html/reference/minio-mc.html
http://192.241.195.202:9000/staging/DOCS-859-part-2-idp/linux/html/reference/minio-mc-admin.html
http://192.241.195.202:9000/staging/DOCS-859-part-2-idp/linux/html/reference/minio-mc-deprecated.html
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-06-08 11:58:22 -06:00
7f200b96b6
Correcting build warning messages ( #875 )
...
This corrects several build errors that had accrued in the docs.
2023-06-07 15:01:25 -05:00
626e4e4f32
svcacct doc updates from RELEASE.2023-05-18T16-59-00Z ( #868 )
...
Doc updates for `mc admin user svcacct add` and `edit`.
* `--comment` replaced with `--user` and `--description` for `add` and
`edit`.
* Add detail on length of autogenerated keys. Autogeneration was already
documented, the included change is a bug fix.
Partly addresses https://github.com/minio/docs/issues/859
---------
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-06-02 14:00:08 -06:00
a6d554acdc
DOCS-807, DOCS-846, Misc. Bug fixes ( #861 )
...
Closes #807
Closes #846
---------
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com >
2023-05-23 17:29:48 -04:00
79e55b4d90
DOCS-845: Updates for MinIO Server RELEASE.2023-05-04T21-44-30Z ( #852 )
...
Closes #845
Staged: http://192.241.195.202:9000/staging/DOCS-845/linux/index.html
2023-05-17 17:38:27 -04:00
947b16155a
Updates docs of mc release RELEASE.2023-04-12T02-21-51Z ( #850 )
...
- Adds info to `mc ilm restore` about using `mc stat`
- Adds additional flag to `mc admin replicate update` syntax
- Adds metadata tags flags to `mc find`, plus examples
Closes #815
2023-05-12 11:36:19 -05:00
3f6b8ea57d
DOCS-780: Bug Stomping ( #844 )
...
A few big things here:
- Updated to Sphinx 6.2.1 successfully. I'm using Python 3.10.10
- Upgraded to docutils 0.19, which is latest
- Upgrade myst-parser and sphinx-design to latest stable
- Fixed a bunch of warning outputs
2023-05-11 16:57:03 -04:00
363e688617
Updates for MinIO RELEASE.2023-04-07T05-28-58Z ( #823 )
...
- Adds new environment variable for ILM expiration workers
- Adds new metrics for locks
- Adds keyrotate batch job type
- Adds info about batch replicate from remote to local
Closes #806
Staged:
http://192.241.195.202:9000/staging/minio-2023-04-07/administration/batch-framework.html
2023-05-01 16:42:13 -05:00
1c5454955b
Expand the mc admin user docs ( #836 )
...
Restructure the existing `mc admin user` page into separate pages for
each subcommand. Also add missing details and correct errors.
Staged:
http://192.241.195.202:9000/staging/DOCS-785/linux/html/reference/minio-mc-admin/mc-admin-user.html
Fixes https://github.com/minio/docs/issues/785
2023-04-28 14:03:11 -06:00
8721671838
Only mc admin update might need sudo ( #829 )
...
`sudo` note from https://github.com/minio/docs/pull/822 really should
only apply to `mc admin update`. Add there and remove from the common
include.
Staged
http://192.241.195.202:9000/staging/remove-excessive-sudo-note/linux/html/reference/minio-mc-admin/mc-admin-update.html
2023-04-21 15:51:15 -06:00
ea85cce9a9
New flag to set site replication to synchronous ( #826 )
...
Document new flag for `mc admin replicate update` to enable/disable
synchronous site replication. Continue to recommend default async
replication due to increased write latency with sync.
Adapt/reuse the existing description of async vs sync from bucket
replication as an include.
Staged
http://192.241.195.202:9000/staging/DOCS-790/linux/html/operations/install-deploy-manage/multi-site-replication.html#synchronous-vs-asynchronous-replication
http://192.241.195.202:9000/staging/DOCS-790/linux/html/reference/minio-mc-admin/mc-admin-replicate.html#syntax
http://192.241.195.202:9000/staging/DOCS-790/linux/html/administration/bucket-replication.html#synchronous-vs-asynchronous-replication
Fixes https://github.com/minio/docs/issues/790
2023-04-20 15:54:05 -06:00
579540ae5c
Updates for MinIO RELEASE.2023-04-13T03-08-07Z ( #824 )
...
- Adds example output to mc admin info command
- Adds new metric
Closes #814
2023-04-19 18:30:10 -05:00
d91d752273
Adds notes about expiration output for some mc commands ( #819 )
...
Adds info to `mc admin user svcacct` and `mc admin user sts` about
exposing expiration for accounts.
Fixes some build errors from the troubleshooting doc.
Closes #786
2023-04-14 15:45:21 -05:00
2d900caa0f
Adds new proxy argument webhook logger configuration. ( #810 )
...
Closes #745
Also adds three other missing arguments for the webhook logger
configuration.
2023-04-12 12:28:47 -05:00
8caa50e3d1
General work on releases ( #797 )
...
Closes #750
Closes #736
Partially Address #767
2023-04-10 16:03:13 -04:00
