Get started - Revision history

Kristofferse at 08:50, 5 September 2019

2019-09-05T08:50:51Z

Carignani: /* Using the plug-ins */

2017-10-10T15:56:24Z

‎Using the plug-ins

Carignani: /* Installing the plug-ins */

2017-10-10T15:53:39Z

‎Installing the plug-ins

Carignani: /* Installing the plug-ins */

2017-10-10T15:34:13Z

‎Installing the plug-ins

Makedonski: /* Setting up a local environment for development and testing */

2017-10-10T15:17:35Z

‎Setting up a local environment for development and testing

Makedonski at 16:12, 9 October 2017

2017-10-09T16:12:56Z

Carignani at 07:58, 22 June 2017

2017-06-22T07:58:38Z

Carignani at 07:15, 22 June 2017

2017-06-22T07:15:20Z

Carignani: Created page with "== Setting up your Gerrit profile == In order to use Gerrit to contribute and review code you will need to add your credentials. Both SSH and HTTPS are supported, the latter..."

2017-06-22T07:13:40Z

Created page with "== Setting up your Gerrit profile == In order to use Gerrit to contribute and review code you will need to add your credentials. Both SSH and HTTPS are supported, the latter..."

New page

== Setting up your Gerrit profile ==

In order to use Gerrit to contribute and review code you will need to add your credentials.
Both SSH and HTTPS are supported, the latter is recommend for starters and its usage will be explained below.

# Navigate to Gerrit at [https://tdl.etsi.org/gerrit https://tdl.etsi.org/gerrit].
# Sign in (link in the top right corner) entering your EOL or TDL External credentials.
# Your user name will appear on the top right of the page. Click on it, the select Settings.
# In the menu on the left, select HTTP Password.
# Click on "Generate password" button.

Now Gerrit has a secure password for your HTTP access. When cloning a repository you will be asked to insert username and password:
use the password copied from the Gerrit settings, not your EOL password. Don't worry, you will need to insert that only once.

@@ Line 37: / Line 37: @@
 '''Note''':
-* You can find all the project repository URLs on '''[https://tdl.etsi.org/rep/ Gitweb]''' or on '''[https://tdl.etsi.org/gerrit/ Gerrit]'''
+* You can find all the project repository URLs on '''[https://tdl.etsi.org/gitweb/gitweb.cgi/ Gitweb]''' or on '''[https://tdl.etsi.org/gerrit/ Gerrit]'''
 ** On Gitweb
 **# Click on '''Gitweb''' menu on the portal menu bar.

← Older revision		Revision as of 15:56, 10 October 2017
Line 1:		Line 1:
	__TOC__		__TOC__
−
−	~~= Using the plug-ins =~~
−
−	* To create a new TDL model by means of the TDLan2 textual representation, right click on a project or a folder in the package explorer and select New -> File, type the filename ending with '''.tdlan2''' and the corresponding editor shall be automatically opened.
−	* To create a new TDL model by means of the TDPan2 textual representation for structured test objectives, right click on a project or a folder in the package explorer and select New -> File, type the filename ending with '''.tplan2''' and the corresponding editor shall be automatically opened.
−	* To translate a TDL model from the TDLan2 textual representation to the XF format (or the other way around), open the source model and press the "T" icon on the toolbar. The resulting model shall be stored in the same folder as the source model with the type of the model ('''.tdlan2''' or '''.tdl''') appended to the name of the source model.
−

	= Connecting to the repository =		= Connecting to the repository =

← Older revision		Revision as of 15:53, 10 October 2017
Line 1:		Line 1:
	__TOC__		__TOC__
