Mercury on USB

From MercuryWiki

Jump to: navigation, search

This page explains how to get Mercury running from a USB stick. The settings (including chat logs, incoming files, etc...) will be saved in the program folder on the USB stick. This way everything remains on you USB stick.

Advanced Use (Testing): This same method of running Mercury can be used for testing purposes or if you simply wish to have different Mercury installations, each with their own settings folder. The settings folder will still be saved in the program folder, but the program folder doesn't have to be on a USB stick. It can be anywhere on your hard drive. To do this, you can follow the instructions below, substituting the USB stick with the location you wish your program folder to be installed to.

Contents

[edit]

Mercury 2.0 Unstable

[edit]

Linux

  1. With USB startup script (recommended):
    • Copy the program folder from an existing Mercury installation to your USB stick
    • Use the startup script startup_linux_usbtest.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
  2. With Locations.xml:
    Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.
    • Copy the program folder from an existing Mercury installation to your USB stick
    • Open the mercury program directory/resources/config/Locations.xml in a text editor
    • Locate the Location entry with name userdir.mercury and change the LinuxValue to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the LinuxValue to "(prog.dir)/settings" or something similar)
    • Save the Locations.xml file
    • Use the startup script startup_linux.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
      • Advanced: If the Locations.xml file you changed is from the Mercury installation you installed normally (this would most likely be installed to /usr/share/mercury), you can still use your normal methods or running mercury (e.g. typing mercury from the console)
[edit]

Mac OS X

A Mercury application for use on a USB stick can be made where the only difference with a normal release is a different path in the Locations.xml. So far there has been no need for it. To change the Locations.xml, do the following:
Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.

  • Copy an existing Mercury installation to your USB stick
  • Right mouse click Mercury, choose Show Contents
  • Move to Contents/Resources/Java/resources/config/
  • Open Locations.xml in a text editor
  • Locate the Location entry with name userdir.mercury and change the MacValue to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the MacValue to "(prog.dir)/settings" or something similar)
  • Save the Locations.xml file
  • Double-click the application on your USB stick to run Mercury
[edit]

Windows

  1. With Mercury executable (recommended):
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Download the USB Launcher
      • Possible windows launcher program arguments can be found here
    • Place the USB Launcher in the Mercury program folder on your USB stick (this will be the location on your USB stick you selected during installation)
    • Double-click the USB Launcher to start Mercury
  2. With USB startup script:
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Use the startup script startup_windows_usbtest.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
  3. With Locations.xml:
    Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Open the mercury program directory/resources/config/Locations.xml in a text editor
    • Locate the Location entry with name userdir.mercury and change the Value to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the Value to "(prog.dir)/settings" or something similar)
    • Save the Locations.xml file
    • Run Mercury normally as described here
[edit]

Mercury 1.9 Stable

[edit]

Linux

  1. With USB startup script (recommended):
    • Copy the program folder from an existing Mercury installation to your USB stick
    • Use the startup script startup_linux_usbtest.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
  2. With Locations.xml:
    Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.
    • Copy the program folder from an existing Mercury installation to your USB stick
    • Open the mercury program directory/resources/config/Locations.xml in a text editor
    • Locate the Location entry with name userdir.mercury and change the LinuxValue to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the LinuxValue to "(prog.dir)/settings" or something similar)
    • Save the Locations.xml file
    • Use the startup script startup_linux.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
      • Advanced: If the Locations.xml file you changed is from the Mercury installation you installed normally (this would most likely be installed to /usr/share/mercury), you can still use your normal methods or running mercury (e.g. typing mercury from the console)
[edit]

Mac OS X

A Mercury application for use on a USB stick can be made where the only difference with a normal release is a different path in the Locations.xml. So far there has been no need for it. To change the Locations.xml, do the following:
Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.

  • Copy an existing Mercury installation to your USB stick
  • Right mouse click Mercury, choose Show Contents
  • Move to Contents/Resources/Java/resources/config/
  • Open Locations.xml in a text editor
  • Locate the Location entry with name userdir.mercury and change the Value to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the Value to "(prog.dir)/settings" or something similar)
  • Save the Locations.xml file
  • Double-click the application on your USB stick to run Mercury
[edit]

Windows

  1. With Mercury executable (recommended):
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Download the USB Launcher
      • Possible windows launcher program arguments can be found here
    • Place the USB Launcher in the Mercury program folder on your USB stick (this will be the location on your USB stick you selected during installation)
    • Double-click the USB Launcher to start Mercury
  2. With USB startup script:
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Use the startup script startup_windows_usbtest.sh from mercury program directory/startup to run Mercury.
      For easier use, create a link to this script on your desktop or some other convenient location.
  3. With Locations.xml:
    Note: during an update, the Locations.xml file usually gets replaced as well, so you will need to do this after every update.
    • Follow the installation instructions to install Mercury to a location on your USB stick
    • Open the mercury program directory/resources/config/Locations.xml in a text editor
    • Locate the Location entry with name userdir.mercury and change the Value to the new directory you wish your settings to be kept in. (this can be any location, but if you wish to keep your settings in the same folder as the program, change the Value to "(prog.dir)/settings" or something similar)
    • Save the Locations.xml file
    • Run Mercury normally as described here
Retrieved from "http://wiki.mercury.im/index.php?title=Mercury_on_USB"