Clockware Tock 4.3 Read Me
Welcome to Tock, by Clockware. Tock allows your employees to record their time and attendance information with a simple, intuitive Web interface. Tock is a robust and highly-scalable application that fits into your enterprise. Tock embeds the high performance MySQL database, but can also use Microsoft SQL Server 2000 or Oracle 8i/9i databases (see below). Tock is compatible with the following browsers:
Once installed, you can access Tock from anywhere on your network using a link of the form:
http://localhost:8080/tock/login
where localhost should be replaced by the host name of the machine running the Tock service. Login with the user name 'admin' (without the quotes) and the password 'admin' (without the quotes). Don't forget to change the password for this account at some point, which can be done from the Admin > Users page.
Once you have logged into Tock you should configure your system following the information in the Quick Start Guide. This guide, and the more comprehensive Administrator Guide can be found in the 'docs' folder inside your installation folder.
Tock is installed as a service so that it will start automatically when your computer starts. You can manually start and stop Tock on Windows from the Start menu > Programs > Tock > Control shortcut, or from the Windows Services control panel. On UNIX systems use a command shell and cd to the Tock installation directory (e.g. /opt/Clockware/Tock) and execute the command:
./bin/tock_svc -start
to start Tock, or the command:
./bin/tock_svc -stop
to stop Tock.
Upgrading From a Previous Version of Tock
If you already had Tock 4.0 or later installed then the Tock installer will automatically upgrade your installation. However, if you are using Microsoft SQL Server or Oracle as your database, or are running an older version of Tock, then there a few steps you must manually perform to finish upgrading your system. Please refer to the Upgrade Guide for more information.
Tock installs the MySQL database by default, which is a high performance open source relational database. Tock can also be configured to use Microsoft SQL Server by following these steps:
1. Create the Tock database schema by running the following database setup scripts, contained in the installdir/clockware/tock/dbms/mssql directory, in order:
Note that create_db.sql will create the disk storage for your database as well as create a database account for accessing the Tock database. You can run it unmodified, but you may modify this file to suit your installation needs, such as to store log files on a separate drive from the data. Also note that SQL Server must be set to support mixed SQL Server and Windows authentication in order for Tock to be able to connect to SQL Server.
2. Modify the file tock.cfg to use the new database. This file is located in the installdir/clockware/config directory. Modify the section at the beginning of the file to the following (you should save a copy of this file first):
Note that if you modified create_db.sql you must change the appropriate parameters above (e.g. the database name, user name or password. Also note that if the SQL Server hosting this database is on different machine than the one that is running the Tock service then you must change localhost to the host name of the SQL Server machine. Lastly, if your SQL Server is running on a port different than 1433 then you must change this value, too.
3. Now restart the Tock service, either from the Services control panel or from the Start > Tock > Control shortcuts. Load the Tock login page to verify you have established a database connection.
Tock installs the MySQL database by default, which is a high performance open source relational database. Tock can also be configured to use Oracle by following these steps:
1. Create the Tock database schema by running the following database setup scripts, contained in the installdir/clockware/tock/dbms/oracle directory, in order:
Note that create_db.sql will create the disk storage for your database as well as create a database account for accessing the Tock database. You can run it unmodified, but you may modify this file to suit your installation needs, such as to store log files on a separate drive from the data.
2. Modify the file tock.cfg to use the new database. This file is located in the installdir/clockware/config directory. Modify the section at the beginning of the file to the following (you should save a copy of this file first):
Note that if you modified create_db.sql you must change the appropriate parameters above (e.g. the database name, user name or password. Also note that if the Oracle server hosting this database is on different machine than the one that is running the Tock service then you must change localhost to the host name of the Oracle machine. If your Oracle server is running on a port different than 1521 then you must change this value. Lastly, change the Oracle SID, ORCL in the example above, to match your value if different.
3. Now restart the Tock service, either from the Services control panel or from the Start > Tock > Control shortcuts. Load the Tock login page to verify you have established a database connection.
Tock installs the Tomcat application server, and by default listens for HTTP requests on TCP/IP port 8080. If you want it to listen on another port, like 80, you need to modify the file server.xml in the conf folder of your Tock installation folder. This file has instructions on how to modify the default HTTP port, as well as how to enable security using SSL (Secure Sockets Layer) if needed.
Please refer to the Change Log for information on changes in this version.
Customer Support is available from 9 AM. to 8:30 PM. Eastern Time on business days. Call us and ask for support at (408) 749-7600. Or email us directly at support@clockware.com.