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.
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.
Now let's access server for the first time to configure it. Access: https://localhost:9443/jts/setup and login with username ADMIN and password ADMIN.
The first screen will be shown as follow. Click "Next"
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"
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
In database configuration, we can leave the default options
Finalize application setup.
After that, choose "Administer the Server"
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 .
Choose the "Manage server" option via "Jazz Team Server - Server Administration", then navigate to option License Key Management
In the Client Access License Types box click "Add". In file dialog that appears click on "Choose File" (or "Browser" depending on your OS and browser)
Find and select the file "RTC_Developer-10-C.jar" (which was unzipped from licenses archive as mentioned in the first part of this article)
The jazz will recognize the file, then just click "Next."
Do not forget to edit the user you created and assign to him one of these 10 licenses free.
Finally! Our server is fully functional. I advise you to create users, project areas, workitems, browse through the server options ... In other words, become familiar with Jazz Team Concert.
After I finished this tutorial, I found an official Jazz Team video (http://jazz.net/library/video/552) about the same subject. Check it also:
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.