Jump to: navigation, search

Difference between revisions of "Hudson-ci/features/Initial Setup"

m
m
Line 1: Line 1:
 
After Hudson is installed and started, a one time Initial Setup Page is offered to install Mandatory plugins and Recommended Plugins.  
 
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>
+
[[Image:Init-setup.png]]<br>  
  
===== Mandatory Plugins =====
+
'''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.
+
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'''
  
 
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  
 
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 =====
+
'''Already installed Plugin'''
  
If the plugin is already installed, then the plugin information is grayed out and the installed version is displayed
+
If the plugin is already installed, then the plugin information is grayed out and the installed version is displayed  
  
[[Image:Init-setup-installed.png]]
+
[[Image:Init-setup-installed.png]]  
  
===== Installation and&nbsp; message =====
+
'''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.
+
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 ever
+
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 option, 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>
 +
 
 +
'''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 with out any dialog</i><br>
 +
 
 +
<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>

Revision as of 01:09, 27 May 2012

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

Init-setup.png

Mandatory Plugins

Mandatory plugins are required for Hudson to work properly.  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

Init-setup-installed.png

Installation and  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.

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

Init-setp-mandatory-msg.png

else the following message is displayed

Init-setup-recommended-msg.png

Installation progress

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

Init-setup-progress.png


Proxy Setup

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.

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

Init-setup-proxy.png

After entering the option, 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

Init-setup-proxy-success.png

Authentication to install

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.

Note: This dialog pops up only if Hudson Security is already set. Otherwise, installation progress with out any dialog


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: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.