Smilehouse Workspace HOWTO Articles

Installing Workspace on Mac OS X - Running Workspace Installer

After installing platform softwares and setting environment variables, you are ready to run the Workspace installer.

Download the Developer version installer at http://workspace.smilehouse.com/download.shtml or use the installer you acquired on your license CD.

Execute the installation program with terminal from folder Installation/macOSX/

Graphical installer: start with command: sudo sh install.sh
Textbased installer: start with command: sudo sh install.sh -t
The installation prosess is similar with both tools.

Installation starts with welcome text and ends with thank-you text. Phases between these steps include the acceptance of the license, installation questions and installation process itself.

Installation questions contain different type of checks which can depend on the current question or the combination of many questions. Installation program displays errors and warnings to the user if a check doesn't pass. Errors prohibit the user from moving on to the next installation question, but warnings can be ignored.

The answers given to the installation questions are saved in the .workspace directory that is created under your home directory.

Setting up the database

Step 1/6 - JDBC Driver
Give the classname of your JDBC driver.
Usually: "com.mysql.jdbc.Driver"

Step 2/6 - JDBC Protocol Name
This is "mysql" if using MySQL.

Step 3/6 - Hostname
Usually "localhost" (database on the same computer).

Step 4/6 - TCP/IP Port
This can be left empty (default is used).

Step 5/6 - JDBC Username
This is usually "root"

Step 6/6 - JDBC Password
Check the password of databace. It is empty by default.

The database connection is built.


Other settings

Organization name
Installer asks for the preferred organization name.
For example "myshop".

Temporary file directory
Installer needs to know where Workspace can save temporary files on computer.
For example "/tmp/" (if exists)

Directory for uploaded files
The directory where Workspace keeps all the images and files that you have uploaded using Workspace.
For example: "/home/workspace_files/"(if exists)

Name of the log file
This is a file where Workspace writes description on errors and warnings that occur while using the software.
For example: /var/log/workspace.admin_error_log

Running Workspace in a virtualhost
Choose yes if you want to run your shop using your domain instead of the default Workspace URL.
You should also change your network DNS settings to match with this configuration.
Example URL with default URL: http://192.111.222.255:8080/workspace.client_myshop/
Example URL with virtualhost: http://www.myshop.com

Host URL
The URL where Tomcat is installed.
Usually: http://localhost:8080/ (your own computer)
or your domain name http://www.myshop.com

SMTP host name
Name of your SMTP mail server.
For example: smtp.kolumbus.fi

Now the installer copies the files needed and configures settings.

After the installation

After the installation you should restart Tomcat.
You can do this from Terminal with commands:
/usr/local/tomcat5/bin/shutdown.sh
/usr/local/tomcat5/bin/startup.sh
(if /usr/local/tomcat5/ is the path where the tomcat is installed )

The restarting of Tomcat depends on version of Mac OS X and Tomcat. So if the previous instruction doesn't cut it, refer to documentation of Tomcat and Mac OS X.

The Workspace Administration Interface should now be found at:
http://localhost:8080/workspace.admin/Login
or
http://shop.mycompany.com/
or
http://shop.mycompany.com/workspace.admin/
Depending on the options you selected while installing Workspace.

The default user name and password for the Administration Interface are user and password.

After the first login, you should change the password into something else.






< Previous page     Page 3 / 3


^ Contents
<< Back to HOWTO index