community
Installation FAQ
Questions about Teamwork installation
For more information about Teamwork installation read the user guide.
I want to have Teamwork on my Tomcat, not on the provided one.
Proceed in this way:
I want to have Teamwork on my Tomcat, not on the provided one.
1. ensure that your Tomcat is updated, i.e. version above 5.5.16, and using JDK 5
2. install anywhere using the graphical installer with access to the real database, until the last step of the installer, where you disable the “launch Tomcat” and “launch browser” checkboxes
3. the installer will:
a. create a config.properties with the JDBC connection parameters
b. create a lic.properties file with the license data supplied
4. copy the resulting webapp, that is, the webapps/ROOT folder, from the provided Tomcat to your Tomcat
5. if you are not using the Teamwork web app as ROOT, configure your Tomcat adding the Teamwork web app
6. Launch Tomcat and browse to the web app root, the schema will be created and filled.
How do I know which version I have downloaded or saved?
The files Platform.number and Teamwork.number determine the version. From the web interface, go in the menu -> help & info -> about page.
Does Teamwork work on Tomcat 5.5.9 to 5.5.16?
Above versions of Tomcat (only those) comes with Eclipse JDT compiler enabled by default for JSP compilation. JDT compiler is not jdk 1.5 compliant in those releases (fine afterwards and in Tomcat 6).
See here for a solution.
How to remove Teamwork’s service?
To remove the installed service on Windows and OSX’s, just launch the uninstaller executable in Teamwork’s installation folder; this of course will also remove the Teamwork application.
To remove it by hand on Windows: first of all check name of service from its properties. Service's name has the form ‘teamworkportnumber' (ex: teamwork8080). Open a cmd session, then use command 'sc query nameofyourservice' to find if is installed on system, if the service is running stop it from the service panel by using 'sc stop nameofyourservice', after that perform 'sc delete nameofyourservice'.
Otherwise if you have a tomcat installed on system you can use the tomcat utility 'service' in tomcat root directory /bin with this syntax: 'service remove nameofyourservice'.
I have problems with Oracle
If after installing on Oracle, and after passing the connection test, you cannot login, this may be due to lacking the schema name in the JDBC connection parameters: proceed as follows:
1. open WEB-INF/config.properties and change
#schemaName=MY_SCHEMA
to
schemaName=YOUR_SCHEMA_NAME_HERE
2. open commons/global.properties and remove the lines starting with
SETUP_DB_UPDATE_DONE=yes (or no)
SETUP_NOTIFIED_ADMIN_WIZARDS=yes (or no)
3. restart.
What to provide in order to get Teamwork installed and configured?
In order to install Teamwork, the following information will be needed:
- an administrator/root access temporary to the server (of course
you may create a specific user that has access only to the specific
folder where you want the installation, but then expect to have
forgotten some security setting and then having to get back several
times to the technician etc. etc. .)
- root access to the database, in order to create a new, empty
database, and a teamwork db user that has complete control on such
database (alter schema rights included)
- decide where you want Teamwork’s uploaded files to go, the "repository" root
- supply a password for the "administrator" user
- decide which folders of the file server to be accessible from
Teamwork’s web interface ("file storage"), and hence can be linked to
projects: there can be several of them. Example: you have a folder on
the web and file server where all projects have their subfolder, say
/usr/local/projects or C:\projects: this is the value needed.
- provide the e-mail notification basic parameters, which are the
"SMTP" server , and the user from whom the e-mail should be sent. These
are similar to the parameters of your e-mail client. These are quite
fundamental in order to get notifications from Teamwork.
- in case you want also to send e-mail to Teamwork, for example if you want to synchronize your agenda with Outlook/Mail clients, you need to create a NEW e-mail account on you domain, and provide POP3 and account user and password for the installation.
In particular, if you buy remote setup from Open Lab or you delegate someone to do the installation for you, you will have to provide information above. Remember to reset the root password after installation!
What if I have Occasional java.net.SocketException: Broken pipe or connection trunction exception?
This typically
happens when the underlying database has a short timeout set on connections. You can either turn off connection pooling, or
set a longer timeout for connections (this is our preferred solution)
1. Turning
off connection pooling. Open the file global.properties, in [web app]/WEB-INF,
and insert (or modify) these two lines: from
useC3P0=no
useProxool=no
and restart
the web app.
Can I install Tomcat 5/6 as Windows service?
To create the windows service "Teamwork", proceed as follows:
1. open a DOS console (go to commands, and type CMD plus enter)
2. go to you teamwork installation directory's bin folder (cd [your directory]\bin)
3. type "service install Teamwork"
This way the serivce should already appear in your services list, with diplay name "Apache Tomcat Teamwork". If this fails, it's because you do not have a Java JDK 5 or 6 installed. Download and install it from Sun's site, java.sun.com.
4. to fine tune the service parameters: copy and rename tomcat5w.exe as Teamwork.exe, and launch it.
If the widows service does not start, and you are using JDK6, it may be missing a DLL: see http://forum.java.sun.com/thread.jspa?threadID=5121172:
"After a few months I've found solution of this problem:
When I run tomcat5.exe under Sysinternals File Monitor, I see that Tomcat can't find msvcr71.dll. Some computers have it, and some not. When I copy this file to
Probably some part of JRE 1.6 uses this DLL, but it isn't included in JRE installation package."
What if installer can't connect to SQL Server 2005?
2005 does not enable TCP/IP connections by default: enable such protocol in configuration manager.
Notice that this may happen even if ODBC connections work fine.
I want to have Teamwork on my Tomcat, not on the provided one
Proceed in this way:
1. ensure that your Tomcat is updated, i.e. version above 5.5.16, and using JDK 5
2.
install anywhere using the graphical installer with access to the real
database, until the last step of the installer, where you disable the
“launch Tomcat” and “launch browser” checkboxes
3. the installer will:
a. create a config.properties with the JDBC connection parameters
b. create a lic.properties file with the license data supplied
4. copy the resulting webapp, that is, the webapps/ROOT folder, from the provided Tomcat to your Tomcat
5. if you are not using the Teamwork web app as ROOT, configure your Tomcat adding the Teamwork web app
6. Launch Tomcat and browse to the web app root, the schema will be created and filled
In
99% of the cases where this does not work it is due either to launching
Tomcat not as root, or using a database user that doesn't have schema
creation rigths.
How do I do first login?
After installation, the user is "administrator" with empty password.
