Configure Server Settings With Rake Tasks

Rake tasks can be used to configure and manage IBM Aspera Shares users, groups, shares, and nodes from the command line. To run a rake task, first do the following:

Go to the shares folder:
```
# cd /opt/aspera/shares/u/shares/bin
```
Test that your rake tasks are working correctly.
```
./run rake -T
```

The following rake tasks cover how to add or configure an LDAP, configure web server settings, and configure SMTP server settings.

Tip: Square brackets in usage statements denote optional arguments and need not be included when running the commands.

Add or Configure LDAP

Command	Usage
Syntax	rake data:ldap_config -- --directory_type `directory_type` --name `name` [--description `description`] --host `host` --port `port` [--base_dn `base_dn`] --authentication_method `authentication_method` [--username `username` --password `password` --encryption `encryption`]
Example	./run rake data:ldap_config -- --directory_type ActiveDirectory --name dest_dir --host ldap.aspera.us --port 1234 --base_dn OU=AsperaDirectory,DC=aspera,DC=asperasoft,DC=com --authentication_method simple --username johndoe --password ********* --encryption simple_tls

Command

Usage

Syntax

rake data:ldap_config -- --directory_type directory_type --name name [--description description] 
  --host host --port port [--base_dn base_dn] --authentication_method authentication_method 
  [--username username --password password --encryption encryption]

Example

./run rake data:ldap_config -- --directory_type ActiveDirectory --name dest_dir
  --host ldap.aspera.us --port 1234 --base_dn OU=AsperaDirectory,DC=aspera,DC=asperasoft,DC=com
  --authentication_method simple --username johndoe --password ********* --encryption simple_tls

Where acceptable directory types are:

ActiveDirectory
OpenDirectory
FedoraDirectoryServer
OpenLdap

Where acceptable authentication methods are:

anonymous
simple (Simple bind requires a username and a password.)

Where acceptable encryption types are:

unencrypted
simple_tls

Note: Encryption is, by default, set to unencrypted.

Configure Host, Port, and TLS

Command	Usage
Syntax	rake data:web_server -- --host `host` --port `port` --tls `tls`
Example	./run rake data:web_server -- --host shares.example.com --port 1234 --tls true

Configure SMTP Server

Command	Usage
Syntax	rake data:smtp_server -- --server `server` --port `port` --domain `domain` --tls `tls` --username `username` --password `password` --from `from`
Example	./run rake data:smtp_server -- --server shares.example.com --port 1234 --domain aspera.us --tls true --username johndoe --password ********* --from marysue@shares.example.com

Command

Usage

Syntax

rake data:smtp_server -- --server server --port port --domain domain --tls tls --username 
  username --password password --from from

Example

./run rake data:smtp_server -- --server shares.example.com --port 1234 
  --domain aspera.us --tls true --username johndoe --password ********* 
  --from marysue@shares.example.com

Note: The first time this task is run, it creates a new entry and requires an entry for all of the fields. Afterward, running the task again only nodifies the specified fields, leaving non-specified fields the same.

Configure Custom Logo

Command	Usage
Syntax	rake data:logo:set -- --path `/path/to/file`
Example	./run rake data:logo:set -- --path /temp/aspera_logo.jpg