Can I move the Data directory to another location?

Overview

The Urchin data directory is a subdirectory of the root Urchin program directory by default. This location can easily be changed by editing the ~urchin/etc/urchin.conf file and manually moving the existing ~urchin/data directory to the desired location. It should be noted that this may break the existing license, in which case, you will need to contact support and request that your serial number is reset.

Request Support

Procedure for moving data directory:

The location of where Urchin stores its report data can be changed in the urchin.conf file, which is located in the etc directory of the main Urchin installation directory.

For UNIX-type systems:

  1. Open a command shell as the user that Urchin was installed as
  2. cd to the directory where Urchin is installed
  3. Stop the Urchin services with the command: bin/urchinctl stop
  4. Using a text editor, open the urchin.conf file in the etc directory of the Urchin distribution
  5. Uncomment the following line by removing the leading '#' character:
      #dataDirectory: ./data/
    and substitute the full directory path you want to use instead of the default directory, e.g.
      dataDirectory: /bigdisk/urchin/data/
  6. If necessary, create the new data directory. Important note: this directory must be readable and writable by the user Urchin runs as.
  7. Copy the existing data to the new location. To ensure that all permissions and data are properly preserved, it is recommended that you use the following command:
      cd data; tar cf - . | (cd /bigdisk/urchin/data; tar xpf -)
  8. Rename the data directory to data.old. You can remove it completely if you wish, but you may want to ensure that everything is working properly before doing this.
  9. chown -R urchin_user:urchin_group /bigdisk/urchin/data
  10. For ease of administration, you may want to create a symlink in the main Urchin directory pointing at this new location, e.g.
      ln -s /bigdisk/urchin/data ./data
  11. Restart the Urchin services with the command: bin/urchinctl start
  12. Log in to Urchin as the admin user. You should be presented with the License Urchin screen. Simply click on the Reactivate License link and you are finished.
For Windows systems:
  1. Stop the Urchin Services: Start->Programs->Urchin->Disable Urchin Services
  2. Open Windows Explorer and navigate to the etc folder of the Urchin distribution. By default, this is C:\Program Files\Urchin\etc
  3. Using a text editor, open the urchin.conf file
  4. Uncomment the following line by removing the leading '#' character:
      #dataDirectory: ./data/
    and substitute the drive letter and full pathname you want to use instead of the default folder, e.g.
      dataDirectory: E:\Urchin\data
  5. If necessary, create the new data folder. Important note: the permissions on this folder must allow read and write access to the Urchin service.
  6. Copy the contents of the data folder to the new folder.
  7. Rename the data folder to data.old. You can remove it completely if you wish, but you may want to ensure that everything is working properly before doing this.
  8. Restart the Urchin Services: Start->Programs->Urchin->Enable Urchin Services

Considerations

  • Due to the way licensing is implemented on UNIX-type systems to prevent tampering, moving Urchin's data directory will require the Urchin license to be reactivated. However, the relicense operation is extremely simple - you merely need to log in as the Urchin admin user and click Reactivate License.
  • Windows users who later upgrade Urchin, will have to edit the ~urchin\etc\urchin.conf file. That file is overwritten with default settings during any Urchin upgrade, so you will need to restore your custom data location settings.