Another great developer book found

Summer is here and book reading time for me is also here, I’ve read and added this great resource to my desk at work, JQuery and Javascript Phasebook.

JQuery And JavaScript Phasebook

I often like to have all my resources as pdf files but in some cases a reference book can come in handy. Easy to pick up without the need for extra screens (They are full with applications anyway)

This book is one of them, if you develop using jQuery this book has lots of short code snippets that will come in handy when developing using JQuery and Javascript.

 

 

 

The book has the basics of setting up the JQuery framework and start using it to creating Dom nodes, setting css styles,classes. Adding animations to elements and also a little section on how to use JQuery mobile.

And the great part is that the book has quick explanations and then a code snippet that you can test, So you will get a great reference guide and also learn to use jQuery more when you develop new applications.

The books developer audience is developers that isn’t experienced JQuery Developers but what to get started or just started to use JQuery.

Get your own copy here or from amazon

Setup a Free Git server with Domino Credentials in a few minutes

Today I’m going to show you hav to setup you own internal Free Git server in five minutes

Make sure that you have java version 7 installed in you windows server. JRE or JDK any version works. If you don’t have one goto java.com and install the a java jre.

Goto the java download page scroll down to the bottom of the page and download the JCE

Java_JCE

Open up the downloaded zip file and copy the 2 selected files

To the folder lib\security below your java installation folder in my case it was

C:\Program Files\Java\jre7\lib\security you might need to replace existing files nothing to worry about.

This is needed to be able to create the certificates later.

Next step is to  gitblit.com wher your download the Go Git Blit Server for Windows or if you are using Linux or Macosx use that version.

GitBlit

Unzip the zip file in the root to a folder called gitblit or a suitable sub folder, if you change the folder you might need to change url:s in the .cmd files.

Configure GitBlit

We are now going to configure gitblit to use LDAP as authentication method

Open up the file gitblit.properties in the data folder, search for the keyword realm.userService edit this line so the line should look like this realm.userService = com.gitblit.LdapUserService

Setup the connection to the LDAP server

realm.ldap.server=ldap://localhost change the row if your LDAP server isn’t on localhost remember if you want to connect to a domino server and it’s hosted on a windows machine that has AD LDAP on it you need to change the port for the Domino LDAP service.

The syntax if you want to change ip or port is like this ldap://192.168.10.10:399

You also need to change the login user to be able to use the domino LDAP Service

realm.ldap.username = LDAP Manager

realm.ldap.password = your password

To a Domino user and password

Clear the accountBase so it will search all Nodes

realm.ldap.accountBase=

Change the accountPattern to

realm.ldap.accountPattern = (&(objectClass=person)(cn=${username}))

Empty the groupBase to search all nodes for groupsrealm.ldap.groupBase =

And the groupMemberPattern to find groups

realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))

realm.ldap.admins can be edited to add a admin group from LDAP

change the row realm.ldap.email from email to mail

And the row realm.ldap.uid also to mail

Important last step, search the file for localhost and remove that otherwise gitblit will only operate on localhost and you can access it from another machine

Save the file

Generate SSL Certificate

In the Gitblit folder in my case c:\GitBlit there is a cmd file called authority.cmd (if you have another url you might need to modify the file)

start authority.cmd add the information about your certificate

Write the password for your keystore, write gitblit if you don’t want that password you need to edit the gitblit config file so the password match.

The keystore is generated and the cert admin is opened

Close the Window

Start the Git Blit Server using the gitblit.cmd the server will now start in the window.

Your Git server should be up and running now. Let’s access it thru a browser.

Write https://servername or ipadress or localhost and end the adress with :8443

but if you want to use http instead you need to edit the gitblit.properties and change the row

server.httpPort =0 to have the port for the http server i.e. server.httpPort = 8080

The GitBlit interface will load.

Try to login using your Domino credentials

When you have logged in, logout again and login using the standard admin user

username: admin password: admin

and assign yourself as an administrator and change the password of the default admin

Login with your user again

Now your ready to create your first repository

Next step is to connect your git client to the repository. Some clients like sourcetree needs a special setup to accept ssl that is created using a self cert. But that is for the next post.

Importing a Files and folders into a IBM Domino database

