The Command Line
- The Minimum
- java -jar Zoe.jar
- The prototype
- java [-Dsystem.property=propertyValue] -jar Zoe.jar [command]
Using Commands
These following commands are used in the format:
- java -jar Zoe.jar command
Example
To toggle debugging(from on to off, or from off to on):
- java -jar Zoe.jar debug
Commands Available
| Command | Description |
| shutdown | shutdown a running application |
| debug | to turn on/off debugging. You can pass this to Zoe while it's running to toggle debugging on and off at any point. |
| check | to run an integrity check on the data storage. |
| checkAll | to check on ALL user identities |
| optimize | to optimize the data storage. |
| optimizeAll | to optimize on ALL user identities |
| rebuild | to rebuild the entire data storage In the process this will also generate new permanent links for each e-mail. Note that any messages marked as 'deleted' will also be re-incorporated into the index. Use purge or purgeAll first if you want to permanently remove mail marked as deleted. |
| rebuildAll | to rebuild on ALL user identities |
| clean | recreate the indices and storages based on their current content. (Much quicker than a rebuild) |
| cleanAll | to clean on on ALL user identities |
| daemon | used at ZOE startup to keep ZOE from launching a browser. |
| reset | reset the password and print out a new one. |
| process | Good Question |
| purge | should remove deleted messages (rather than just not displaying them) |
| purgeAll | to purge on ALL user identities |
Q: How Do I Use The Command Line Options?
A: In the directory containing the zoe.jar file, simply append the required option like so...
java -jar zoe.jar clean
Run Zoe with more memory
The memory available to Zoe depends on your Java setup. To give the JVM more memory to run Zoe try something like:
- java.exe -Xms512m -Xmx1024m -jar zoe.jar
where the
ms value represents the allocation at startup and
mx the maximum.
Create another identity
A user is automatically created based on the default Java "user.name" property. This being a property, you can overwrite it from the command line. To create a random user, you will need to run the app from the command line with the appropriate arguments. For example:
- java -Duser.name=RandomUserName -jar Zoe.jar
This will create a "RandomUserName" identity. Enable login for this user and you are done. Repeat the process as many time as necessary. You will need to do that only once per user.
For each user, a different data store will be created, keeping all the emails strictly separated.
references: [1] [2]
In general, most of the commands only apply to one identity, either the default or the specified identity. However, the commands ending with 'All' automatically get applied to all identities.
Load ZOE with a different configuration
To load the configuration from your "myConfig" folder
- java -Dconfiguration.name=myConfig -jar Zoe.jar
For more information about using multiple configurations, see
System Configuration/Multiple Configurations
Preferences