eSellerate Install Failed

If you've come straight to this page, and have not yet tried removing the "MindVision" folder, please view eSellerate Errors first, as it contains a simple step that resolves the problem for most people. If you've already tried that, then continue with this article.

Extended Troubleshooting

Advanced (skip this paragraph if you wish): If you are familiar with how the Mac OS X operating system is put together, and would like to get an advanced readout of the permissions eSellerate takes stock of, you may download the System Check utility. This will run a diagnostic which saves a "Stats.txt" file to your Desktop. It will print each checked resource and directory and show whether it has been correctly installed, or if the folders it needs to write to have write access. Some of these are fall-backs. For instance if it cannot write to the global Library folder, it will attempt to use your user level Library folder instead. If you can't figure out what is wrong, save the file and continue with the steps below.

If, upon launching Scrivener, you receive an "eSellerate Install Failed" error message, this is usually indicative of a permissions problem on your machine.

Scrivener relies on the eSellerate engine to validate serial numbers and check if you are using the trial version or have registered the program. When Scrivener is launched, it has to ensure that the eSellerate framework is installed on your computer; if not, it will install the eSellerate engine automatically. This is nothing malicious---lots of programs do this, and lots of programs use eSellerate, too. The eSellerate engine is installed in the folder on your computer that Apple have designated for just this sort of thing. If you are seeing an error telling you that the eSellerate engine failed to install properly, then it indicates that something is going wrong at one of the following stages, all of which Scrivener has to go through to install eSellerate:

  • Copying EWSMacCompress.tar.gz to the user level ~/Library/Application Support/eSellerate folder.
  • Decompressing the file there (which results in EWSMac.framework).
  • Copying the EWSMac.framework folder (or file, on older systems) to the system level /Library/Frameworks folder.

In the event that permissions are insufficient to write to the system level /Library/Frameworks folder, then the application tries to copy the EWSMac.framework folder to the user level ~/Library/Frameworks folder.

For Lion Users: If you are using OS X 10.7 or greater, your Library folder will be hidden from you. There are two easy ways to get to it. The first is to use Finder's Go menu and hold down the Option key. This will reveal the Library entry which you can select. The second method is to use the keyboard shortcut, Shift-Cmd-G and then type in "~/Library".

If all of these things fail, usually because of a permissions problem on your computer, then you will see the "eSellerate Install Failed" message.

To remedy this issue, first try following the steps outlined on this page (but return here if they do not work):

If those steps fail, please try the following:

  1. Use Disk Utility to repair the permissions on your account. Often this doesn't fix the error, but it is worth doing as a first step.
  2. If that doesn't help, go to the ~/Library/Frameworks folder (where ~ represents your home directory) in the Finder and Get Info (cmd-I). Check under "Sharing & Permissions" and make sure that you have "Read & Write" access. If not, change it so that you do (you will need to click on the little lock icon and enter administration details for your computer to do this). I had this problem on an account of mine; resetting this folder to have write access fixed the problem immediately.
  3. If you are still having problems, try downloading the eSellerate updater.

    Just click the Downloads & Reinstalls link on the left-hand side of the main page, then click the Downloads link directly below the Online Support tab. Finally, click the link labelled Engine Updater for Mac OS X. Save the file to your Mac and run it to install the latest eSellerate engine.

    After doing that, try running Scrivener again.

If you continue to receive the error message even after trying all of the above, the next step will be to try and install the framework beforehand, so Scrivener does not have to try to itself. First, try downloading the installer. If that works, you should be able to activate immediately after running it. If that does not work, then proceed to attempt installation manually:

  1. In the Finder browse to the system level /Library/Frameworks folder (i.e. not the one in your home folder but the one you access by clicking on the main hard drive in the top of the left-hand source list in the Finder).
  2. Delete the folder named EWSMac.framework from the Frameworks folder by dragging it to your Trash and then emptying the Trash.
  3. Download the Engine Updater zip file.
  4. Decompress the file (if necessary) by double-clicking it in your download folder
  5. Drag the resulting file (it will have a yellow toolbox icon) into the system level Library/Frameworks folder.
  6. Now once again go back into your user folder and navigate to ~/Library/Application Support, and delete the "eSellerate" folder if you see one.

Further Troubleshooting

If you still have problems, check the following (which may have come to light in some of the above steps):

Very rarely a login user account on a Mac may have been created not using the normal means, and such a user account might not have a user level Library folder (which is required). In this case there would be no place for the application to copy the compressed eSellerate engine (the first step of the install process). So if all else has failed, the next step is to verify the existence of that folder and that you have permissions to modify it.

In the Finder, click on your home folder in the list on the left---the home folder is the one that shows the account name (e.g. "johnsmith"). Inside there, check that there is a Library folder (this path can be described as ~/Library, where ~ represents the user or logon name).

If this folder does not exist, you need to create it. Note that on Mac OS X 10.7 Lion, this folder will be hidden from you, so even if it is there it may appear not to be. On Lion, use the Finder's Go menu, and hold down the Option key to reveal the Library entry in the menu. If attempting to use that causes an error, then you will need to create it. It may disappear immediately after you create it, so be prepared for that.

If the folder does exist, check its permissions by ctrl-clicking on it, selecting "Get Info" and then checking under "Sharing & Permissions" in the Get Info window that you have "Read & Write" permissions. If not, change them so that you do (you will need to click on the little lock icon to be able to do this, which requires the administrator password for the computer).

Next, check that inside the Library folder there is an Application Support folder. again, if it doesn't exist, create it; if it does exist, check its permissions and set them to "Read & Write" if necessary.

After all of this, try re-installing Scrivener.

If All Else Fails...

If none of the above works, and you still cannot get Scrivener or Scapple to run without errors, please download the System Check utility. This will run a diagnostic which saves a "Stats.txt" file to your Desktop. Next, e-mail us at with this Stats.txt file attached, and include the error number that is printed in any error messages (if any), and we will contact eSellerate for further assistance.

Note that the above information is mainly compiled from support that eSellerate has already given to other users who have had this problem, so be sure to try everything above before contacting us, as this is what you will be asked to try anyway.