Common errors in installation – Free and open source project management software

  1. Home
  2. Hosting MyCollab on your own server
  3. Common errors in installation

Common errors in installation

There are several common errors while users install MyCollab. We did support customers via phone call, Skype chat and support forum. If you have the installation issue not belong into the below list, please contact via in forum.

I run MyCollab, and the console says “Message : Unknown collation: ‘utf8mb4_unicode_ci'”

You are using the older MySQL version. From the customers’ feedbacks, you should use the MySQL 5.5.3 or higher that support the utf8mb4_unicode_ci collation

MyCollab told me “The folder … has no write permission to the current user. You should set the write permission for MyCollab process for this folder

MyCollab requires the write permission of folder %MYCOLLAB_HOME%/conf to write the configuration file mycollab.properties. You should check whether the conf folder has the write permission. This issue usually happens to our Unix users.

I installed MyCollab successfully, but I can not access MyCollab pages, the login page loads forever

There are two common cases for this issue.

  • You run more than one MyCollab instances on your server. To fix this issue, you simply kill all MyCollab processes and run MyCollab service again.
  • MyCollab heavily uses push method to update its UI asynchronously; it will help the UI is more responsive to end users, but the drawback is not all network configurations allow server push work properly. If this is your case, you should select the pull method instead of push. To change this MyCollab setting, you simply modify the line in mycollab.properties frompull_method=push to pull_method=pull. Restart MyCollab server and you can enjoy.

I started MyCollab, and the console shows error message Caused by: java.sql.SQLException: Unknown collation: ‘utf8mb4_unicode_ci’

This rare issue happens with a few customers. The reason is you are using the very old MySQL database server. The collation ‘utf8mb4_unicode_ci’ is only supported on MySQL 5.5 or higher. That is also the reason MyCollab supports MySQL 5.5+

Caused by: java.sql.SQLException: Cannot load from MySQL.proc. The table is probably corrupted

It happens due to schema changes required for different MySQL server versions. You should google the solution for this database issue. It is not the fault of MyCollab installation process

I start MyCollab, and it is failed. It says that java.net.BindException: Address already in use: bind

This issue usually happens when there is some program occupies the MyCollab running port (default port is 8080), or even the previous MyCollab instance is running on this port. You can open the process, and kill the associate program. If you are running the previous MyCollab instance on Windows, you should not stop MyCollab by closing the Window console, but run the script shutdown.bat to clean the MyCollab process totally.

The other kind of issue is the other program occupies the MyCollab ports if the above case is not the issue. Open the file %MYCOLLAB_HOME%/bin/mycollab.ini, and try to change one of two ports values or both

port=8080

process_port=32654 (should change the value is greater than 30000)

Was this article helpful to you? Yes 6 No 1

How can we help?