Skip to content

Commit 6ec7d0d

Browse files
adobeDanadobeDan
authored
Merge pull request #226 from adobe-apiplatform/v2
final changes for 2.1.1 release
2 parents 9da33d4 + 6ebe846 commit 6ec7d0d

17 files changed

+111
-5
lines changed

‎README.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@ Copyright (c) 2016-2017 Adobe Systems Incorporated.
1313
# Quick Links
1414

1515
- [User Sync Overview](https://www.adobe.io/apis/cloudplatform/usermanagement/docs/UserSyncTool.html)
16-
- [User Manual](https://adobe-apiplatform.github.io/user-sync.py/user-manual/)
17-
- [Step-by-Step Setup](https://adobe-apiplatform.github.io/user-sync.py/success-guide/)
16+
- [User Manual](https://adobe-apiplatform.github.io/user-sync.py/en/user-manual/)
17+
- [Step-by-Step Setup](https://adobe-apiplatform.github.io/user-sync.py/en/success-guide/)
1818
- [Non-Technical Overview](https://spark.adobe.com/page/E3hSsLq3G1iVz/)
1919

2020

@@ -60,7 +60,7 @@ To set up PyCharm for debugging,
6060

6161
# Basic Usage
6262

63-
##User Sync command line
63+
## User Sync command line
6464

6565

6666
| Parameters and argument specifications | Description |
@@ -75,6 +75,8 @@ To set up PyCharm for debugging,
7575
| `--process-groups` | When supplied, synchronizes group membership information. If the membership in mapped groups differs between the enterprise directory side and the Adobe side, the group membership is updated on the Adobe side to match. This includes removal of group membership for Adobe users not listed in the directory side (unless the `--adobe-only-user-action exclude` option is also selected).|
7676
| `--adobe-only-user-action preserve`<br />`--adobe-only-user-action remove-adobe-groups`<br />`--adobe-only-user-action remove`<br />`--adobe-only-user-action delete`<br /><br/>`--adobe-only-user-action write-file`&nbsp;filename<br/><br/>`--adobe-only-user-action exclude` | When supplied, if user accounts are found on the Adobe side that are not in the directory, take the indicated action. <br/><br/>`preserve`: no action concerning account deletion is taken. This is the default. There may still be group membership changes if the `--process-groups` option was specified.<br/><br/>`remove-adobe-groups`: The account is removed from user groups and product configurations, freeing any licenses it held, but is left as an active account in the organization.<br><br/>`remove`: In addition to remove-adobe-groups, the account is also removed from the organization, but is left as an existing account.<br/><br/>`delete`: In addition to the action for remove, the account is deleted if owned by the organization.<br/><br/>`write-file`: the list of user account present on the Adobe side but not in the directory is written to the file indicated. No other account action is taken. You can then pass this file to the `--adobe-only-user-list` argument in a subsequent run.<br/><br/>`exclude`: No update of any kind is applied to users found only on the Adobe side. This is used when doing updates of specific users via a file (--users file f) where only users needing explicit updates are listed in the file and all other users should be left alone.<br/><br>Only permitted actions will be applied. Accounts of type adobeID are owned by the user so the delete action will do the equivalent of remove. The same is true of Adobe accounts owned by other organizations. |
7777
| `adobe-only-user-list` _filename_ | Specifies a file from which a list of users will be read. This list is used as the definitive list of "Adobe only" user accounts to be acted upon. One of the `--adobe-only-user-action` directives must also be specified and its action will be applied to user accounts in the list. The `--users` option is disallowed if this option is present: only account removal actions can be processed. |
78+
| `--config-file-encoding` _encoding_name_ | Optional. Specifies the character encoding for the contents of the configuration files themselves. This includes the main configuration file, "user-sync-config.yml" as well as other configuration files it may reference. Default is `ascii`. Character encoding in the user source data (whether csv or ldap) is declared by the connector configurations, and that encoding can be different than the encoding used for the configuration files (e.g., you could have a latin-1 configuration file but a CSV source file that uses utf-8 encoding). The available encodings are dependent on the Python version used; see the documentation [here](https://docs.python.org/2.7/library/codecs.html#standard-encodings) for more information. |
79+
7880

7981
# Configuration
8082

‎RELEASE_NOTES.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Release Notes for User Sync Tool Version 2.1.1
22

3-
These notes apply to v2.1.1rc1 of 2017-06-06.
3+
These notes apply to v2.1.1 of 2017-06-09.
44

55
## New Features
66

@@ -17,3 +17,9 @@ The proper packages were not present for secure credential storage on Linux plat
1717
## Compatibility with Prior Versions
1818

1919
This version is fully backwards-compatible with version 2.1.
20+
21+
There are new UMAPI config file settings in this release to enable the use of encyrpted keys, see [this section of the docs](https://adobe-apiplatform.github.io/user-sync.py/en/user-manual/deployment_best_practices.html#storing-credentials-in-os-level-storage) for full details.
22+
23+
## Known Issues
24+
25+
On the Win64 platform, due to a change in the encryption support library used by User Sync, there are very long pathnames embedded in the released build artifact `user-sync.pex`. It will likely be necessary to set the `PEX_ROOT` environment variable on Windows (as described [in the docs here](https://adobe-apiplatform.github.io/user-sync.py/en/user-manual/setup_and_installation.html)) to be a very short path (e.g., `env:$PEX_ROOT="C:\pex"`) in order to launch User Sync successfully. We hope to avoid the need for this workaround in a future release.

‎docs/success-guide/before_you_start.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/before_you_start.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/command_line_options.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/command_line_options.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/decide_deletion_policy.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/decide_deletion_policy.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/identify_server.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/identify_server.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/index.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/install_sync.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/install_sync.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/layout_orgs.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/layout_orgs.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

‎docs/success-guide/layout_products.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<html>
2+
<head>
3+
<meta http-equiv="refresh" content="0; URL='../en/success-guide/layout_products.html'" />
4+
</head>
5+
<body>
6+
</body>
7+
</html>

0 commit comments

Comments
 (0)