I saw a question today inside a linkedin forum about how to import files and folders into a Domino database and there are several ways on how to do this. Check out these three ways of importing files and folders into your nsf file.

1. Import the files into the webcontent folder using package explorer. using import

Snap17

 

 

 

 

 

 

 

 

Select general -> file system to import files and folders

eclipse file import

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Browse for the from folder, any subfolder will be the top folder when imported into web content in this case bootstrap

eclipse file system import

And then your files and folders look like this after the import

Snap20

 

 

 

 

2. Enable the database for webdav then you can connect to the database using windows and upload the folder/file structure into domino. Super simple and quite easy to maintain. (Link to how to setup this or this old Codestore post)

3. Build an agent that will import the file resource using dxl check out this TLCC article in how to import using DXL.

HTTP Server is waiting for threads to finish: the wait is over part 2

If you did read my post yesterday about how to break long running requests on the Domino server if not you can find it here The wait is over part 1
S
ven Hasselbach commented that this didn’t work for him and yes he is probably right because I suspect that Sven was trying a long running XPage and yes you can’t break them using Restart Task Http but I have a solution/workaround but that requires you to implement a failsafe into your long running code.
If you add this inside your long running loop

if(applicationScope.get(“BreakAllCode”)==true){
  break;
}

And create an Admin Failsafe XPage with a “Break it All” button with the code

applicationScope.put(“BreakAllCode”,true)

And a second button called “Reset” with the code

applicationScope.remove(“BreakAllCode”)

To bring back the application to a normal state.

If you then open up the “Failsafe” XPage if your code has gone wild and click the button you can quit the code that has gone wild.

 

HTTP Server is waiting for threads to finish: the wait is over

How many times have you tried to stop the http task on a Domino server and got this back on the console

HTTP Server: Waiting for session to finish: Session State [Processing Request]

And there you are waiting and waiting for the http to restart och shut down

The solution is not to use tell http quit or tell http restart if you want to shut down http

Use restart task http instead if you want to restart http or restart task http and when the task is restarted use tell http quit.

This will force the http to restart and will not stall the restart because there are some long running requests or view updates that is blocking the restart.

Update: if your using XPages see the Wait is over part 2

Mastering XPages – a good addition to every XPagers bookshelf

As I promised in my previous article  about the book here is the review of Mastering XPages.

I did read the old Mastering XPages from cover to cover over a couple of days when that one came out. And have been using it as reference but not enough I understand now. While reading the second edition of Mastering XPages I had to go back into the first edition several times, was this really in the first edition? And yes it was, I hadn’t read the first edition enough it seams.

I rediscovered some forgotten knowledge about custom controls and communication between custom controls and setting properties on each other. This isn’t something new it was in the first edition, while rereading the updated parts it really updated and verified alot of knowledge for me. Adding some of the new stuff where you get a new angle to things as performance, extending the Notes client XPinc, Mobile and more. All this information together with real example databases where you can try the explained content for your self. I must really say that this is good starting point if you want to start learning XPages or extend you XPages knowledge but If you are a beginner I would still suggest viewing David Leedys Notesin9 JumpStart to XPages first (yes, I know this one is old but still good)

With the updated old content and the new this is really a gold mine and is an great additional resource to the ICS Community with videos and blog posts this really fills it place and the price is if you ask me a bargain for the amount of information you get. And if you use this code IBM3370 in the checkout on IBMPressBooks.Com you get a 35% discount, I also saw that you get the e-book for $10 extra during May 2014 so for a total of $58 you get the hardcopy and the ebook that you can use for search reference.

And to the Authors, great work. Looking for to the next one, because as I see it now we have Mastering XPages, XPages Extension library and the Portable Command Guide books. The missing one is

The Java Developers guide to XPages
with and without OpenNTF Java API

This could really be an interesting book, so who is interested to write it.

What happens in enemy camp: Microsoft Build 2014

Snap43

Microsoft developer conference Build was at Moscow center this week. Microsoft new CEO Satya Nadella talked about that Microsoft will be the developers best friend, well we will see about this. They also talked a lot about Internet of Things or to be exact Windows for Things. Windows in your car, your tv and all your other machines. It’s probably only is the multimedia system so we can be calm, no blue screen on the highway. If you want to know more this is the session to view 

