Notes/Domino

A Domino Server migration tip for part time / ex Domino Admins

Ross Hawkins — Thu, 19 Apr 2012 22:39:37 GMT

One of the things I always loved about the Lotus Domino Server was how easy it was to move it to new hardware. Run the installer, copy the data directory (and .ini file if needed) and boom – server comes up as before, no problems.

So when I recently did a migration (for my last remaining Domino customer) where the drive structure changed I was surprised to see logging errors appear as it was trying to access the old Domino Data path. Turns out the culprit was Traveler. To fix this, simply edit the %DominoData%\traveler\cfg\NTSLogging.properties file and update the paths to be correct.

I suspect if you’re working with Domino a lot, or spent any amount of time reading Traveler documentation then this is probably pretty obvious, but for someone who hasn’t needed to touch a Domino server in a while you might get a bit thrown off by seeing a reference to the old data directory appear on your console!

Tags: Lotus, Domino

Where does technical debt come from

Ross Hawkins — Mon, 14 Mar 2011 06:40:29 GMT

Over the past year I’ve been dealing with some technical debt across a couple of different ASP.NET applications that we recently inherited. As part of that work I’ve spent a bit of time thinking about technical debt, how to deal with it, and how to avoid it. Describing the subject of technical debt as interesting might be overstating things a little however it is a subject which is relevant to most developers at some point in their career.

So when I read this article (Lotus Notes - a Double Edged Sword) it struck me as a great example of where technical debt can come from. The post describes an application which was thrown together quickly to help co-ordinate disaster relief volunteers working to help with the recent earthquake in Christchurch New Zealand. Here’s a snippet from the post:

The speed of development and ease of deployment (zero installation, fault tolerance, and client independent) was just one side of the sword. The other side of the sword is the speed at which you can develop & deploy doesn't leave time to consider the user interface or experience and the default isn't particularly inspiring (not that coordinating arrival times and accommodation is EVER going to be sexy)!

I’m not picking on Lotus Notes here as you can easily find examples of this sort of this occurring with any development environment, however Notes’ capabilities as a rapid application development platform do make it a prime example of how temporary or quick fix applications can end up being used for a much longer time period than intended. In fact back when I was developing Notes and Domino applications I remember many times where a client looked at the quick and nasty sample prototype I’d thrown together and said “It looks great, let’s put it live!”.

Examining this in the context of a disaster scenario is interesting as the priorities are shifted – speed is king. Often when it comes to technical debt you can place the emphasis on the developer to insist on doing things properly in the first place and to refuse to compromise on quality in order to save time (as much as possible), and that doesn’t fly in a time of crisis. Instead, in my opinion the emphasis needs to shift to the business to ensure they recognise the technical debt and budget some time to go back and either retire these temporary applications, or spend some time bringing them in line with good development practice.

Identifying that rapid development can sometimes come with consequences is a great step towards avoiding large amounts of technical debt later on down the track – of course the other steps involve taking time out to address those issues before they become a larger problem.

Tags: Lotus, Notes, NZ, Technical Debt

Notes/Domino Application Review for Upgrading to Version 8.5.x

Ross Hawkins — Wed, 21 Jul 2010 09:59:58 GMT

Application Review for Upgrading to Version 8.5.x – it’s pretty short, which is a good thing.

I do think it’s kind of funny trying to sneak subconscious messages in there trying to remind “some” developers that Option Declare is good, but I guess when it comes to teaching best practice you have to do whatever works. If that means telling people that by not using Option Declare they may die them in their sleep, then so be it.

Tags: IBM, Lotus, Notes/Domino

It happens a lot, Notes 8 client running with a Notes 7 mail template

Ross Hawkins — Wed, 21 Jul 2010 09:52:34 GMT

Notes 8 client running with a Notes 7 mail template – it happens a lot, for various reasons (lots of them in the comments if you care). It strikes me that some of the positive things about being able to customise a mail template can also lead to some very negative things, such as being a software vendor and giving up a lot of control over how your mail environment appears to your users.

