Page History

This page contains tips for administrating a Wave in the Box instance, adapted from bash.vi

Changing Your Password

Anchor
changePword changePword

Changing your password is a simple operation which currently requires the passwd bot.#Add

1. Add the bot "passwd-bot" to a new, private wave

...

1. Type passwd <current password> <new password> <enter>

To see all the options for the passwd-bot type passwd -help <enter>

Adding an Administrator Account

Anchor
addAdmin addAdmin

By default, no admin account is set. You can define the admin account by changing the

<property name=”admin_user” value=”@${wave_server_domain}” />

variable in the server-config.xml file and regenerating the config with

ant -f server-config.xml

All you have to do is put the name of the account that should have administrator privileges in front of the @ sign.

Changing Users Passwords

Anchor
changeUserPword changeUserPword

The admin account can change the password of other users. The process is very similar to changing one’s own password:

1. Log in with your Admin user (see Adding an Administrator Account)
2. Create a new, private wave
3. Add the bot "passwdadmin-bot" to the wave
4. type passwdadmin <username> <new_password> to change a users password

To see the help for the passwdadmin-bot type passwdadmin -help <enter>

Deleting a User

Anchor
delUser delUser

1. SSH into your Wave Server
2. Stop Wave TODO: How to stop wave server?
3. Change into the Wave installation directory and then /_accounts/
4. Each file in this folder represents a user - labeled <username>@<yourdomain>.account
5. Remove the file corresponding to the correct user (rm does this on linux systems)
6. Start the Wave server again

Deleting Empty Waves

Anchor
emptyWaves emptyWaves

TODO: Write instructions for windows as well

Sometimes weird, empty waves will appears at the bottom of your inbox. The instructions that follow are potentially unsafe and should only be used if you're sure you know what you are doing.

Image Added

1. SSH into your wave server
2. Stop Wave
3. Change into the Wave installation directory and then /_deltas
4. ls will show a number of subdirectories with alphanumeric names. Each one of these represents a wave.
5. du -h * will show the size of each of these directories
6. The smallest ones (~20K) are likely to be the empty waves (back them up with tar cfv ../backup.tar <directory1> <directory2>)
7. Delete these small directories
8. Start the Wave Server

Log back in and wait for Wave index to be regenerated, if the incorrect waves are deleted restore them from the backups you created.
Once again, this procedure is potentially unsafe and you should only attempt it if you are confident and have a backup.