Skip to main content

Admin Notes: Adding a Certificate to the Lotus Domino JVM Cacerts keystore

It seems that I get called upon frequently to add certificates to the Lotus Domino JVM cacerts keystore.   I think the developers are using it for some sort of web service request.

I thought I'd post it here in case there are other people like me who need to do this occasionally, and can never find the default password, or forget the syntax to install a new ssl certificate.

Fig. 1 - Navigate to the Domino JVM security directory

Step 1 - Navigate to the Domino JVM security directory.   For me, that's c:/lotus/domino/jvm/lib/security.  For simplicity sake, I put the .cer certificate file in the security folder.  It let's me quickly know which certificates I have installed in the cacerts on that server.

Fig. 2 - Install the certificate in the cacerts keystore

Step 2 - Enter the command to install the certificate in the keystore.   The tool to use is called keytool, and it's located in the jvm/bin directory.

The command line to install the certificate looks like this:
keytool -import -trustcacerts -alias certificate -file your_certificate.cer -keystore cacerts
The important part for you to change in the line above goes like this, the word after -alias signifies the name the certificate is referenced as in the keystore.  The word after -file is the name/location of the certificate you are installing.  The word after -keystore is the name/location of the keystore file.

Once you enter all of this, and press enter, you will be prompted for the password for the cacerts keystore.  The default password for the keystore is 'changeit'.  Clever, eh?   Enter the password (changeit) and press enter again.

Fig. 3 - Prompting to accept the certificate
Step 3 - You will be prompted to accept the certificate.  Type 'y' or 'yes', if you trust it.

Step 4 - Restart your Lotus Domino server or service.  Try to do it when there are no users on the server.  Causes less complaining.

Let me know if you found this useful.  I've added it to the Lotus Notes and Domino Wiki, and registered to win free stuff from WikiMadness.

Comments

  1. Thanks for this, I just had to do this and it's not documented (or at least I couldn't find it).

    ReplyDelete

Post a Comment

Popular posts from this blog

Error 217 - Error creating product object on Domino 64 bit

I'd like to share something with you.   An error that you'll get if you are trying to use ODBC with Domino 8.5.1 64bit. It starts out with an agent error of Error 217.  The text of the error is "Error creating product object" You can read about it here on the Notes/Domino forum . You can find the solution here as well . I guess I'm now waiting for Domino 8.5.2 for a solution for this.   It would have been nice to have had this in the release notes.  It would have help me greatly.

Fun Little Earthquake

It's 1:45pm EST in Ottawa, Ontario, Canada. We just had an earthquake.  Not strong enough to damage anything, but enough that I watched people run out of buildings. What a fun Wednesday.

Reminder: Increase the maximum available memory on your Lotus Notes client JVM today!

Yup, that's right.  Public Service Announcement time. If you haven't increased the maximum memory available to your Lotus Notes JVM yet, what are you waiting for? By default, the Notes JVM only has 256mb of memory available to it.  On a system with 4GB+ of memory, you should be easily able to increase it to 1/4 to 1/3 of the system memory and improve the end user performance. Here's how: Shut down Lotus Notes. In order to make sure that all processes are stopped, run this command:  Start -> Run Type: C:\Program Files (x86)\IBM\Lotus\Notes\nsd.exe -kill Open: C:\Program Files (x86)\IBM\Lotus\Notes\framework\rcp\deploy\ Open the "jvm.properties" file in a text editor like notepad.  You will possibly require Administrator permissions. At the beginning of the file, you will see text surrounded by a lot of pound signs ####. The first ‘property’ after the last # sign is: vmarg.Xmx=-Xmx256m Change 256m to 1024m so that the line reads: vmarg.X