I just attempted to install MacTex (the current 2015 distribution) on my new 64 bit laptop with Yosemite, through safari. Using the usual download page didn't work so instead I went through a specific server using the following link. However, after I finished downloading the files and started the installation (through the installer GUI) I got the following error

"The installation failed. The installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance."

This error message is insanely vague. How do I diagnose the problem (can I look for signs of the problem using the terminal). I have already installed TexStudio, but need to install the tex distribution. I do not have any other Tex distributions on the computer.

  • What does tex --version give you on the terminal? The error sounds like it was reported by OSX, not the installer itself. – Sean Allred Jul 29 '15 at 4:21
  • -bash: tex: command not found – WetlabStudent Jul 29 '15 at 4:22
  • Well, installation definitely failed, then. Does /var/log/install.log contain anything useful? – Sean Allred Jul 29 '15 at 4:23
  • That's not a command, it's a file. For example, tail -n 1000 /var/log/install.log | less will give you the last thousand entries in the log. – Sean Allred Jul 29 '15 at 4:25
  • 1
    Yeah, that definitely looks like a corrupted archive. bittorrent is fine, but I've never had a problem with the normal download. Something you might also try is homebrew-cask. – Sean Allred Jul 29 '15 at 4:40

This is following the advice of Sean Allred

step 1, make sure it actually failed to install: open up a terminal and type the command tex --version.

step 2, check the last few lines of the install log by typing tail -n 500 /var/log/install.log | less which will display the last 500 entries in the log

step 3, look for any error messages, for example mine was

PackageKit: Install Failed: Error Domain=PKInstallErrorDomain Code=110 "An error occurred while extracting files from the package “MacTeX.pkg”." UserInfo=0x7fb765f67ec0 {NSUnderlyingError=0x7fb765f9ae80 "The operation couldn’t be completed. cpio read error: Undefined error: 0", NSURL=file://localhost/Users/username/Downloads/MacTeX.pkg#root.pkg, PKInstallPackageIdentifier=org.tug.mactex.texlive2015, NSLocalizedDescription=An error occurred while extracting files from the package “MacTeX.pkg”

step 4, Google the error message. In the case of the above message, many users who downloaded MacTex saw this message when there downloaded files were corrupted during the download process. These problems can occur when MacTex is downloaded through the official website and sometimes even when using specific servers on this page. Some of the users experiencing this error message had success when doing the download from a different server on the above page (rather than the one closest to their physical location - note servers farther away may take more time to download from). I had to switch countries twice, but it finally worked. In addition, some users report issues using firefox or chrome (sometimes switching to safari yields a successful download). If all of the above have failed, most users who used github or torrent to download the files, instead of the official site, seemed to do so successfully without any of the files being corrupted.

step 5, if you can't figure out the meaning of the error message and no piece of the error message (note please search for small pieces of the error message as things like your directory structure, user name, and other system specific information will vary from user to user and may lead to no search results when these pieces of information are included) seems to be triggering a search result describing a similar problem to yours, you then should ask the relevant online community (or contact the support team at MacTex) describing the problem. Be sure to include the error message so future users with the same problem will then be able to see your thread.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.