Jump to: navigation, search

Hudson-ci/features/Initial Setup

< Hudson-ci‎ | features
Revision as of 01:17, 27 May 2012 by Winston.prakash.gmail.com (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

Init-setup-proxy-success.png

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


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 starts with out any dialog


Init-setup-login.png


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.