Windows phone is free for phone manufactures to meet up the competition from Android and IOS. Microsoft also released version 8.1 with a brand new virtual assistant Cortana to compete with Siri and Google Now. It had alot more news see the Day one keynote to see them all.

Checkout the Day 1 Keynote here and Day 2 keynote here or this video about Cortana

The race against Mobile domination is not over yet and if you have counted out Microsoft you are probably wrong. This is the company that thought internet wasn’t anything for the future and a couple years later they has 90% of the web browser market and almost killed all competition. I’m not saying that they can do this again but moving up and getting 30% of the market is not unrealistic.

Snap44

A new native mobile development framework Xamarin was shown. It enables you write the mobile apps in c# and publish them for Windows Phone, IOS and Android. Interesting is that Xamarin enables you to build and test applications for all three platforms on Windows.

Xamarin can be found here

Microsoft also showed of a new element framework called WinJS that will get multi browser support. check it out try.buildwinjs.com

I don’t think that this is tools new but anyway, the development environment Visual Studio is available thru Microsoft Azure as an online service. There is a session about that  Getting Started with Visual Studio Online if you want to know more. 

This was some info on the things I’ve found about the Build dev conference, if you have some more info perhaps you where there, please add a comment.

Mastering XPages is here soon

The upcoming second edition of Mastering XPages is here soon with a release date of the 25:th of April.

Impressive 1200 pages of XPages information. Apart from all the old stuff the authors has added content about mobile, extension library, debugging (my favorite part) and performance.

I will write a follow up with a review as soon as I get my hands of a copy of the book.

Check out what the authors say about the new book

mastering xpages at xpagesdeveloper.com

You can preorder the book here

IBM Press add IBM3370 in the checkout and get 35% off 

Amazon.com

Domino and Heartbleed

A support flash has been sent out by IBM Support that Domino is not affected by the bug.

Link to IBM Support flash can be found here.

http://goo.gl/q9hMBx

But you might be affected anyway because yahoo.com, amazon.com flickr and many more sites are affected by the bug.

If you want to know more about hearthbleed check out links

Affected services

krebson security

heavy.com

Calling web services from XPages the missing part

I had an XPage project where I needed to call some web services to get some information and after reading on different blogs my hopes of getting this to work was almost null. But sometimes knowing your history helps and I remembered how I started to create subforms using dxl for several years ago and that almost everything is stored with in the design note.

So I started to think, does the built in web service consumer create the code inside the design element and yes it did. Great!

Check out my Notes in 9 video here

or continue to read the post

Is there any common things between between this and XPages, Yes. Java! But there is a problem they work in different jvm:s. But when I looked closer to a web services consumer with generated java code, there where 3 jar files attached to the design note. One with the source, one with the precompiled java code and one with the configuration settings.

Let’s export the java code and try, but there isn’t any way to export it. So I created a Lotusscript agent that will export the consumer code, it can be found at xsnippet.openntf.org or here

Import that code into an agent and place the agent inside your database with the created java web service consumer. Run the agent, enter a valid path for the export.

There is only one thing that you need to check when the consumer is created. The consumer java code must be in a package, if not the XPage code will not work or at least I haven’t found a way.

Now Import the two jar files created, in the XPage jar section, or if you are using 8.5.x add the jar files using the package explorer.

Next step: Create a java file that will use the web service code.

And call the code from the XPage.

No modifying java.policy, No special java command line things the only thing is that you must be able to create the java web service consumer and some web services doesn’t work but that I can live with.

This is of course nothing supported by IBM but I will try to convince IBM to build in the export/import action so my agent is unnecessary.

The sample database can be found here

The databases is using free webservices from http://www.restfulwebservices.net/ where I use the soap version instead for the rest service that is not working with the webservice consumer in Domino.

i.e. the stock quote WDSL file can be found at http://www.restfulwebservices.net/rest/StockQuoteService.svc?wsdl and to be able to use this with Domino I change the url to

http://www.restfulwebservices.net/wcf/StockQuoteService.svc?wsdl to get the soap version of the webservice.

If you have any questions feel free to send me a comment or use the contact link above