en:user_advanced:gs3_user_management
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
en:user_advanced:gs3_user_management [2021/09/21 02:27] – [Command line editing] kjdon | en:user_advanced:gs3_user_management [2021/09/21 02:56] – [Viewing and Editing the database via a text file] kjdon | ||
---|---|---|---|
Line 14: | Line 14: | ||
Admin can register a new user by visiting the admin page: http:// | Admin can register a new user by visiting the admin page: http:// | ||
- | ===== Command line editing | + | ===== User Groups |
- | **ant config-admin** - reset the admin password | + | Groups are used to determine what functionality a user is provided. Multiple groups are specified in a comma-separated list. |
+ | |||
+ | **administrator** - can do user management\\ | ||
+ | **all-collections-editor** - can edit any collection (through web editing or through remote GLI)\\ | ||
+ | **personal-collections-editor** - the user can create their own collections and edit them\\ | ||
+ | **< | ||
+ | |||
+ | Bespoke groups can be added then used in security elements in individual collections, | ||
+ | ===== Command line editing of users ===== | ||
+ | |||
+ | **ant config-admin** - reset the admin password\\ | ||
**ant config-user** - add or edit users. This requires you to provide all user fields: username, password, groups, status, comment, email. They can be left blank, but it will override any previous values in the db. | **ant config-user** - add or edit users. This requires you to provide all user fields: username, password, groups, status, comment, email. They can be left blank, but it will override any previous values in the db. | ||
- | Or you can directly use the java class. | + | Or you can directly use the java class.\\ |
- | Make sure you have 'source gs3-setup.sh' | + | Make sure you have set up the Greenstone environment by running **source gs3-setup.sh** (linux/Mac) or **gs3-setup.bat** (windows). Also, start the derby server if its not already running: |
- | **ant start-derby** | + | |
< | < | ||
java org.greenstone.gsdl3.util.ModifyUsersDB | java org.greenstone.gsdl3.util.ModifyUsersDB | ||
- | Usage: java org.greenstone.gsdl3.ModifyUsersDB < | + | Usage: java org.greenstone.gsdl3.ModifyUsersDB < |
+ | [password=pwd] [groups=grp] [addgroups=grp] [accounstatus=status] [comment=cmt] [email=address] | ||
</ | </ | ||
(Options valid for releases from September 2021) | (Options valid for releases from September 2021) | ||
+ | |||
Eg: To add a new user | Eg: To add a new user | ||
- | java org.greenstone.gsdl3.ModifyUsersDB < | + | < |
- | The 'groups' | + | The **groups** option will set the group field to the specified value.\\ |
- | The 'addgroups' | + | The **addgroups** option will add the specified groups to whatever groups exist already (if editing an existing user) |
- | Using username | + | Using username |
For example, to add the ' | For example, to add the ' | ||
- | java org.greenstone.gsdl3.ModifyUsersDB < | + | < |
- | TODO: | + | The **-noAdd** option will **not** create |
- | | + | |
- | * User groups | + | ==== Viewing and Editing |
- | | + | |
+ | There are 2 java programs which help you view and edit the database: usersDB2txt and txt2usersDB | ||
+ | As above, you must set up the greenstone environment, | ||
+ | |||
+ | They are run like: | ||
+ | < | ||
+ | java org.greenstone.gsdl3.util.usersDB2txt < | ||
+ | |||
+ | ... edit the file if necessary, then regenerate the DB: | ||
+ | |||
+ | java org.greenstone.gsdl3.util.txt2usersDB usersDB.txt < | ||
+ | </ | ||
+ | The **-append** option means append the contents of the file into the DB. Without it, the current contents will be deleted. | ||
==== Setting up the Recaptcha test for User Registration ==== | ==== Setting up the Recaptcha test for User Registration ==== |
en/user_advanced/gs3_user_management.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1