Here are my notes on getting the latest Tuleap 9.0 Docker Image working on Synology:

  1. I had to run "docker pull enalean/tuleap-aio" as root on my synology since the Registry tab doesn't seem to allow me to select the "latest" version. Once you've downloaded the image, go ahead and create a tuleap container from the Docker UI in DSM.
  2. Specify the VIRTUAL_HOST Environmental variable before starting the container.
  3. Specify the data volume. Mine is /docker/tuleap for the /data mount path. Make sure read-only is unchecked.
  4. Explicitly set the Ports for SSH, HTTP, and HTTPS (do not use auto). Be sure to add the ports to your DSM firewall if you have it enabled. Remember these ports for note #7 below.
  5. Start your Container. You can monitor the container by double clicking on it and going to the Terminal tab to see the current process. Once the initialization scripts complete and the container processes are running, go ahead and stop the container.
  6. You can find mysql, site admin, and root credentials located at /docker/tuleap/root/.tuleap_passwd.
  7. Since you're using non-standard ports, you'll have to modify the /docker/tuleap/etc/tuleap/conf/ file and add the ports to the end of the $sys_default_domain [VIRTUAL_HOST:PORT] and $sys_https_host variables. If you do not do this, any attempt to login to the system will not work as it is still default 80/443.
  8. Once you've made the changes, you can now Force Restart the container. Now you should be able to hit the container with your browser at your specified port and use the site admin credentials to login and use the image.


Installing Yii2 Framework Using Git & Composer

Posted by admin on March 8, 2014

The official instructions to install the Yii2 Framework will give you everything you need to get started, but if you're using the codebase in a Git project environment, here's a better way to get things installed (I'm using the advanced project as an example here):

  1. Create your project dir and clone the repo: "git clone <project dir here>"
  2. Navigate to the project directory and simulate the dependencies install using Composer: "php composer.phar install --prefer-dist --dry-run". By default, Composer will save everything into the vendor folder, and in the future, if you need to update your dependencies, just run a simple "php composer.phar update" in the root folder of your project. Once you're satisfied with the dry run, go ahead and execute the install: "php composer.phar install --prefer-dist"
  3. Create a new Git branch to begin your new doodad project and snapshot your install in a clean state: "git checkout -b doodadBranch master"
  4. Proceed with the "Getting Started" section of the official instructions to get your project up and running.

In the future, to update the Yii2 installation base, here are those steps:

  1. Commit your latest branch changes: git commit -m "your comments here"
  2. Switch to your original master branch: "git checkout master"
  3. Pull the latest changes: "git pull origin master"
  4. Switch back to your project branch: "git checkout doodadBranch"
  5. Rebase the branch to the new master: "git rebase master"

Happy coding.

KDE: pinning java programs to quick launcher [fix]

Posted by admin on January 26, 2014

I ran into this bug when I was trying to add netbeans to the quick launcher in KDE. The normal method of selecting the 'Show a launcher when not running' option when you right click the taskbar entry will add a nonworking 'java' icon entry, and clicking on it does nothing. So how do you work around this? Turns out the solution is pretty simple.

  1. Open up ~/.kde/share/config/plasma-desktop-appletsrc in a suitable text editor.
  2. Find the line starting with 'Items='. This should be a CSV line showing all of your quick launcher items. 
  3. Locate the part where it references 'java' in the line and replace everything before the '?wmClass' with the path to /usr/share/applications/***.desktop file.
  4. Save and restart kde.
  5. You should see two icons of the app in the quick launcher, one being the original and one being your modified entry. Remove the original 'java' entry.
  6. ...
  7. Profit!