Troubleshooting
Here are the answers to some of the most common questions about installing and running PRISM. If you are still stuck, see "Getting help" on the PRISM website.
Running PRISM
When I double-click the PRISM shortcut on Windows nothing happens
The most common cause of this is that you either do not have Java installed or the java executable is not in your path. In any case, to determine the exact problem, launch a command shell and navigate to the bin directory inside the directory where you installed PRISM (you can use the "PRISM (console)" shortcut installed in the start menu to do this). Then, type prism.bat and see what error message is displayed.
PRISM won't start: NoClassDefFoundError or UnsatisfiedLinkError
When I try to run PRISM, I get one of these errors:
Exception in thread "main" java.lang.NoClassDefFoundError: ...
java.lang.UnsatisfiedLinkError: no prism in java.library.path
java.lang.UnsatisfiedLinkError: ... Library not loaded: ../../lib/libprism.dylib
Things to check:
-
Did you run
install.shfrom the PRISM directory? -
If you compiled PRISM from source code, are you sure no errors occurred during the process? To check, go into the PRISM directory, type
make clean_alland thenmake, checking the output (especially at the end) carefully for any error messages. -
Are you running on macOS? See the next question.
-
Is PRISM picking up the wrong
java? You can give the exact path to thejavato use when running PRISM, e.g.:PRISM_JAVA=/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home/bin/java prismor set the value of
PRISM_JAVAin theprismscript directly.
macOS won't open libprism.dylib
When I try to run PRISM on macOS, I get an error of the form:
"libprism.dylib" can't be opened because Apple cannot check it for malicious software.
or:
libprism.dylib not valid for use in process: library load disallowed by system policy
PRISM's macOS binaries are not signed/notarised,
so you need to approve the binary files manually to run them.
Run this command from the same place you ran ./install.sh:
xattr -d com.apple.quarantine lib/*lib
or approve the libraries one by one through the security settings.
You can also avoid this issue by compiling from source code.
PRISM won't start: UnsupportedClassVersionError
When I try to run PRISM, I get an error of the form:
Exception in thread "main" java.lang.UnsupportedClassVersionError: ... has been compiled by a more recent version of the Java Runtime ...
Your version of Java is too old (PRISM needs Java 11 or above). Update or install a newer version of Java, and then try again.
Compiling PRISM
make seems to get stuck in an infinite loop
This is probably due to the detection of Java failing. Specify the location of your Java directory by hand, e.g. make JAVA_DIR=/usr/lib/jvm/java-21-openjdk. See "Building PRISM from source" for more on this.
libtool errors on macOS
When I try to compile PRISM, I get errors of the form:
/usr/bin/libtool: for architecture: cputype (16777234) cpusubtype (0) file: -lSystem is not an object file (not allowed in a library)
The likely explanation is that you have upgraded to a new version of macOS but have not upgraded the developer tools (Xcode or its command line tools). Upgrade (e.g. with xcode-select --install) and try again.
Nothing happens, or Unexpected end of line seen
When I try to compile PRISM, nothing seems to happen, or I get errors of the form:
make: Fatal error in reader: Makefile, line 58: Unexpected end of line seen...
Perhaps you are not using the GNU version of make. Try typing make -v to find out. On some systems, GNU make is called gmake.
$'\r': command not found on Windows
When I try to compile PRISM on Windows, I get errors of the form:
./install.sh: line 2: $'\r': command not found
The files have Windows line endings. Did you unpack PRISM using WinZip or another Windows program, or check it out with a Windows version of git? If so, unpack from Cygwin, using tar xfz (or similar), or use Cygwin's git (see "Building PRISM from source on Windows using Cygwin").
can't create ... No such file or directory
When I try to compile PRISM, I get an error of the form:
Assembler messages: Fatal error: can't create ../../obj/dd/dd_abstr.o: No such file or directory
Did you unpack PRISM using a graphical tool or file manager? If so, unpack using tar xfz (or similar) instead.
Do I have to use GNU make to build PRISM?
Strictly speaking, no, but you will have to modify the various PRISM Makefiles manually to overcome this.
Can I build PRISM on other operating systems?
PRISM should be suitable for any Unix/Linux variant.
The first thing you will need to do is compile CUDD (the BDD library used by and included in PRISM) on that platform.
CUDD is built with its own configure script (run by cudd/install.sh),
which works on most Unix-like systems.
To just build CUDD, not PRISM, type make cuddpackage instead of make.
Next, look at the main PRISM Makefile, in particular, each place where the
variable $OSTYPE is referred to. Most lines include comments and further
instructions. Once you have done this, proceed as usual.
If you do successfully build PRISM on other platforms, please let us know so we can include this information in future releases. Thanks.
Other issues
How do I uninstall PRISM?
If you installed PRISM on Windows using the self-extracting installer, you can uninstall it using the option on the start menu. If you didn't add these shortcuts, just run uninstall.exe from the directory where you installed PRISM.
On other platforms, simply delete the directory containing it.
The only thing that is not removed via either of these methods is the file containing your PRISM settings (see "Settings file" for where it is). You may wish to retain this when upgrading.