2. Automated Installation

Doubleclick setup.exe to launch the installation wizard and follow the instructions. You can safely ignore eventual signature warnings, if you obtained the installation disc in a trustworthy way.

Figure 2.1. Automated Installation

Automated Installation

2.1. License Agreement

Read and accept the License Terms

Figure 2.2. License Terms

License Terms

2.2. Choose Directories

Choose an installation directory. This Directory will contain an IDE configured and ready to be used to develop for Gentics Portal.Node.

Figure 2.3. Choose Installation Directory

Choose Installation Directory

Now choose an Eclipse workspace directory, which will contain your Gentics Portal.Node SDK project files.

Figure 2.4. Choose Workspace Directory

Choose Workspace Directory

2.3. Verify Installation Options

Figure 2.5. Verify Installation Options

Verify Installation Options

2.4. Watch Installation

This step may take several minutes to complete.

Figure 2.6. Installation Progress

Installation Progress

2.5. Start Gentics Portal.Node SDK

To verify if your installation was successful you can now start the Gentics Portal.Node SDK and launch the provided HelloWorld Portal:

Figure 2.7. Finished Installation

Finished Installation

After Pressing Done on the last setup screen your Eclipse installation will launch using a default Java perspective.

A few seconds after the first launch you should see the following dialog where you can enter your license key:

[Note]Note

This dialog is part of the update process. After you have entered the license key it will check for new updates. Please note also that you have to configure your proxy server manually via Window -> Preferences -> General -> Network Connections in case you are using a proxy server for your internet connection. After you configured your proxy server you can activate your SDK installation by using the proxy server connection. Please select Help -> Gentics Portal.Node SDK -> Activate Installation.

Now you can start Tomcat to see the SDK-Portal in action by clicking the Servers-Button located in the bottom tab-list:

Figure 2.8. Launching Tomcat

Launching Tomcat

After you have to select the desired server instance and click on the green button in the left corner of the tab list or right click on the server instance and select Start

Figure 2.9. Launching Tomcat

Launching Tomcat

Watch the Eclipse console, to see Gentics Portal.Node starting. If your Firewall notifies you of outgoing connections by Java(TM) 2 Platform Standard Edition binary, you can safely allow the connection. The sun java virtual machine as well as Gentics Portal.Node SDK will try to find updates online.

Figure 2.10. Tomcat Launched Successfully

Tomcat Launched Successfully

Now point your browser to http://localhost:42880/Portal.Node/ to see your SDK-Portal.

Figure 2.11. SDK Portal

SDK Portal
[Note]Note

If you have already entered your valid license key after starting eclipse, you will be automatically redirected to the 'Successful Activation' Page.

Otherwise you will have to enter your license key to activate Gentics Portal.Node

2.6. Unattended (Silent) Installation

The Gentics Portal.Node SDK installer (on all platforms) supports unattended installation by providing a XML file with instructions.

You can use the following example XML to tweak for your needs. The example given is for a windows installation - save it as unattended.xml and start the installer using:

setup.exe [unattended.xml]

On other platforms you can use

java -jar [Gentics Portal.Node SDK - installer.jar] [unattended.xml]

<AutomatedInstallation langpack="eng">
	<com.izforge.izpack.panels.HTMLInfoPanel/>
	<com.izforge.izpack.panels.TargetPanel>
	<installpath>C:\Program Files\Gentics Portal.Node SDK</installpath>
	</com.izforge.izpack.panels.TargetPanel>
	<com.izforge.izpack.panels.ShortcutPanel>
	<programGroup name="Gentics Portal.Node SDK"/>
	<shortcut mimetype="" createForAll="false" encoding="" type="2" url="" group="false" usertype="0" terminalOptions="" commandLine="" workingDirectory="C:\Program Files\Gentics Portal.Node SDK\eclipse" categories="Application;Development" KdeSubstUID="false" description="This starts the Gentics Portal.Node SDK" initialState="1" iconIndex="0" icon="" tryexec="" terminal="" target="C:\Program Files\Gentics Portal.Node SDK\eclipse\Gentics Portal.Node SDK.exe" name="Gentics Portal.Node SDK"/>
	<shortcut mimetype="" createForAll="false" encoding="" type="1" url="" group="true" usertype="0" terminalOptions="" commandLine="" workingDirectory="C:\Program Files\Gentics Portal.Node SDK\eclipse" categories="Application;Development" KdeSubstUID="false" description="This starts the Gentics Portal.Node SDK" initialState="1" iconIndex="0" icon="" tryexec="" terminal="" target="C:\Program Files\Gentics Portal.Node SDK\eclipse\Gentics Portal.Node SDK.exe" name="Gentics Portal.Node SDK"/>
	</com.izforge.izpack.panels.ShortcutPanel>
	<com.izforge.izpack.panels.SummaryPanel/>
	<com.izforge.izpack.panels.InstallPanel/>
	<com.izforge.izpack.panels.FinishPanel/>
</AutomatedInstallation>