View source for Hudson-ci/features/Initial Setup

After Hudson is installed and started, a one time Initial Setup Page is offered to install Mandatory plugins and Recommended Plugins. 

[[Image:Init-setup.png]]<br> 

'''Mandatory Plugins''' 

Mandatory plugins are required for Hudson to work properly.&nbsp; These plugins are listed under the sections Manadtory Plugins. These plugins are required, so they can not be deselected. 



'''Recommended Plugins''' 

Recommended plugins are not required for Hudson Pltform to work properly. However, they are widely used plugins and are certified by Hudson QA team. They are available under the "Recommended Plugins" section. All the plugins are selected by default. User has the option to deselect any of the plugins 



'''Already installed Plugin''' 

If the plugin is already installed, then the plugin information is grayed out and the installed version is displayed 

[[Image:Init-setup-installed.png]] 


'''Installation and&nbsp; message''' 

User has the option to deselect one or more recommended plugins and then only click the "install" button to install only those plugins along with the mandatory plugin if not installed already. This button exists mainly to give option to the user to install recommended plugins in more batches. 

If the user clicks the "Finish" button then what everrecommended plugins selected they will be installed along with any mandatory plugins and Hudson is automatically started.<br> 

If any recommended plugins need to be installed then the following mesage is displayed.<br> 

[[Image:Init-setp-mandatory-msg.png]]<br> 

else the following message is displayed<br> 

[[Image:Init-setup-recommended-msg.png]]<br> 



'''Installation progress'''<br> 

The installation is done in the background. So when the installation is in progress a progress animation is shown as in the picture below. Once the installation is successfull a green check box is displayed as shown below. If the installation is a failure then a red icon is shown<br> 

[[Image:Init-setup-progress.png]]<br> 

<br> 

'''Proxy Setup'''<br> 

If the Hudson server could not connect to the internet, then a proxy server setup form is displayed if the Hudson installation is behind a firewall as shown in the picture below. <br> 

'''''Note:'''''<i>This form is only displayed if Hudson server could not connect to the internet</i>. ''If the proxy is setup in the earlier session it will be automatically used''.<br> 

[[Image:Init-setup-proxy.png]]<br> 

After entering the proxy info, user need to click on the "Test and Setup" button to see if the settings are correct. If the settings are correct, the page displays the following message<br> 

[[Image:Init-setup-proxy-success.png]]<br> 

'''''Note:'''''<i>The internet connection test is done in the background. So it may appear nothing happend for few seconds. TODO: provide some kind of prgress indication.</i>



'''Authentication to install '''<br> 

If Hudson security is already setup, then Admin privilege is needed to install. In that case a login dialog automatically pops up to provide admin credentials.<br> 

'''''Note'''''<i>: This dialog pops up only if Hudson Security is already set. Otherwise, installation progress starts with out any dialog</i><br> 



[[Image:Init-setup-login.png]]<br> 



'''Hudson Start after Initial Setup''' 

Once all the mandatory plugins and the recommended plugins are installed and if the user has pressed finish, the Initial Setup page should start the Hudson Server normally. 

'''''Note:'''''<i>The Initial Setup page creates a file called '''InitialSetup.xml''' in the hudson home folder. This file indicates the Initial Setup was successfully done and Hudson does not offer the Initial Setup page again.</i>