You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

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

TODO:

  • Write instructions for windows as well
  • Add pages with instructions for run-export etc

Changing Your Password

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

  1. Add the bot "passwd-bot" to a new, private wave
  2. Type passwd <current password> <new password> <enter>

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

Adding an Administrator Account

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

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

  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

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.

  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.

Exporting Waves

Wave comes with means to export all of a users waves and import them into another server or just store them for backup purposes. This process doesn't have to be performed on the server itself, any user can export their waves allowing them to make their own personal backups.

  1. Download and compile Apache Wave from source
  2. In the root directory there is a run-export.sh file, make it executable using chmod +x run-export.sh
  3. Run the script by executing ./run-export.sh to see available parameters and access help

For further information on run-export.sh see: run-export.sh

  • No labels