Instructions

Academic Subscriptions
Institute of Information Technology participates in several programs which offer software to students and staff either for a nominal fee or completely free of charge. Software is can be used for educational purposes, commercial application and production use is prohibited. Only currently enrolled Information Technology students and staff are eligible to download software, distribution to third parties is prohibited. Software is limited to one product key or activation at a time, other software-specific limitations may apply. Current programs include:

  • Microsoft Imagine Premium (formerly Dreamspark Premium), which provides most of the Microsoft software such as Windows, SQL Server and Visual Studio. Microsoft Office is not included in program.
  • VMware Academic Program, which provides one year trial licenses in VMware Virtualization software, such as VMware Workstation, vSphere Hypervisor and vCenter Server.

Software is available for download at JAMK IT ELMS Webstore, which is managed by Kivuto. By using the webstore and downloading software provided, you must agree to licenses involved in the programs. License and subscription agreements can be found in Microsoft Imagine Academy License Agreement and VMware Academic Program EULA. More information about each software is provided in the webstore.

Contact the LabraNet helpdesk

Note: If your matter is concerning any of the following:

  • Office 365
  • ASIO
  • Optima
  • Computers anywhere except in LabraNet classrooms

Then you want the JAMK helpdesk instead.

If not and you want to contact LabraNet administration, please fill out the following form.

External Access

Connections from LabraNet networks to Internet are generally restricted to standard TCP/UDP port numbers used by corresponding applications. This means that if you are running for example a web server somewhere on the Internet that listens to some non-standard HTTP port number (eg. 5000), the connection will be denied.

Instructions on how to solve this can be found on LabraNet_External_Access guide

MySQL

Our MySQL server is mysql.labranet.jamk.fi

Students can create their own mysql user by going to https://mysql.labranet.jamk.fi (only available from LabraNet workstations or over VPN), authenticating with their LabraNet login, and pushing a button. The page then tells you your new mysql password, and you can also reset your password from there if you’ve forgotten it.

If you want to change the password to one of your own liking, or to drop your database, you need to do it with mysql commands.

The mysql server on mysql.labranet.jamk.fi is accessible from student.labranet.jamk.fi, and from LabraNet workstations by using for example MySQL Workbench.

Print quota

LabraNet shared printers utilize a printing quota. Quota is personal and limited to 300 pages per academic year. on LabraNet workstations you can check the current quota from a tray application:
Print quota tray icon

public_html and PHP

Every LabraNet user has public_html folder under his/her home folder.

To publish websites, first you have to modify some rights of your homefolder.
[userid@student userid]$ chmod 701 /home/userid

This command gives only the execute permission to others.
[userid@student userid]$ chmod 705 /home/userid/public_html

With the above command you allow others to read and execute your public_html folder.
touch /home/userid/public_html/index.html

Now you should see an empty page @ http://student.labranet.jamk.fi/~userid

For PHP functionality check instructions in .htaccess -file under public_html. More information can be found in instructions-directory in your home folder.

Troubleshooting

500 Internal Server Error
1, Check that your scripts syntax is right. Run “php -l my_script.php” on command line.

2. Check that your public_html folder has correct permissions (see above).

3. Check that the SELinux context type is set to “httpd_user_content_t” for all files and folders under the public_html folder.

This can be done using the “ls -laZ” command:

$ ls -laZ ~/public_html/
drwx—–x. user Student-users unconfined_u:object_r:httpd_user_content_t:s0 .
drwx—–x. user Student-users unconfined_u:object_r:user_home_dir_t:s0 ..
drwxr-xr-x. user Student-users unconfined_u:object_r:httpd_user_content_t:s0 folder
-rw-r–r–. user Student-users unconfined_u:object_r:httpd_user_content_t:s0 file

Context can be set to correct type by running the following command:

chcon -R -v -t httpd_user_content_t ~/public_html/*

Remote home-folder

Your home-folder can be accessed from outside by using VPN connection. Accessing via SSH tunnel is not supported anymore. Connect to LabraNet by VPN and type the following (Windows).
win+r or Start – Run
The path to your LabraNet home folder is:
\\storage.labranet.jamk.fi\homes\userid
When you are asked for credentials, enter your username as userid@labranet.jamk.fi (for example, c5431@labranet.jamk.fi) and use your LabraNet account password.
You can also use Windows tools to permanently map your home-folder as a network drive. Please note that the mapped drive will be accessible only when the VPN connection is active.

It is also possible to mount your Student-server home folder with the following path, credentials are the same as above:
\\student.labranet.jamk.fi\userid

Note! Mac OS Sierra users might have issues connecting to Student-server via SMB and CIFS. As a workaround, LabraNet administration recommends using Fuse for macOS and SSHFS both available here.
These enable you to mount your Student-server home folder via SSH with the command:
sshfs -o option1,option2 userid@student.labranet.jamk.fi:/home/userid /mountpoint

Requesting Virtual Machines

LabraNet provides virtual machine hosting, such as development or production servers for different projects. Project servers can be used internally as a project environment, software development, etc. and can be used from local workstations or through LabraNet VPN. For customer-related projects we can offer external hosting with public internet access also, but as we have limited number of public IPv4 addresses, we can currently issue only a handful of publicly visible servers. There must be a real reason for public server use, if the virtual machine is to be used primarily by students and staff it will be internal server only.

When requesting a virtual server, please use our Helpdesk contact form to create a ticket, and fill the following information:

    • Name of the server (hostname.labranet.jamk.fi)
    • Required operating system

Primarily supported operating systems: CentOS 7, Ubuntu Server (16.04), Windows Server 2008R2, Windows 7. Other OS can be requested but a good reason must be provided.

    • Short description of usage and the course or project involved
    • A contact person who will receive the administrative account for the virtual machine (Will be the creator of the ticket if not provided)
    • How long will the server be in use (Exact date!)

We will contact people when the use date is exceeded about whether the vm is still needed or not. Long-term usage must be discussed with administration on case by case basis.

  • Will the server need to be used from the internet and why?

After the VM is created, the appointed administrative person will be responsible for updates and other security of the server. If a default password is provided, it must be immediately changed to more secure one. All LabraNet Usage Policy rules apply to virtual machines also. LabraNet administration reserve the right to access and manage the virtual machine if rules are broken and also in case of severe problems that may affect the security or functionality of other systems.

By default, access to vms will be restricted to most used protocols only (http, https). Management is handled by SSH or RDP and only from local network. Other protocols/applications can be requested when needed.

Services on Student server
What is student.labranet.jamk.fi server?
  • Server that is dedicated only for ICT-students.
  • Virtualized
    • 4GB of memory
    • Diskspace quota is set (500MB for every ICT-student)
  • Running Linux environment (CentOS 6) with LAMP (Linux, Apache, MySQL, PHP)
  • Administered by Labranet’s administrators

What it isn’t

  • No screen processes
  • No IRC-connections
  • No IRSSI, Bitch-x, etc
  • No IRC-bots (eg. eggdrop, energymech)
  • No illegal material (storing illegal material will cause you to loose your account, see policy)

What does student server offer for you?

  • Anything you can do in UNIX/Linux environment
  • gcc/cc/java
  • WWW-space
  • PHP
  • SSH/SFTP Connections
  • Crontab
  • ETC (basically anything you can do in UNIX/Linux environment, feel free to ask if you need something)

How you can access student.labranet.jamk.fi?

See the SSH to Student Server – instructions.

SSH to Student Server

For connecting to Student server you can use what ever SSH client, for example PuTTY.

First enter the address to Student server which is student.labranet.jamk.fi (see figure 1).

Figure 1. PuTTY startup screen

Figure 1. PuTTY startup screen

Then PuTTY asks login ID and password. Use your LabraNet account’s ID and password (see figure 2). Note that depending on the student, the letter in the user id may need to be small or capitalized.

Figure 2. PuTTY login screen

Figure 2. PuTTY login screen

After successful login you are in Student server (see figure 3).

Figure 3. PuTTY logged in to Student server

Figure 3. PuTTY logged in to Student server

SFTP connection to Student server

LabraNet users can use WinSCP SFTP client to remote access their LabraNet home folder. The WinSCP client can freely downloaded from http://winscp.net/

Download and install the client. Choose Start -> Programs -> WinSCP -> WinSCP

Once the program starts you need to enter the address to Student server which is student.labranet.jamk.fi.

After that you need to enter your LabraNet UserID and password. Port number is 22 (see figure 4).

WinSCP startup

Figure 4. WinSCP startup

Your local files are in the left window of the client and the remote files (your home folder on Student server) are in the right (see figure 5).

Figure 2. WinSCP connected to Studen server

Figure 5. WinSCP connected to Studen server

You can transfer files by dragging them from window to another.

Virtualized environments

Some courses and theses are done in virtualized environments, such as the VMware vSphere Hypervisor (ESXi). Laboratory virtualization guide includes some common help and guidelines for using such environments and working with them.

If you bring us virtual machines for use in labs or the vCloud Director environment, the images should be VMware vSphere 5.0 compatible (VM version 8) and in OVF/OVA format as plain VMX/VMDK images can be troublesome. If using software other than VMware to create the images, please remove USB/Audio devices and use SCSI disks instead of SATA/IDE. More information about format conversion in the guide above.

VPN to LabraNet

You can access your home folder and other resources from your home network with VPN. Instructions for connecting to the LabraNet VPN and mounting your home folder can be found in the LabraNet Remote Access Guide

If you encounter any problems with VPN connection here are few remedies to known problems:
– DNS problems are often solved by flushing the DNS cache (in windows the command is “ipconfig /flushdns”, in linux you need to restart nscd daemon with command “/etc/init.d/nscd restart”)
– Connectivity problems are caused by not receiving proper routes from VPN connection, DHCP clearance is often needed to get VPN routes. In windows commands are: “ipconfig /release” and after that “ipconfig /renew”. In linux “dhclient -r” will renew DHCP bindings.
– Check whether the VPN tunnel is in full or split mode (See Advanced Routing in the Guide). Sometimes full tunnel mode works better
– In newer Mac OS X, check the Service order in the Network settings page, and the scutil –dns command output. Wrong service order will make the system use your default DNS servers, and the system cannot resolve LabraNet names.
– If the Windows 10 app freezes and doesn’t show connection options you can complete or close the connection using the following command line commands:
– To make the connection: rasdial.exe “connection name” (add username and password if you haven’t saved them in connection options: rasdial.exe “connection name” “username” “password”)
– To close the connection: rasdial.exe “connection name” /disconnect