In some ways, you’re putting potential customer satisfaction in the hand of Administrators – and while there’s some great admins out there, simply looking at the nature of any distribution curve dictates that a lot of them will not be so great, and not care/know about templates, and hence affect the experience of their users.. which they will of course blame on the product.

People drinking the Yellow Koolade love the fact that the product lets them approach their migration in steps, and allows time for their mail integrated fax vendor to upgrade their product (Hint: Upgrading any fax product really should involve removing faxing entirely. It’s 2010 for crying out loud.) while not holding up their server and client upgrades – however all the user sees is that their mail experience looks the same as it has for years, and asks “What did this upgrade give me?”. Certainly not a double dose of d (come on, someone get the reference, please?).

About 8 years ago I ran into a journalist who was writing about how much he hated Lotus Notes – back then, he was running R6 (from memory), but had a R4 client. I send him a ~~flame~~ mail and showed him a screenshot of my personal mail template, and of iNotes, and the reaction was a mix of “Hey, cool”, and “How come I don’t have that?”. He was a technical guy, but didn’t care about Notes – all he knew was “I’m on R6 and it’s awful”, even though the mail experience was R4. Not his fault, he called it like he saw it, and it looked like crap (and he did post a retraction of sorts after seeing my screenshots).

So, no conclusions, other than the fact that what Ed is blogging about isn’t exactly a new phenomenon, and that it reinforces the fact that sometimes giving the customer too many options and too much control can be a detrimental thing.

Tags: IBM, Lotus, Notes/Domino

On Vowe’s recent DNUG posting and similarities in NZ

Ross Hawkins — Sat, 12 Jun 2010 15:12:36 GMT

You only have to glance at my tag cloud or my site introduction paragraph in the sidebar to the right to see that I’ve not called myself “A Notes person” for quite some time – however I still have clients who use the technology, and as such I can’t help keep an eye on things.

Vowe’s recent post “Things I learned at the DNUG conference in Berlin” shows that a lot of the things I’ve noticed about the IBM/Lotus market in New Zealand are happening in other places too. New Zealand has always been a stronghold for Microsoft, and so when IBM claimed that the global brand was doing so well it was easy to figure that it was just New Zealand where it felt like the future of the product was in doubt.

I have more to write about this in the near future, but it’s important I take the time to write it up properly before posting, so for now here’s some comments on Vowe’s post with a New Zealand perspective thrown in.

On DNUG conference attendance:

It's the customers that are staying away. If you look at the conference guide listing all attendees, you can't help but notice that the largest contingent are IBM and Business Partners. While BPs have a large incentive to go there and get their people to learn new stuff, they also attend to meet new customers. That is why they sponsor the conference and set up booths.

Certainly this has felt like the case at New Zealand based IBM events. It’s the same BPs attending, and a distinct lack of customers. Compare that to something like Tech Ed which always sells out very quickly, has a buzz of excitement around it, quite simply feels like a major technical event should. I attended Lotus Fusion in the Gold Coast of Australia around 1999 which had a similar feel, but that’s the only IBM event I’ve ever attended that did.

I am finding there are quite a few people looking for work in the Notes space. When they lost their jobs, they try to go freelance, but the demand is low, and some are not made to go it alone. Not a problem for the flexible, strong people, but certainly so for the average. The drive to the cloud will only accelerate this trend. You definitely need fewer people to run the shop. That's one of the driving forces.

I have some stats available from the a another angle here. For the past 2 and a bit years I’ve been subscribed to SEEK (the main job search website in New Zealand) summary mailings, which send out regular mails based on various search criteria. I’ve had one running for Notes/Domino for many many years, and have left it going alongside an ASP.NET one in the interests of comparison (I’ve not actually looked for a job in many years). Here’s the criteria I’m using in the SEEK website for each of the separate profiles:

ASP.NET: ASP.NET OR .NET OR C#, in the Auckland region, IT&T Classification, with any sub classification.

