After deploying, the Installer tool does not come up in my browser. 

There are many reasons why deploying an application might fail. Please refer to the instructions and documentation for the Java application server you are using to troubleshoot any issues. If you are using Tomcat, the Tomcat log file, which is usually located at <tomcat_home>/logs/catalina.out or <tomcat_home>/logs/stdout.log can provide much-needed clues.

The Installer tool fails to connect to the database. 

If the Installer tool fails to connect to the database, double-check the database name, user name, and password. If you are using MySQL, you may need to associate the database user with your server's host name for the connection to work. (You can refer to the section that describes how to do this under the Installation Procedure for Ensim Servers section.)

The Installer tool finished successfully, but I cannot log into the Administrator. 

It is possible to successfully run the installer after making an error when filling out the "Administrator URL" setting. This is a problem, because the Administrator itself is typically what you would use to make changes to the URL settings.

If logging into the Administrator takes you to the wrong place and you must change the "Administrator URL" setting after finishing the Installer, you must update the URL settings in the database directory. Do this by running the following SQL update commands on the sscSetting database table:

mysql>use softslate;
mysql>update sscSetting set mediumValue='<base customer URL>' 
      where code = 'customerURL';
mysql>update sscSetting set mediumValue='<base secure customer URL>' 
      where code = 'customerSecureURL';
mysql>update sscSetting set mediumValue='<base administrator URL>' 
      where code = 'administratorURL';
					

For these changes to take effect, you must restart your application server or reload the application.

I keep getting java.lang.ThreadDeath exceptions running the Installer tool. 

Some users, typically on systems with limited memory, have reported getting repeated java.lang.ThreadDeath exceptions each time the Installer is run, preventing them from completely installing SoftSlate Commerce.

The first thing to try is simply to restart your application server and try running the Installer again. If it continues to fail, move on the next section, Installing SoftSlate Commerce Manually.

The Installer tool finished successfully, but I need to run it a second time. 

If for whatever reason you need to rerun the Installer tool, you have to do two things: unlock the Installer if it has been locked, and empty the database you are using so the data objects can be reinserted without an error.

To unlock the Installer tool, edit the WEB-INF/classes/appSettings.properties file located under the SoftSlate Commerce installation directory. Look for the line beginning "lockInstaller", and delete that line.

The easiest way to empty the database is often to simply delete it and recreate it. For example, in MySQL, you could run the following commands to create a new, empty database:

mysql>drop database softslate;
mysql>create database softslate;