| 1 | INSTALLATION
|
|---|
| 2 | Unzip the distribution in the location of your choice.
|
|---|
| 3 | On unix/linux systems, make the bin/osmosis script executable (ie. chmod u+x osmosis).
|
|---|
| 4 | If desired, create a symbolic link to the osmosis script somewhere on your path (eg. ln -s appdir/bin/osmosis ~/bin/osmosis).
|
|---|
| 5 |
|
|---|
| 6 | CONFIGURATION
|
|---|
| 7 | Common command line options can be specified in configuration files.
|
|---|
| 8 |
|
|---|
| 9 | On Linux, the file can reside in the following locations with later files overriding earlier files:
|
|---|
| 10 | /etc/osmosis
|
|---|
| 11 | $HOME/.osmosis
|
|---|
| 12 |
|
|---|
| 13 | On Windows, the file can reside in the following locations with later files overriding earlier files:
|
|---|
| 14 | %ALLUSERSPROFILE%\osmosis.bat
|
|---|
| 15 | %USERPROFILE%\osmosis.bat
|
|---|
| 16 |
|
|---|
| 17 | The following variables can be defined in these files:
|
|---|
| 18 | JAVACMD - The java command to be invoked. Default is "java".
|
|---|
| 19 | JAVACMD_OPTIONS - The java jvm options to apply (eg. -Xmx512M).
|
|---|
| 20 | OSMOSIS_OPTIONS - The osmosis options to apply (eg. -q or -plugin MyPluginLoaderClass).
|
|---|
| 21 |
|
|---|
| 22 | COMPILATION
|
|---|
| 23 | To perform a complete osmosis rebuild, the following command may be run from the osmosis root directory.
|
|---|
| 24 |
|
|---|
| 25 | ant all
|
|---|
| 26 |
|
|---|
| 27 | The "all" ant target performs all steps including creation of new distribution files, checkstyle analysis and unit tests.
|
|---|
| 28 |
|
|---|
| 29 | Sometimes old files can be left hanging around causing problems. It may be necessary to run the following command
|
|---|
| 30 | to clean up any old files.
|
|---|
| 31 |
|
|---|
| 32 | ant clean
|
|---|
| 33 |
|
|---|
| 34 | If you wish to rebuild all artefacts without running unit tests, the following command may be used.
|
|---|
| 35 |
|
|---|
| 36 | ant publish
|
|---|
| 37 |
|
|---|
| 38 | HELP
|
|---|
| 39 | Osmosis documentation is available at:
|
|---|
| 40 | http://wiki.openstreetmap.org/index.php/Osmosis
|
|---|
| 41 |
|
|---|
| 42 | Please ask any questions, report any issues, or suggest enhancements using the Open Street Map talk or development mailing lists.
|
|---|