Lotus Notes/Domino: (LOTUS AND NOTES) OR DOMINO, in the Auckland region, IT&T Classification, with any sub classification. It’s important to notice that the Lotus Notes criteria is quite broad, and most of the jobs which match this criteria are first/second line Helpdesk support roles. So they’re rather irrelevant, and make the numbers a lot higher than they would be otherwise. It also means that search will be returning potential Developer and Administrator positions, whereas the .NET search results are almost always relevant developer jobs. So the Notes subscription has a chance of making things look a bit healthier than they are. I had to do Lotus AND Notes because otherwise I was getting false matches on things like "Notes for this job: You must turn up fairly sober.” and things like that.

Anyway, here’s the results graphed quickly in Excel:

While these aren’t the most scientific of statistics, I do find them interesting to look at (and of course the drop in both at the end is due to it being a part month of June – I should probably have cut all of June out, but oh well).

An interesting side note about these statistics is that I used Lotus Notes to help compile them. The easiest way to grab the raw data from the Gmail folder was to connect Notes via IMAP, copy the documents into a local database, and create a quick view summarising the data before throwing it into Excel. Irony is always funny.

While I want to believe Lotus management that they are well equipped to compete in the global market, I would not want to accept the same for the German market. But that's just me.

No, it’s probably not – it’s certainly been the feeling in the New Zealand market for quite some time too.

There’s some great features that have been delivered for developers, administrators, and of course the business in the 8.x stream of releases, and yes Lotus has been improving their marketing, but it feels like too little too late. In cases where IT strategies were formed a while ago I suspect it would take a lot more than recent improvements to convince IT Managers/Directors to reverse their decisions and stick with Notes/Domino (although of course it could happen, and fairly easily in some cases).

In my client base a few of my customers are actively engaged in the process of their migrations, with enquiries from another about wanting to start theirs. Some of these migrations are due to them running old applications which haven’t had a design overhaul in years, and yes these applications could be updated to use XPages and other recent technologies, but the clients are simply not prepared to spend the money on these things – in their minds, it’s money better put towards their migration plans. Given that the applications have a legacy feel to them, I’m certainly not complaining about not having to maintain them anymore.

Obviously the German/European market and the New Zealand market are very different, but as a bystander it is interesting to know that the same patterns are emerging in more places than just here*.

(* well, technically there not here given I’m in Norway at present!)

Tags: IBM, Lotus, Notes, Domino

Fixing an issue where DominoBlog displays categories incorrectly

Ross Hawkins — Sun, 30 May 2010 18:20:27 GMT

Issue: One or more of your categories in a DominoBlog isn’t displaying correctly. Instead of seeing the contents of the category you see a set of DX tags, i.e. $DXSubjectLink$ and so forth as shown in the image below:

A quick search reveals that there's a few other people who have this issue, but no one mentioning the (rather simple) fix. As I don’t use DominoBlog it took me a little while to find out what was causing it so thought I’d mention it here in case it helps someone.

Simply edit the content category document, go to the ‘Formatting’ tab, then ‘Template Overrides’, and make sure you haven’t accidentally selected intentionally from that list (i.e. ‘Document’).

Simple to fix, but possibly harder to find.

Tags: IBM, Notes, Domino

OpenNTF projects for Feb

Ross Hawkins — Thu, 11 Mar 2010 09:06:22 GMT

Yes, I know it’s March – I clicked this link in Feb but haven’t had a chance to sit down and watch the video until now.

There’s some very good stuff in here. The widgets I can mostly take or leave (although the File Manager one has some good potential for anyone using a Notes client for day to day use), however xTalk, the Next Gen Discussion template, and the xPages Wiki all look very useful indeed.

On the developer’s side of things, part 2 covers some useful XPages controls.

These are the first OpenNTF videos I’ve watched. I think they work really well – especially for things like Widgets and reusable controls where it’s nice to get a quick glimpse of the code in action.

A nitpicker’s note – I noticed in one of the Widgets that the preferences refers to a Notes Server – what’s that? Slightly amusing that even the professionals have a hard time keeping track of the basic terminology, no wonder Notes end users get confused at times!

Tags: XPages, Lotus, Notes

