I will be speaking at DNUG 44

I have just been notified that my session has been approved ๐Ÿ˜€.

My session is “integrating IBM Connections Docs with Box” and is scheduled for May 31 in the afternoon.

As usual the DNUG team has set up a great event, suffice to say that the keynote speech will be given by ICS General Manager, Inhi Cho Su.

You can check the full agenda here http://44.dnug.de/

There will be several IBM Champions speaking and it will be an occasion for me to meet again many friends.


panagenda ApplicationInsights. A first look

In April panagenda has announced the release of ApplicationInsights, a tool to analyze your Domino environment. The most important features are geared towards the analysis of the applications both from the point of view of utilization and the complexity. It allows me to see how complex is my environment, drilling down to the single applications measuring complexity, code quantity, external dependencies and so on. Apart from the obvious usefulness of being able to see and measure the status of the environment, the results allow us to analyze where to work in case we want to migrate an application, move it from a server to another, optimize it or modernize it.

A note: if you want to test it, take your time. ApplicationInsights needs to run for a couple of days in order to collect meaningful data; do not think you can install it and see the results in a couple of hours.
The test have been done on our server, this means a lot fo code to analyze but few accesses.

After the installation and configuration ( pretty easy and fast, it just needs a Notes ID able to access to the servr and the applications ) AI begins to analyze the environment; I let it run for 48 hours and came back to see the results.
After the login it shows me the dashboard. Apart from the number shown at the top ( but we really do have so many files on the server ? ) I see the results I expected: few activity and variable complexity

Drilling down I can see how my databases are split

Now I drill further down, I search for an application listed as complex and check what the reports says

Now I have a better idea about how the application is complex and by how many elements is composed. As you can see we’re not talking at all of the data contained in the application but only of the design, since the analysis is done on this part. Drilling down more I can see, for example, how may agents are there in the application and how are they split

In this case I have 72 agents for a total of 7758 lines of code and of those agents 26 are scheduled. This is a good point to consider if I wanted, say, to move the application to another server; in this case I can foresee i need to check those 26 agents to change the schedule.
Continuing to drill down into details, to check what I can see and actually I find a lot of information, analyzing the application AI has checked all the design elements and now it can say me category by category what has found

Here I can see if something sends a mail, how it does, if I have connections to the Domino NAB or if I perform some operations at the OS level. This last information is useful if, say, I am planning to move the server from Windows to Linux.
Below I can see if the application works with connectors or if uses Lotusscript extensions: in this case the application has connections to DB2 and AI reports it correctly.
Still below I found if the application does External C Call, e.g. OLE, if it writes and/or reads extrnal files of the OS, executes calls to external programs and so on.

I finish this post with some considerations based mostly on experience: Notes/Domino is present since many years at customers and the applications written during the years have stratified. Often we need to work on applications written years ago end finding someone who knows exactly what it does and how this applications works is difficult. Maybe the person who developed the application is not working there anymore or, having a lot of time passed, he does not remember what he did and maybe has not documented everything.
In all those cases I believe that having a product like ApplicationInsights can really make a difference and be very useful.
Apart from this, ApplicationInsights is very useful to make an assessment of the environment and check the usage and the complexity.
If we want to work on the applications to modernize them or add other features, that is where a tool like this becomes essential in order to have a correct idea of the situation and of the points where to work. I have the feeling that dedicating more time to the study of ApplicationInsights, I will find other useful features I have not yet seen and used.


OrientMe in a test environment. How to make it work

For all my test systems I do not use a real domain name, I usually go with something like server.roberto.local or the like. This is a problem when you try to install the new OrientMe component that IBM has shipped with Connections 6.

The install scripts perform a nslookup and check the domain name then add the resulting IP address to your host file, then it will try to connect to that address and obviously fail. The strange thing is that it will return an IP address also for .local domains, so basically whatever is your fake domain name, it will find a valid IP and fail the installation.

There is a workaround to make it work, it requires changing a few lines in four files.
When you install OrientMe, the instructions say to copy the deployCFC folder to /opt; open a terminal and go in /opt/deployCFC. There are several files in there, we need to modify the following four:
A-03-all-setup-hosts.sh
A-04-boot-setup-ssh-keys.sh
B-20-boot-setup-cfc.sh
B-22-all-configure-cfc.sh

Open for editing the file A-03-all-setup-hosts.sh and fine the following line
ip=${resolve_ip_return_result}
then change it to
ip=your ip address (192.168.1.x or whatever you use)

Open for editing the file A-04-boot-setup-ssh-keys.sh and do the same as above

Open for editing the file B-20-boot-setup-cfc.sh and find the following 3 lines:
master_ip=${resolve_ip_return_result} and change it to master_ip=your ip address
worker_ip=${resolve_ip_return_result} and change it to worker_ip=your ip address
proxy_ip=${resolve_ip_return_result} and change it to proxy_ip=your ip address

Open for editing the file B-22-all-configure-cfc.sh and fine the following line
master_ip=${resolve_ip_return_result} and change it to master_ip=your ip address

Make sure you have your server name and IP address in the /etc/hosts file

