Using/logging-in: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
(Created blank page)
 
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE: Logging In}}{{TopicUsingSnakeoil|float:right;}}In rare instances you may need to use remote access to configure some software players (e.g. XMMS), or when want to play around with the Linux system. This chapter describes the three approaches you can use to access your Snakeoil machine.


==Remote Access: VNC==
The VNC server is only started when you are using a graphical player. Any player with the following icon will start a VNC session.
[[File:Music Player - VNC Remote Session.png|center]]
VNC stands for Virtual Networking Computer. The VNC server application creates a virtual desktop on a computer. A VNC client running on a second computer can remotely connect to this virtual desktop and controlled. A VNC client is available for every platform: [https://www.realvnc.com/download/viewer/ Apple, Windows and Linux]), [https://www.realvnc.com/products/android/ Android], [https://www.realvnc.com/products/ios/ iOS], and even [https://www.realvnc.com/products/chrome/ Google Chrome].
In our example, we will describe logging in from a Windows machine. Other platforms will have a similar interface. You will be prompted for a server address upon starting the VNC client. The entry format for this is the server address, followed by :1 (colon one). The server we are trying to connect to is ''largos'', therefore we enter ''largos:1'' in the text box.
[[File:Vnc-1.png|center|thumb|384x384px|Logging in remotely via VNC]]
Hit the "''OK''" button and you will be challenged to enter a password. Enter "''Password1''".
[[File:Vnc-passwd.png|center|thumb|361x361px|Entering the default VNC password: Password1]]
Once you are authenticated you will get access to the remote X server, and whatever GUI software you selected. During the LiveCD you will see the Ubiquity installer wizard. Once Snakeoil is installed, the GUI player you chose will show up instead, e.g. XMMS.
[[File:Vnc-xmms.png|center|thumb|981x981px|VNC Showing XMMS]]
You can now remotely control your Snakeoil machine from another computer now. And control the XMMS GUI like it's on your current computer. Accessing via this method is very limited as typically the VNC session will be started by a account that can't do much.
You will need to use Secure Shell (SSH) for general command line access.
==Remote Access: SSH==
Use [[wikipedia:Secure_Shell|secure shell]] when you need full remote access to your computer. A good freeware ssh client for Windows PC is [http://www.chiark.greenend.org.uk/~sgtatham/putty/ putty]. Android users can download and use the great [https://play.google.com/store/apps/details?id=com.sonelli.juicessh&hl=en JuiceSSH] app.
This example shows you how to connect to your Snakeoil machine via putty, all other SSH clients will behave similarly. First step to do is to enter your machine name (or IP) in the address box, the following example attempts to connect to example.com.Substitute that with your machine name. Leave port number 22 alone as that's the port you'd connect to.[[File:SSH.png|center|thumb|449x449px|Putty SSH client]]
Once connected, you'd be prompted to login. Type in the user name you created during installation.
[[File:Ssh-login.png|center|thumb|482x482px|SSH: User Login]]
Once you entered your login account, Snakeoil will challenge you to enter your password.
[[File:Ssh-passwd.png|center|thumb|526x526px|SSH: Entering the authentication password]]
Do that and you're in!
[[File:Ssh-logged-in.png|center|thumb|800x800px|SSH: Logged in]]
This user account is a special account as you can escalate it to root (the administration account with full access to everything.
To escalate to root, type in these commands "''sudo su''" and enter the password for your user account.
'''Registered users have the option to disable SSH access to conserve memory. If you want to use SSH again, please enable it in the snakeoil tab, and reboot the machine.'''
==Direct Access: Terminal==
Also know as the local console (also called terminals, or tty), you'd need to connect a monitor and keyboard to your machine to use this. Enter the user you created during installation, and the password to login.By default Ubuntu gives your 6 terminals, but Snakeoil only enabled one terminal- tty1.
{{abox|Registered users have the option to disable TTY access to conserve memory. If you want to use local login again, please enable it in the snakeoil tab, and reboot the machine.}}
==Forget Your Password==
If you have already forgotten your login account or password, you can reset it from the System page.
[[File:System - password reset.png|center|thumb|564x564px|System - password reset]]
==With Power Comes Responsibility==
With root access you now have the power to do make changes to your computer, including making it non-bootable, perhaps even damaging your computer (e.g. overheating).  If the damage is done in software, simply whip out your LiveCD and reinstall again. If it's hardware, just buy a new component.
Life is too short, experiment!{{ManualNavigation
|[[Using|Using Snakeoil]]
|
|[[Using/software-players|Software Players]]
}}
[[Category:Using Snakeoil]]

Latest revision as of 11:56, 1 May 2021

In rare instances you may need to use remote access to configure some software players (e.g. XMMS), or when want to play around with the Linux system. This chapter describes the three approaches you can use to access your Snakeoil machine.

Remote Access: VNC

The VNC server is only started when you are using a graphical player. Any player with the following icon will start a VNC session.

Music Player - VNC Remote Session.png

VNC stands for Virtual Networking Computer. The VNC server application creates a virtual desktop on a computer. A VNC client running on a second computer can remotely connect to this virtual desktop and controlled. A VNC client is available for every platform: Apple, Windows and Linux), Android, iOS, and even Google Chrome.

In our example, we will describe logging in from a Windows machine. Other platforms will have a similar interface. You will be prompted for a server address upon starting the VNC client. The entry format for this is the server address, followed by :1 (colon one). The server we are trying to connect to is largos, therefore we enter largos:1 in the text box.

Logging in remotely via VNC

Hit the "OK" button and you will be challenged to enter a password. Enter "Password1".

Entering the default VNC password: Password1

Once you are authenticated you will get access to the remote X server, and whatever GUI software you selected. During the LiveCD you will see the Ubiquity installer wizard. Once Snakeoil is installed, the GUI player you chose will show up instead, e.g. XMMS.

VNC Showing XMMS

You can now remotely control your Snakeoil machine from another computer now. And control the XMMS GUI like it's on your current computer. Accessing via this method is very limited as typically the VNC session will be started by a account that can't do much.

You will need to use Secure Shell (SSH) for general command line access.

Remote Access: SSH

Use secure shell when you need full remote access to your computer. A good freeware ssh client for Windows PC is putty. Android users can download and use the great JuiceSSH app.

This example shows you how to connect to your Snakeoil machine via putty, all other SSH clients will behave similarly. First step to do is to enter your machine name (or IP) in the address box, the following example attempts to connect to example.com.Substitute that with your machine name. Leave port number 22 alone as that's the port you'd connect to.

Putty SSH client

Once connected, you'd be prompted to login. Type in the user name you created during installation.

SSH: User Login

Once you entered your login account, Snakeoil will challenge you to enter your password.

SSH: Entering the authentication password

Do that and you're in!

SSH: Logged in

This user account is a special account as you can escalate it to root (the administration account with full access to everything.

To escalate to root, type in these commands "sudo su" and enter the password for your user account.

Registered users have the option to disable SSH access to conserve memory. If you want to use SSH again, please enable it in the snakeoil tab, and reboot the machine.

Direct Access: Terminal

Also know as the local console (also called terminals, or tty), you'd need to connect a monitor and keyboard to your machine to use this. Enter the user you created during installation, and the password to login.By default Ubuntu gives your 6 terminals, but Snakeoil only enabled one terminal- tty1.

!icon.png Registered users have the option to disable TTY access to conserve memory. If you want to use local login again, please enable it in the snakeoil tab, and reboot the machine.


Forget Your Password

If you have already forgotten your login account or password, you can reset it from the System page.

System - password reset

With Power Comes Responsibility

With root access you now have the power to do make changes to your computer, including making it non-bootable, perhaps even damaging your computer (e.g. overheating).  If the damage is done in software, simply whip out your LiveCD and reinstall again. If it's hardware, just buy a new component.

Life is too short, experiment!

 Main   Using Snakeoil    Software Players