My Notes Client Setup

Ross Hawkins — Wed, 10 Feb 2010 23:07:16 GMT

After building my new Macbook Pro as well as rebuilding my main rig on its new Intel X25 SSD I wanted to briefly document my client setups for Visual Studio and Lotus Notes/Domino. So to get started, here’s the Notes/Domino post.

Firstly.. I install the client! I’m currently using 8.5.1, but ideally would be running 8.5.1 with 8.0.2 basic installed concurrently. Why? 8.5.1 is an utter pig for making quick design changes over slow remote connections – and this is how I do a lot of work for my clients. Setting the project to build automatically often means making a trivial change to a view column can take 10 minutes. Turning off build automatically is an obvious solution, but yeah, 8.0.2 for trivial/reactive changes would be ideal. Running a VM on my MBP isn’t an option due to the size of the SSD, so if you’ve got any hints on installing these 2 clients side by side please post them in the comments.

Add Remote Console icon to the toolbar – I very rarely run Domino Administrator. If you want to send a quick one off command to a server or view the console output while running an agent then this is the quickest way to do it. Simply add a new icon with the formula of @Command([AdminRemoteConsole]). Incidentally, the list of previous servers that appears in here has always seemed a little random – I’d love to know how to add/remove entries here.

Add Debug Lotusscript icon to the toolbar – I add the standard toggle debugging icon to the Universal toolbar for quick access.

Add Chad Smiley’s Edit Document Fields – very handy for fixing corrupt fields. Latest version here, change history here.

Apply the Eclipse RAM tweak - documented here, it really does make the Eclipse client feel snappier. If you don’t want to follow the link, the quick version for 8.5.1 is: browse to {NotesProgramDirectory}\framework\rcp\deploy\ and find the “jvm.properties” file. Look for the line “vmarg.Xmx=-Xmx256m” and change this to a suitable value such as “vmarg.Xmx=-Xmx1024m” (depending on how much RAM you have).

Decrease delays for LotusScript autocomplete and hover - documented here at DominoGuru.com, this little fix really helps my sanity while coding. The default values are simply a little too slow for my liking.

Create a shortcut to my Notes Data directory in my user folder – I could add it to my Windows 7 favourites or to a jumplist, but I prefer it with the shortcut. I don’t go there too often, but when you want to paste in a template or something like that it just speeds things up.

Add a NotesDBS.dir file to the data directory – to store any large databases off the SSD.

Set some colours/fonts for the LotusScript/Java editors – A few personal tweaks to get it as close to my Visual Studio setup without spending too much time on it. I set the font to Consolas 10, and remove the bold/italics (which just looks silly in my humble opinion) and make a few other minor changes.

(Optional) Install BCC_ClientGenie - I'm running this on my desktop but not my laptop yet. I’m a sucker for skinning apps and making them shiny, and lets face it the Workspace is long overdue for an overhaul. I’m quite surprised that there aren’t more people making skins available for this thing, I’m sure there must be someone out there with some PhotoShop skills who’d like to make their Notes client look shiny (I’m looking at you Daniel).

Other stuff – things I’m not running, but have looked at. I did some work trialling SWING Software’s PDF conversion tools for a client (well, 2 clients actually). Both of them went in other directions for those projects, but SWING’s tools were really impressive. If I had a need for Notes/Domino PDF conversion then I’d definitely look to use those tools.

I’ve played with a few developer based Sidebar widgets (File Nav, Snippets, and a couple of others), but none of them really seemed to improve my development experience. I see people talking about various Widgets, but haven’t really found many which have made me go “Wow” – what am I missing?

A while back I mentioned I was looking for Notes/Domino refactoring/analysis tools, and despite the wealth of options supplied in my comments I’ve ended up using a manual but free and effective solution for the searching side of things, which I’ve documented here. I’m sure there’s some Eclipse plugins coming soon to make this process a little slicker.

So that’s my current setup. If you’ve got a tweak, widget, or setting change which you wouldn’t be without then please tell me about it in the comments below - I’m very keen to refine my list and I’m sure there’s some great Widgets out there which I haven’t come across yet.

