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
process_port=32654 (should change the value is greater than 30000)