Now here comes the fun bit ๐Ÿ™‚ In the /opt/deployCFC directory there is a file, manifest.md5, that contains the MD5 hashes of the script files, e.g. MD5 (deployCfC/00-all-config.sh) = f826bfd38a81ecafc55020563dc3db75
So if you try now to run the modified scripts it will not work throwing a checksum error.
You have to do the following: for each of the 4 modified files, compute a new MD5 hash, use the command md5sum to do that, e.g md5sum A-03-all-setup-hosts.sh you will get
a77f66e359a4e1f531d8220bb3f309b6ย  A-03-all-setup-hosts.sh

For each file get the new string and put it in the manifest.md5 file replacing the original one and save the file.

After those changes the installation script will connect to your server and the installation will proceed successfully.

A word of caution: do try this only for test environments where you do not have a real domain name available. Do NOT do this for production systems, those will have a proper domain name and you do not need to do this, also because if something goes wrong IBM will not support you if you have changed the script files.



IBM Verse on Premises, enabling encrypted and signed mail. You may need to do something if you have your ID in the mailfile

For Verse on Premises in order to write and readย  signed and/or encrypted mail is enough to set up an ID Vault on the Domino server and add the user’s ID to that.

I found that if you previously used iNotes for mail and have added your ID to the mailfile, then you will get an error while reading or creating a signed/encrypted mail; the error will say that your ID is not in the vault, even if actually the ID is there.

In order to fix that, you need to access your mail with iNotes, go in Preferences – > Security and click on the button Sync with Vault

Once done that, everything works


Speaking at SNoUG and Engage

My next speaking engagements are in Switzerland and Belgium.
On March 22 I will speak at SNoUG, the Swiss IBM User Group, in Zurich. I will have a session on “IBM Verse on Premise”.

On May 8-9 I will speak at Engage, the most famous and attended User Group in Europe, it is practically a Connect Europe if you look at the quantity and quality of the speakers. I will have a session with the amazing Sharon Bellamy James on “Troubleshooting IBM Connections”

Hope to see you there!


Domino Feature pack 8 breaks Verse on Premises

I installed Domino Feature Pack 8 and the new templates and Verse on Premises stopped working.ย  The installation of the FP replaces a lot of files in Domino and it had reset the \data\osgi\shared\eclipse\plugins directory removing the files I had copied there for the VoP installation. I copied again the files there. Also there is a new template mail9.ntf and this does not have the views needed for VoP, so I had to copy again the 5 views from the VoPdesign.nsf database in the mail9.ntf template, then run the design task to update all the mail files.


IBM Verse on Premises 1.0.0.1 Interim Fix 1 shipped

Yesterday IBM released the Interim Fix 1 for IBM VoP 1.0.0.1

The list of fixes is the following

Fix introduced in release SPR Description Additional Information
Verse On-Premises 1.0.0.1 Interim Fix 1 261564 Issues when searching for messages from someone whose address format is their name in quotation marks followed by their email address enclosed in brackets.
261382 Inbox doesn’t work with specific messages
261684 Verse impact – Meetings created in iNotes using OS time zone are off by two hours

You can download the IF1 from Fix Central at this address
https://www-945.ibm.com/support/fixcentral/swg/selectFixes?product=ibm%2FLotus%2FIBM+Verse+On-Premises&fixids=Verse_1001IF1&function=fixId&parent=Collaboration%20Solutions

To install it you need to remove the files added in the c:\Domino\osgi\shared\eclipse\plugin directory by VoP 1.0.0.1 i.e.

then unpack the new IBM_Verse_On_Premises.zip in the same directory


IBM Connections CCM upgrade to CR2 and special characters in passwords

I was updating a Connections install to CR2 with CCM; when it came to update the FNCE server I ran the command
C:\IBM\Connections\FileNet.update\scripts>update-ce.bat -was.dm.path=c:\IBM\WebSphere\AppServer\profiles\Dmgr01 -was.admin.user=localadmin -was.admin.password=password -conn.home.location=c:\IBM\Connections -ce.fp.installer.location=C:\Downloads\ic55cr2\filenet\5.2.1.4-P8CPE-WIN-FP004.EXE
The update-ce command runs wsadmin to connect to the DM as a first thing.

I got an error, the Deployment Manager is inaccessible.

If I tried to run wsadmin manually I could connect to the Deployment Manager, so I was puzzled.
I decided to ask the community for help and I picked the excellent Ben William‘s brain.After chatting for a while it came out that the user I was using to run wsadmin had a password with a special character in it, a ! Ben suspected it could be the cause so I created another user in WAS, with a password without special characters, gave it admin roles and run again the update-ce command.
Everything worked this time ๐Ÿ™‚

So my advice is: choose your admin passwords carefully, otherwise sometimes you can run into problems. I usually mix letters and numbers, caps and no caps, but I try to avoid special characters.


A kind request to conference organizers

In those last two years I spoke at several conferences, from IBM Connect to various user group meetings. I have a request for the conference organizers; if you give to the attendees a sheet for the sessions evaluations, please share the results of the evaluations with us speakers. This does not always happen. It would be beneficial for me as a speaker to know how good or bad I performed. If something is wrong I can work towards correcting it, is not just a matter of ego, though everyone likes a good rating.