Tags: IBM, Notes, Domino

Asleep at the wheel during a server upgrade

Ross Hawkins — Tue, 09 Feb 2010 23:45:47 GMT

I’ve upgraded a LOT of Domino servers in my time, and so yesterday when I upgraded another one (Windows 2003) to Domino 8.5.1 I was expecting another smooth ride. After running the install wizard it informed me that the computer needed to be restarted – interesting, as I don’t recall needing to do a Windows restart for previous upgrades, but who am I to argue?

As the box was coming back up it locked up at “Applying Computer Settings”, meaning logging in via console or RDP was unavailable. It took me a minute to realise what had happened – the Domino Service had automatically started and it was sitting there asking if I wanted to upgrade the address book’s template. It took a little while to realise what was going on as I’ve never needed to restart Windows after a Domino upgrade so I’d never seen this happen before! A simple boot into safe mode to set the service to Manual followed by a reboot and a manual start of the Domino server and all was well.

I am interested as to why this box needed to be rebooted, when others I’ve upgraded haven’t. My only theory is that it had a hotfix applied to it and perhaps there’s something in that which needed a reboot, however I really am guessing there.

Tags: IBM, Notes, Domino

Searching the contents of Notes/Domino design elements

Ross Hawkins — Wed, 20 Jan 2010 05:37:09 GMT

I recently posted asking for recommendations for Notes/Domino refactoring and analysis tools. Thanks again to all of you who responded, and also to Ryan from Ytria who emailed me directly (even though I’ve been too busy/slack to respond).

After thinking about it, I realised that really it was the Find/Search side of things which was important to me, and Andre Guirard recently posted about how to Export all code of an NSF to file system, which looks to give me access to the solution I was after - even if it is a little bit manual.

Using the Eclipse-based Domino Designer, because the Notes application corresponds to an Eclipse project, various functions are available that apply to Eclipse projects generally.

I had a request recently to export all the code in a project to disk so that an automated code-checker tool could be run against it. My initial thought was to use DXL, but the DXL representation of some design elements doesn't make it easy to extract the code. JavaScript libraries, in particular, are hard to decode.* So I looked for an alternative. Here's what I found.

Go and read Andre’s post for the full details on how to do the export. Pay attention to the bit where he says “if you have as many databases in your outline as I have, it may take some time to populate this window. Be patient" - he’s not kidding, especially if some of your databases are on remote servers (I access a few of my client’s systems via WAN links).

So that’s the code in your file system – now what? Well, you want to search for something!Unfortunately how you do this is going to change a little bit depending on what OS you’re running. Windows 7 will only search the content of files that it knows about – you can change which files it searches inside of by running Indexing Options and setting “Index Properties and File Contents” for the relevant extensions. Of course some of the extensions it creates might not be known by Windows (you probably have .lss, but .lsdb, .lsa, .javalib, .jws, .lws you probably don’t), so open them with Notepad (or SublimeText if you’re like me) to get them in the list, or do it manually.

Right, sorted? Nope. Because you might have noticed that there’s an awful lot of files in the output directory which have no extension. While you can probably change Windows to search inside those files if you wanted, I suspect that isn’t a very clever idea.

It was at this point I turned to Powershell. You could of course use any other grep like substitute for your OS, however I didn’t want to install anything else and have been meaning to find reasons to mess about with Powershell anyway.

Here’s a variant of Powershell’s grep equivalent:

gci . * -recurse | select-string "your string here"

…and finally, we have our search results! Hardly the most integrated of searching, but hey it works and it’s free. I'm going to have a look and see if I can automate/integrate this at all, but for now it gives me what I need so I’m happy.

As a side note, I use Console2 instead of the standard Windows command prompt. This lets me run one utility and switch between tabs to access a standard command prompt, a Visual Studio Command prompt, and a PowerShell easily and quickly. It also looks slick too, and has configurable options for things like Window transparency.

Tags: Notes/Domino, IBM, Lotus, Powershell