This article will explain how to move the local ARTBUTLER database of a single user installation to a new computer, as well as how to replace the database from a back-up version. If you are using the ARTBUTLER server in a multiple-user setup, please see our article on how to migrate your ARTBUTLER server instead.
If you are unsure about your installation type, please check the artbutler > Preferences > Database setting: if the Server field is empty you are using a local database, in any other case a server is used.
Guide for Mac OS X
- In ARTBUTLER, create a backup of your database. Go to artbutler > Backup and copy it to your new computer.
- The image and template folders have to be copied to the new computer as well. If you are not sure where these folders are stored, please refer to artbutler > Preferences > Local.
- Install ARTBUTLER on the new machine and start it for a first time. You will have to temporarily set up the base currency and a first user to create an empty database, that will be replaced in the next steps.
- After installing ARTBUTLER successfully, please close it again to proceed. Locate the database folder by choosing the Finder’s Go > Go to Folder … menu command and paste the following text into the dialogue:
/Users/<your user name>/Library/Application Support/artbutler/databases/ArtbutlerDBHSQL/
The folder with the database file will be opened: it contains the database files database.script and database.properties. - Double-click the backup file from step 1 to unzip it and rename the included files from artbutler.script and artbutler.properties to database.script and database.properties. Finally replace the files in the database folder from the previous step with the files from the backup.
- Your data from the old computer is now available on this computer when you start ARTBUTLER again. In a last step, please set up the image and template folders you copied to the new computer for ARTBUTLER – just select them on the artbutler > Preferences > Local tab.
Guide for MS Windows
- In ARTBUTLER, create a backup of your database. Go to artbutler > Backup and copy it to your new computer.
- The image and template folders have to be copied to the new computer as well. If you are not sure where these folders are stored, please refer to artbutler > Preferences > Local.
- Install ARTBUTLER on the new machine and start it for a first time. You will have to temporarily set up the base currency and a first user to create an empty database, that will be replaced in the next steps.
- After installing ARTBUTLER successfully, please close it again to proceed. Locate the database folder that can be saved under different locations according to your Windows version:
C:\Users\<your Windows user name>\artbutler\databases\ArtbutlerDBHSQL (Windows Vista / 7 / 8)
C:\Documents and Settings\<your Windows user name>\artbutler\databases\ArtbutlerDBHSQL (Windows XP)
The folder contains the database files database.script and database.properties. - Double-click the backup file from step 1 to unzip it and rename the included files from artbutler.script and artbutler.properties to database.script and database.properties. Finally replace the files in the database folder from the previous step with the files from the backup.
- Your data from the old computer is now available on this computer when you start ARTBUTLER again. In a last step, please set up the image and template folders you copied to the new computer for ARTBUTLER – just select them on the artbutler > Preferences > Local tab.