An overview of the commands offered by the psono server

Commands

The psono server offers some commands:

cleartoken

Clears all expired tokens

python3 ./psono/manage.py cleartoken

(usually executed in a cronjob)

createuser

Creates a user with a given username, password and email

python3 ./psono/manage.py createuser [email protected] myPassword [email protected]

(usually executed by developers when they want to create a new user for testing)

deleteuser

Deletes a user with a given username

python3 ./psono/manage.py deleteuser [email protected]

(usually executed by developers when they want to cleanup after testing, or want to try again with a fresh user)

disableuser

Disables a user. The user won’t be able to login anymore.

python3 ./psono/manage.py disableuser [email protected]

enableuser

Enables a user. The user will be able to login again.

python3 ./psono/manage.py enableuser [email protected]

fsclustercreate

Creates a cluster. Takes a title of the cluster as argument.

python3 ./psono/manage.py fsclustercreate "Default Cluster"

fsclusterdelete

Deletes a cluster. Takes the id of a cluster as argument

python3 ./psono/manage.py fsclusterdelete 1713b68b-df64-41c5-822c-6eb8c877037c

fsclusterlist

Lists all configured clusters

python3 ./psono/manage.py fsclusterlist

fsclustershowconfig

Creates the configuration of a potential cluster member for a cluster. Takes the id of a cluster as argument.

python3 ./psono/manage.py fsclustershowconfig 1713b68b-df64-41c5-822c-6eb8c877037c

fsshardcreate

Creates a shard with a title and a description as argument

python3 ./psono/manage.py fsshardcreate "Some Title" "Some description"

(The title will be later visible to the user if multiple shards are available, so the user can pick one)

fssharddelete

Deletes a shard. Takes the id of the shard that should be deleted as argument.

python3 ./psono/manage.py fssharddelete a8a1176c-bad8-4b84-b45e-1084b3a48e7d

Links a shard and a cluster together, allowing fileservers that belong to a cluster to announce their availability to serve a shard. Takes the cluster id and the shard id as arguments and in addition the permissions (e.g. rw for read and write)

python3 ./psono/manage.py fsshardlink 1713b68b-df64-41c5-822c-6eb8c877037c a8a1176c-bad8-4b84-b45e-1084b3a48e7d rw

fsshardlist

Lists all configured shards.

python3 ./psono/manage.py fsshardlist

Destroys the link between a shard and a cluster, preventing fileservers of this clusters to announce this shard. Takes the ID of the link as argument.

python3 ./psono/manage.py fsshardunlink c8916ab1-4a22-4aa6-9549-c0b15f688e7c

promoteuser

Promotes a user and grants superuser privilege (or other roles)

python3 ./psono/manage.py promoteuser [email protected] superuser

demoteuser

Demotes a user and revokes superuser privilege (or other roles)

python3 ./psono/manage.py demoteuser [email protected] superuser

verifyuseremail

Marks the email of a user as verified

python3 ./psono/manage.py verifyuseremail [email protected]

generateserverkeys

Generates some new server keys for the settings.yaml

python3 ./psono/manage.py generateserverkeys

(usually executed only once during the installation phase)

presetup

If the database user has the necessary permission this command will install the necessary postgres extensions ltree and pgcrypto.

python3 ./psono/manage.py presetup

(usually executed only once during the installation phase)

sendtestmail

Sends a test email to the given email address.

python3 ./psono/manage.py sendtestmail [email protected]

(usually executed only during installation, to test if the email configuration is correct)

testduoconnection

Tests your DUO connection with a given integration key, secret key and host.

python3 ./psono/manage.py testduoconnection DI... lt... api-XXXXXXX.duosecurity.com

(usually executed only during installation, to test if the system wide DUO configuration is correct)

You can also specify an additional username. This will test PUSH authentication with the user.

python3 ./psono/manage.py testduoconnection DI... lt... api-XXXXXXX.duosecurity.com [email protected]

(In the example above the username in DUO would be “something”, so everything before the “@”.)

testldap

Tests your LDAP connection (EE Version only)

python3 ./psono/manage.py testldap [email protected] thePassWord

(usually executed only during installation, to test if the LDAP configuration is correct)

testsaml

Tests your SAML connection (EE Version only)

python3 ./psono/manage.py testsaml

(usually executed only during installation, to test if the SAML configuration is correct)

Edit me
Tags: server