TeamCity Start/Stop Script for Linux

I am using Teamcity on Ubuntu 14.04. Here is a simple script to start / stop TeamCity server.

# /etc/init.d/teamcity – startup script for teamcity
export TEAMCITY_DATA_PATH=”/home/teamcity/.BuildServer”
export TEAMCITY_SERVER_OPTS=-Djava.awt.headless=true # Configure TeamCity for use on a headless OS.

case $1 in
start-stop-daemon –start -c teamcity –exec /home/teamcity/TeamCity/bin/ start

start-stop-daemon –start -c teamcity –exec /home/teamcity/TeamCity/bin/ stop


exit 0

Copy the script (teamcity) to etc/init.d.

Register the file as a startup script

sudo update-rc.d teamcity defaults

Make the file executable

sudo chmod +x /etc/init.d/teamcity

Now you can start teamcity with sudo service teamcity start or stop ist with sudo service teamcity stop

install git on SLES 11 SP 3

sudo zypper addrepo  
sudo zypper addrepo  

sudo zypper install git-core  

Execute A Program From A C / C++ Program

To start an external program from a C / C++ program, I used the following code.

GetStartupInfo( &start_info ); // You must fill in this structure
ret = CreateProcess( NULL,  // specify the executable program
(LPSTR)buffer,   // the command line arguments

// Successfully created the process.  Wait for it to finish.
WaitForSingleObject( process_info.hProcess, INFINITE );

// Get the exit code.
result = GetExitCodeProcess(process_info.hProcess, &exitCode);

// Close the handles.
CloseHandle( process_info.hProcess );
CloseHandle( process_info.hThread );

The code starts an external program and waits, until this program has finished before processing the next lines of code.

After using this code for a couple of years now, I found a shorter version today …

ret = system((char *)buffer);

I found only one limitation. It will print any of your fprint statements to the Domino console; using CREATE_NO_WINDOW with CreateProcess, you can suppress the output.

A smallish problem installing JVMPatch_SR16FP3_W64_901.3_Server

I recently ran into an issue, where my Java SQL and LDAP connectors stopped working after applying FP3 to Domino 9.0.1 / 64Bit.

Thanks to the help of the community, I was pointed to an already existing fix for this issue. IBM had released an JVM patch . I downloaded the patch and tried to install it by simply double-clicking the downloaded file.

On the machine ( a testing environment ), where I tried to install the patch, also the Notes Client is installed.

This obviously confuses the installer and so it tried to apply the patch to the Notes client instead of the Domino server.


There is no way to change the install path in the GUI. I looked into the install log and found an interesting entry

3 Command Line Args:
0:  LAX_VM
1:  D:\Notes\jvm\bin\java.exe

So, I gave it a try and added the path to my Domino installation as parameters to the .exe file

D:\temp\jvmpatch> LAX_VM d:\Domino\jvm\bin\java.exe -D$USER_INSTALL_DIR$=D:\Domino

Now the patch was successfully applied to the Domino server JVM …

I have not tried the 32Bit installation. Here the file states to be “ClientServer”. So, maybe, you can make a selection in the 32Bit version and the 64Bit version is simply missing this option.

If the command line is documented somewhere, blame me. If not, maybe this post can help saving some time.

A quick tipp for using the ONTF Dependency Documenter

A quick tipp for using the ONTF Dependency Documenter from Andrew Magerman.
If you have a lot of libraries in your database, the resulting image might be too large to fit into the page and the result seems to be truncated.

I have talked too Andrew already, and it seems that there is some kind of limitation on the image size for a page design element.

You can work around this issue by resizing the image in the image properties.

We also discussed some options and I am sure that Andrew will provide an updated version of the plugin soon.



Serious issue when signing a database in the background on the server

While working with the cAPI, I ran into a nasty problem with signing design elemnts in an application on the server with a different ID than the server ID.
This seems only to be a problem with XPages related design elements.
When you try to open an XPage from that database in the browser, you will get a 403 Error message.
When I sign the same database from the client with the same ID using Ytria SignEZ, everything works as expected.

Other elements are not affected. So forms, views, agents and script libraries are signed correctly. Well, don’t get me wrong, even XPages are signed correctly, but they just do not work any longer after signing.

So, how do I sign a database in the background on the server with a different ID?

Here is, what I do. The ID is stored as an attachment in a configuration document. The file is detached at runtime to a temporary directory outside the Domino installation path. The code opens the file and returns a handle to the ID

if ( NOERROR != SECKFMOpen(&hKFC, 
                SECKFM_open_All, 0, NULL))

An XPage is defined by NOTE_CLASS_FORM and DESIGN_FLAG_XSPPAGE, so later in the code, we have to open the note EXPANDED

ret = tnote.open1(tdb.hDb, nid, OPEN_EXPAND);

Finally, the design note is signed using NSFNoteSignExt3

ret = NSFNoteSignExt3(
      tnote.h, hKFC, NULL, MAXWORD, NULLHANDLE, 

and contracted afterwards

ret = NSFNoteContract( tnote.h );

To verify, if anything is wrong with the signature, I use

ret = NSFNoteVerifySignature (
      tnote.h, 0, 0, retSigner, retCertifier);

So far, so good. As I said before, the code runs without any issues and the verification also does not report any errors.

At ConnectED, I went to the “Meet the Developers Lab” and asked for advice. The problem seems not to be in my code, but the Devs had a vague idea, what might be the problem.
I did some tests today and here is what I found out.

When you sign a design element using the client, The last entry in the $UpdatedBy field is the name of the signer.
When you do the same on the server, then the server’s name is the last name in the list.
Hence it is different from the name that is stored in the $Signature field, the error occurs.
This also explains, why I can open XPages that have been signed using my code and the server ID instead of the signer ID. In this case, names in $UpdatedBy and $Signature are identical.

As far as I can see, there is no workaround for that. So the only way to get this solved is to open a PMR with IBM …

How to determine, if a shared library is loaded on AIX

Recently, I had to figure out, if a shared library on an AIX system was loaded at Domino server startup. I am not an expert on UNIX, so I asked GOOGLE for some help.

I came across the UNIX command genkld, whic did exactly what I wanted to do

genkld will create a list that is printed to the console that shows all loaded shared libraries


You can find more useful information about “Shared library memory footprints on AIXhere


Remove Windows SP1 Backups To Free Up Disk Space

I recently installed SP1 on a Windows 2008 R2 Server. The partition for the OS only had 10GB space available. After SP1 had been successfully installed, only 7GB of free space was left.

You can delete the backup files if SP1 has been installed without any issues.

Use the following command to free up disk space after the service pack installation:

dism /online /cleanup-image /spsuperseded


The process takes a few minutes to complete, it ends with the sentences “Service Pack Cleanup operation completed. The operation completed successfully”.

Please remember that you cannot uninstall the service pack after you have cleaned up the disk space.

Add ProFTPD to ESXi 5.1

Uploading files to an ESXi datastore ist terrible slow using the build-in upload mechanism. However if you add FTP to your ESXi server, and use an ftp client to upload/download files, the upload/download will be much faster.

ProFTPD runs good in ESXi 5.x and offers high transfer rate over normal transfers.

To add ProFTPD Service, do the following.

Enable SSH in ESXi.

  • Connect to your ESXi host
  • Goto Configuration
  • Goto Security Profiles
  • Click on Properties
  • Select SSH from the list of services
  • Click Options end start the service

Connect to your ESXi host using any ssh client like putty.
Navigate to your datastore folder  cd /vmfs/volumes/datastore/
[Replace “datastore” to match your datastore name]

Create any folder where your FTP Service files can be downloaded from the internet or any other source.

mkdir install
cd install

Now download ProFTPD using wget


install ProFTPD using esxcli

esxcli software vib install --no-sig-check 
-d /vmfs/volumes/datastore/install/

I needed to restart the ESXi system to activate ProFTPD in the Security Profiles.

Forcing a localized vSphere Client or vSphere Web Client installation to launch in English

My vSphere Client starts with a german User Interface. Obviously, the language depends on the OS language. In my cas, it’s German …

To be able to provide screenshots with english labels and error messages in a way, that I can find results on Google more easily. I was looking for a way to switch the language of my vSphere Client to English.



There is no setting in the UI itself, but here is a little trick, how it can be done without pushing language files around like in the pre WW1 days.

Simply add one of the following parameters to the start parameter of the vSphere Client desktop icon

  • English: en_US
  • German: de_DE
  • Japanese: ja_JP
  • Simplified Chinese: zh_CN
  • French: fr_FR
  • Korean: ko_KR

"C:\Program Files\VMware\Infrastructure\Virtual Infrastructure Client\Launcher\VpxClient.exe" -locale en_US

You can do the same with your web based client.

Th switch the language to French, simply add the language parameter to the URL



consoleEZ – new tool from YTRIA

Ytria’s consoleEZ lets you improve the way you work by giving you access to one or several IBM Domino server consoles in one dashboard.

In fact with consoleEZ, you can:

  • Get a complete picture of your domain activities without having to switch from one server to another.
  • Open several sessions for as many servers as you need, apply filters, and select/copy anything you see in the consoles.
  • View past events with the Log Analyzer, filter and search them, and consolidate your data with various options.


You can download a time limited beta version here.



OpenNTF: TriggerHappy 2.0 (Update)

TriggerHappy 2.0 for Domino on Linux has been released on OpenNTF. It is still BETA and not intended to be used in production.
For now, I only provide the 32Bit version, because despite the 64Bit Version compiles and links, it freezes my server on startup.

The 32Bit version starts without issues, but invokes NSD on server quit and restart. Will look into that, but with Connect 2014 just around the corner, I do not have much spare time to do so.


If anyone is willing to offer help and could review the sourcecode ( Ben? Nathan?, Daniel? ) … Much appreciated.


OpenNTF: TriggerHappy 2.0

18.01.2014 14:07:11 TriggerHappy initially started on Domino 9.0.1 LINUX/64Bit

Still having a smallish issue when the agent is started. Seems to be a problem with Thread Local Storage implementation. Looking for assistance.

If anyone is willing to look into the code, I will send it. Ping me an email if you want to help.


As of Notes 9.0.1, you can now control the date column in the mailfile preferences to automatically sort ascending or descending.  (


The option can also be set via the notes.ini


A value of 11 displays the most recent message at the end of the view (the default) and 12 displays it at the beginning of the view.

Build cAPI Programs On Linux/64

Today I built a compile and build environment for Domino 9.0.1 on Linux 64Bit. I had done this for 32-Bit Linux a while ago and all the steps for 32Bit also work in a 64Bit environment.

There is only one symlink you have to add in addition to the symlinks you have to create on 32-Bit

ln -s $Notes_ExecDirectory/ /usr/lib64/

where $Notes_ExecDirectory=/opt/ibm/domino64/domino/notes/latest/linux in my environment


Titanium Studio – ‘Failed to create the Java Virtual Machine’

I recently installed Titanium Studio on my PC. On first startup, I received the following (pretty useless)  error message …


To get more information about the error ( and the cause ), you can start TitaniumStudio.exe from the command prompt with the -debug switch


After more searching and testing, I changed a parameter in the titaniumstudio.ini from

-Xmx1024m to -Xmx512m

Now Titanium Studio starts without any complaint …


Compacting Databases With DBMT

Starting with IBM Domino 9.0, DBMT has been introduced. You can use the DataBase MainTenance tool for performing multiple daily/weekly administrative tasks on user’s mail database files. The DBMT tool relieves the administrator of the need to run the Updall task.
When DBMT is executed, it uses the copy-style compact (compact -c ) to compact databases. Compact -c has the disadvantage of fragmenting files and this can have an impact on the performance of your server.

But DBMT behaves a bit different here. DBMT preallocs the .TMP file to the used space size of the .NSF.

I did a test on my server. Here is the result.

Unfortunately, the “old” compact task itself does not yet have the preallocation feature included. I hope, that we will see this feature in a future release …

Administration Help and DBMT in 9.0.1

If you are already familiar with DBMT, you might be aware of this;  if you are new to DBMT, you can save some time reading this article

DBMT is a new feature in Domino 9.0 that allows you to configure the regular maintenance options that you are familiar with to run automatically on schedule to keep your databases running smoothly. There are a lot of options that are described in the Administration Help Database

But, the Administration Help is wrong in one particular case:

“Specify any additional system databases using the notes.ini variable DBMT_FILTER. Separate entries in the list either by a space ( ), a comma (,) or a semi-colon (;). The names are case-insensitive and are relative to the data directory.

The correct name for the variable is DBMT_COMPACT_FILTER

Even after upgrading to 9.0.1, you will find this incorrect entry in the help.