−
−	~~= Installing the plug-ins =~~
−
−	The TDL tools are available as a set of Eclipse plug-ins. You need to first be able to run Eclipse. The [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/neon3 Eclipse Neon Modeling Tools] distribution contains most of the necessary prerequisites for the TDL tools. You will also need to install [https://www.eclipse.org/sirius/ Sirius] and [http://www.eclipse.org/Xtext Xtext] from the Eclipse Marketplace as the TDL tools depend on them.
−
−	~~Once Eclipse is up and running, you need to add the [http://tdl.etsi.org/eclipse/neon/ update site] for the TDL tooll:~~
−
−	~~http://tdl.etsi.org/eclipse/neon~~
−
−	~~To add the new repository to Eclipse, follow these steps:~~
−
−	~~# Open the menu item "Help" and select the item "Install new software"~~
−	~~# Click "Add..." button to add a new repository~~
−	~~# Insert the required information:~~
−	~~#* Name: TOP Plugins~~
−	~~#* Location: http://tdl.etsi.org/eclipse/neon~~
−	~~# Click Ok. In the window a new set of plugins called TDL should appear~~
−	~~# Click on the checkbox to select all the plugins, then click "Next".~~
−	~~# Now follow the instructions to complete the installation~~
−
−	~~After the installation Eclipse will need to be restarted.~~

	= Using the plug-ins =		= Using the plug-ins =

@@ Line 5: / Line 5: @@
 The TDL tools are available as a set of Eclipse plug-ins. You need to first be able to run Eclipse. The [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/neon3 Eclipse Neon Modeling Tools] distribution contains most of the necessary prerequisites for the TDL tools. You will also need to install [https://www.eclipse.org/sirius/ Sirius] and [http://www.eclipse.org/Xtext Xtext] from the Eclipse Marketplace as the TDL tools depend on them.
-Once Eclipse is up and running, you need to add the [http://build.tdl.etsi.org update site] for the TDL tools: [http://build.tdl.etsi.org http://build.tdl.etsi.org]
+Once Eclipse is up and running, you need to add the [http://tdl.etsi.org/eclipse/neon/ update site] for the TDL tooll:
-After the update site is added, the list of plug-ins and features shall be shown in the installation dialog (menu item Install New Software..). Select the desired features and proceed with the installation, which will require Eclipse to be restarted once the installation is finished.
+    http://tdl.etsi.org/eclipse/neon
 = Using the plug-ins =

@@ Line 65: / Line 65: @@
 = Setting up a local environment for development and testing =
 * Check out the repository
 * Import the plug-ins in the Eclipse workspace

@@ Line 1: / Line 1: @@
 __TOC__
-= Setting up your Gerrit profile =
+= Installing the plug-ins =
 In order to use Gerrit to contribute and review code you will need to add your credentials.
@@ Line 12: / Line 30: @@
 # Click on "Generate password" button.
-Now Gerrit has a secure password for your HTTP access. When cloning a repository you will be asked to insert username and password:
+Gerrit has a secure password for your HTTP access. When cloning a repository you will be asked to insert username and password:
 use the password copied from the Gerrit settings, not your EOL password. Don't worry, you will need to insert that only once.
-= Clone your project =
+== Clone your project ==
 This is a procedure that should work in most of the cases and is good for starters with Git and Gerrit. Experienced users can rely on their preferred cloning procedures.
@@ Line 25: / Line 43: @@
 # Copy the command shown in the page into the clipboard.
-== On Windows ==
+=== On Windows ===
 The following assumes you are working with [https://git-for-windows.github.io Git-for-windows] and [https://tortoisegit.org/ TortoiseGit].
@@ Line 44: / Line 62: @@
 **# Click on "List" menu.
 **# Select a project to see the available cloning URLs.

@@ Line 19: / Line 19: @@
 This is a procedure that should work in most of the cases and is good for starters with Git and Gerrit. Experienced users can rely on their preferred cloning procedures.
-# Navigate to the project general page ([https://forge.etsi.org/gerrit/#/admin/projects/ List of all the projects]), for example the [https://forge.etsi.org/gerrit/#/admin/projects/playground Playground project].
+# Navigate to the project general page ([https://tdl.etsi.org/gerrit/#/admin/projects/ List of all the projects]), for example the [https://tdl.etsi.org/gerrit/#/admin/projects/top-gerrit-test TOP test project].
 # Now select the options "Clone with commit hook" and "anonymous http" (we suggest anonymous since it seems the only way to make it work with Windows Credential helper).
-[[File:Forge-clone-options.PNG|frame|center|The options recommended to be selected]]
+# Copy the command shown in the page into the clipboard.
-# Copy the command shown in the page into the clipboard.
+The following assumes you are working with [https://git-for-windows.github.io Git-for-windows] and [https://tortoisegit.org/ TortoiseGit].
 # Open the folder on your PC where you want the files to be put.
 # Right click on the white space and select "Git Bash Here".
 # Paste the command that you copied from Gerrit and hit "Enter"
-# You will be asked to insert user name and password by the WIndows Credential Helper. Insert your EOL user name and '''the HTTP password you generated in the Gerrit Settings'''. Check the "Git Bash". If it says "Unauthorized": try again the command (hit the Up key and it will be shown), this time in the Windows Credential Helper click "Cancel", then a new window will pop up where you should put again the EOL user name and the HTTP password.
+# You will be asked to insert user name and password by the Windows Credential Helper. Insert your EOL user name and '''the HTTP password you generated in the Gerrit Settings'''. Check the "Git Bash". If it says "Unauthorized": try again the command (hit the Up key and it will be shown), this time in the Windows Credential Helper click "Cancel", then a new window will pop up where you should put again the EOL user name and the HTTP password.
 '''Note''':
-* You can find all the project repository URLs on '''[https://forge.etsi.org/rep/ Gitweb]''' or on '''[https://forge.etsi.org/gerrit/ Gerrit]'''
+* You can find all the project repository URLs on '''[https://tdl.etsi.org/rep/ Gitweb]''' or on '''[https://tdl.etsi.org/gerrit/ Gerrit]'''
 ** On Gitweb
 **# Click on '''Gitweb''' menu on the portal menu bar.
-**# Select a product to see the available cloning URLs
+**# Select a project to see the available cloning URLs
 ** On Gerrit
 **# Click on '''Gerrit''' menu on the portal menu bar.
 **# Click on "Projects" menu on the Gerrit menu bar.
 **# Click on "List" menu.
-**# Select a product to see the available cloning URLs.
+**# Select a project to see the available cloning URLs.