• Windows OS

  • Download MobaXterm from here and extract the content. No installation is needed. Netcat is available if you click on "Start local terminal".

• Linux OS

  • Netcat should already be installed on your system.

• Download IntelliJ IDEA from here and install it using default options.

• Download Git from here and install it using default options

Note that, for instance, in Ubuntu systems you could download and install it by simply executing the following:

    sudo apt-get install git

• Basic configuration
  • In Windows OS, the following commands should be executed inside git-bash ($GIT_HOME/git-bash.exe):

    git config --global user.email "<user-login>@udc.es"
    git config --global user.name "<user-name>"

The following line illustrates how to set Sublime as the Git default editor, but you can use any other editor installed in your OS (you can download Sublime Text editor from here)

    >Windows OS
	git config --global core.editor "'C:\Program Files\Sublime Text 3\sublime_text.exe' -w"
	
    >Linux OS
	git config --global core.editor "subl -w"

• From the git-bash interpreter in Windows OS systems

Generate SSH keys in the default path ($HOME/.ssh) and with default names

    ssh-keygen -t rsa -b 4096 -C "<user-login>@udc.es"

• Open the browser and navigate to https://github.com/settings/keys

• In the "Key" field, copy the public key, i.e., content of file $HOME/.ssh/id_rsa.pub

• In the "Title" field, specify a name for the key

• Click on the "Add key" button

• Try SSH connectivity against the Git server and add it to the list of known hosts

  Answer "yes" to the question "Are you sure you want to continue connecting (yes/no)?"

    ssh -T [email protected]

• Open the browser, navigate to https://github.com/ and log in.

• Complete the Moodle task called "Github repository".

• Click on the assignment URL available (https://classroom.github.com/...) after having completed the Moodle task.

  • Accept java-labs assignment.
  • Refresh browser after some seconds.
  • Click on your repository link.

	git clone [email protected]:GEI-Red-614G010172122/java-labs-<user-login>.git

NOTE that <user-login> must be changed by your user login.

• These are the basic commands to use when a change has been made in your project. Although "git status" is not mandatory, it can be very useful. The same happens with "git log".

	cd java-labs-<user-login>
	git status
	git add . 
	git commit -m "commit message"	
	git push origin main
	git log

• In order to create a tag, previous commands must be followed by these ones. NOTE that it is important to add -a option to create an annotated tag (otherwise a lightweight tag will be created).

	git tag -a <tag-name> -m "tag message"	
	git push origin <tag-name>

• If necessary, in order to delete a tag, these commands delete the tag locally and remotely, respectively:

	git tag -d <tag-name> 
	git push --delete origin <tag-name>

• Click on "File" > "New" > "Project from Existing Sources" menu option.
• Select "java-labs-<user-login>" folder as the folder to import.
• Click on "Ok" button.
• Choose "Create project from existing sources" and click on "Next" button.
• Set "java-labs-<user-login>" as "Project Name". The default values are correct for the remaining fields. NOTE that IntelliJ IDEA project should be created within java-labs-<user-login> (do not change the default value for the project location). This way a .iml file, an out/ folder (with .class files) and a .idea folder (with IntelliJ configuration) will appear within java-labs-<user-login>.
• Mark src folder and click on "Next" button.
• Click on "Next" button until "Finish" button will appear, and click on "Finish" button.

• Do not remove the .gitignore file from your repository.
• Do not modify the .gitignore file. Its content should be:

# Target directories.
target/

# Eclipse configuration.
.classpath
.project
.settings/

# IntelliJ IDEA configuration.
.idea/
/out/
*.iml

# Netbeans configuration.
/nbproject/private/
/dist/
/build/

• The java-labs-<user-login>/.idea/.gitignore is not going to be versioned, so it does not matter if it exists or not in your local repositories.

• Do not remove the .gitattributes file from your repository.
• Do not modify the .gitignore file. Its content should be:

.gitattributes export-ignore
.gitignore export-ignore

• The .gitattributes file is required to successfully generate the delivery zip file.