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 first unlock the Installer tool. Do this by editing the WEB-INF/classes/appSettings.properties file located under the SoftSlate Commerce installation directory. Look for the line beginning "lockInstaller", and delete that line.

Next, navigate back to the Installer tool, and click the link to "Switch to Advanced Installer". From the Advanced Installer tool, click the link to "Store Settings" on the left side menu. Fill in the correct Administrator URL (along with all the other required fields on that screen), and click "Continue". Test logging into the Administrator; the URL should be updated. If successful, please go back to the Advanced Installer tool and click the link to "Lock Installer", and click "Continue" to lock the Installer tool again.

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;
					

Installing SoftSlate Commerce manually, without the Installer tool. 

It is possible to install SoftSlate Commerce manually without using the Installer tool.

	Note
	If you need to use two-way encryption, the only way to create the two-way encryption key is through the Installer tool. You cannot install manually if you plan to use two-way encryption to store customer passwords, administrator passwords, or payment information. For more information, refer to the section on Security Settings.

To configure the database settings manually, simply edit the WEB-INF/classes/appSettings.properties file located under the SoftSlate Commerce installation directory. Add the database name, username, password, and other settings.

To initialize the database objects, run each of the create*.sql files followed by the insert.sql files under the WEB-INF/classes/resources directory. These files create and insert the database objects needed by SoftSlate Commerce.

To initialize key settings required by the application, you must update the following records in the npcSetting database table. This example is for a MySQL database.

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

To create and initial administrator login, you must insert records into the npcAdministrator and npcAdministratorRole database tables, placing the administrator in the superuser role.