This is the second part of the article "Preparing the Environment for Extending RTC", you can access the first part here. In this post we will deal with the initial configuration of the RTC local server to make it running and ready to be prepared for development.

Preparing the Environment for Extending RTC (2/3) - Initial Settings

Important: This tutorial was produced using the windows version of the RTC, some screenshots may not match for other operating systems. A few aspects will be different, for example, the extension of some files "*. bat", "*. sh", "*. exe".

Once installed, we need to make the initial settings on the server local RTC to make it run properly. First, let's start the server. Go to the folder where the Jazz server was installed and run "server.startup.bat" (or "server.startup.sh", see note above)

The first time may take up to several minutes to start the server. When the message "INFO: Server startup in seconds *****" appears, it means the server is up.

Here we set the public URI for our server. This part requires some additional steps, as shown below, the Jazz do not kindly accept us to leave "localhost" as our Public URI.

There are MANY ways to solve this, I chose a really simple one: Create an entry in the hosts file resolving any given name (I chose "rtclocaljazz.com") to our local ip. In windows the file to be edited is "windows\system32\drivers\etc\hosts", in Linux is "/etc/hosts". Below is the windows screenshot

Then the jazz server will let us set up our public URI without restrictions. So fill the field with the value: https://rtclocaljazz.com:9443/jts

For the next steps, we can leave the default settings.

Database configuration, if you have some SQL Server, Oracle or DB2 that prefer to use, you can configure it here.

E-mail notifications. For now we'll leave it disabled.

Setup user registry. Here we can also leave the default option for the Jazz use tomcat's database.

For security reasons, Jazz recommends to you disable the ADMIN user, since it is a standard user. So you must create your user and check "Disable default ADMIN access" option.

For now do not choose any license. Later we'll add the free developers licenses.

Now let's set and register the Jazz application named "Change and Configuration Management." Click "Register Applications"

If all goes well, you see the following message.

The application public URI will be the same as the jazz server, only changing "jts" (Jazz team server) to "ccm" (change and configuration management). In this case: https://rtclocaljazz.com:9443/ccm

Ok, it's almost done. Now we need to install the licenses on the server, remember that in our case we'll use the 10 free licenses that IBM provides to RTC Express Edition. Access server administration: https://rtclocaljazz.com:9443/jts/admin .

Next post will be about the necessary changes to configure the development environment. Probably the third part will be a video lesson, if I can solve minor problems with sound on my workstation. This third party should only be published in early January, so Happy New Year everyone!

Leave your comments, critics, suggestions. Your feedback is very important to make me improve the material. Despite the fact that I'm relatively "old" in development world, I am entirely new in this area of articles, blogs and video lessons.

Some spelling errors may occur. If you find any misspelled words, let me know.