Difference between revisions of "Management Console"

From PrgmrWiki
m (Reverted edits by Will (talk) to last revision by Paul)
Line 3: Line 3:
 
__FORCETOC__
 
__FORCETOC__
  
= New Console (<user>@console-customer1.prgmr.com) =
+
= Logging in from an OpenSSH Client (Linux, Windows Cygwin) or Terminal (OS X) =  
 
+
To login to the console, use the command
= Legacy Console (<user>@<user>.console.xen.prgmr.com) =
 
 
 
== Logging in from an OpenSSH Client (Linux, Windows Cygwin) or Terminal (OS X) ==
 
To login to the new console (if your instance was created after August 21, 2016), use the command
 
<pre>
 
ssh -i <path to secret key> <user>@console-customer1.prgmr.com
 
 
 
To login to the legacy console, use the command
 
 
<pre>
 
<pre>
ssh -i <path to secret key> <user>@<user>.console.xen.prgmr.com
+
ssh -i <secret key> <user>@<user>.console.xen.prgmr.com
 
</pre>
 
</pre>
  
Line 25: Line 17:
 
Starting from initial defaults the PuTTY Configuration settings are as follows:
 
Starting from initial defaults the PuTTY Configuration settings are as follows:
 
<ul>
 
<ul>
<li> For instances created before August 21, 2016, "Session:Host Name" needs to be <vpsname>.console.xen.prgmr.com, example "icecream.console.xen.prgmr.com" for a VPS named "icecream"</li>
+
<li> "Session:Host Name" needs to be <vpsname>.console.xen.prgmr.com, example "icecream.console.xen.prgmr.com" for a VPS named "icecream"</li>
<li> For instances created after August 21, 2016, "Session: Host Name" needs to be console-customer1.prgmr.com </li>
 
 
<li> "Session:Connection type" needs to be SSH</li>
 
<li> "Session:Connection type" needs to be SSH</li>
 
<li> "Connection/Data: Auto-login username" needs to be <vpsname>, example "icecream" for a VPS named "icecream"</li>
 
<li> "Connection/Data: Auto-login username" needs to be <vpsname>, example "icecream" for a VPS named "icecream"</li>
<li> "Connection/SSH/Auth:Private key file for authentication" needs to point to the .ppk file associated with the public key used</li>
+
<li> "Connection/SSH/Auth:Private key file for authentication" needs to point to the .ppk file associated with the public key used.</li>
 
</ul>
 
</ul>
 
Under "Session:Saved Sessions", name this session "Management for <vpsname>.xen.prgmr.com" and save. Click open to connect to the management console.<br>
 
Under "Session:Saved Sessions", name this session "Management for <vpsname>.xen.prgmr.com" and save. Click open to connect to the management console.<br>
Line 60: Line 51:
 
</pre>
 
</pre>
  
 
+
<b>Option 1</b> can be used to access the serial console when the domain is running. Like other serial consoles, often you see nothing until you use ctrl-c or hit return, at which point you should see the normal login prompt
The <b>out of band console</b> can be used to access the serial console when the domain is running. Like other serial consoles, often you see nothing until you use ctrl-c or hit return, at which point you should see the normal login prompt
 
  
 
<pre>
 
<pre>
Line 72: Line 62:
 
To exit the console once at the login screen shown above in most terminals, the escape sequence is ctrl+].
 
To exit the console once at the login screen shown above in most terminals, the escape sequence is ctrl+].
  
<b>Create/start</b> should be used when the domain is not running. Before printing the menu the script runs the xen command showing the status of the domain. Example output from when the domain is not running:
+
<b>Option 2</b> should be used when the domain is not running. Before printing the menu the script runs the xen command showing the status of the domain. Example output from when the domain is not running:
 
<pre>
 
<pre>
 
Domain cnryfield is not running.
 
Domain cnryfield is not running.
 
</pre>
 
</pre>
  
<b>Shutdown</b> is used to nicely shut down the domain, like hitting the power button of a physical machine briefly.
+
<b>Option 3</b> is used to nicely shut down the domain, like hitting the power button of a physical machine briefly.
  
<b>Force poweroff</b> is used to force the domain to shut down, like holding down the power button of a physical machine for several seconds.
+
<b>Option 4</b> is used to force the domain to shut down, like holding down the power button of a physical machine for several seconds.
  
<b>Reboot</b> requests the domain to reboot.  Note that if your IPs have changed since the last time you started the machine, you will need to do a shutdown (3) or destroy (4) instead of just a reboot.
+
<b>Option 5</b> requests the domain to reboot.  Note that if your IPs have changed since the last time you started the machine, you will need to do a shutdown (3) or destroy (4) instead of just a reboot.
  
<b>Swap i386/amd64 bootloaders</b> should be used if you are reinstalling your OS with a different architecture; almost all operating systems come in 32 bit (i386) and 64 bit (amd64) flavors.
+
<b>Option 6</b> should be used if you are reinstalling your OS with a different architecture; almost all operating systems come in 32 bit (i386) and 64 bit (amd64) flavors.
  
<b>View/add/remove ssh authorized_keys</b> should be used if you wish to add or remove ssh keys authorized to access this menu.  It will not change the keys on your domain as we have a policy of not modifying user disk images.
+
<b>Option 7</b> should be used if you wish to add or remove ssh keys authorized to access this menu.  It will not change the keys on your domain as we have a policy of not modifying user disk images.
  
<b>Set reverse dns</b> allows you to modify reverse DNS, IE the dns name that comes back when you type 'host <myip>' .
+
<b>Option 8</b> allows you to modify reverse DNS, IE the dns name that comes back when you type 'host <myip>' .
  
<b>Swap pvgrub/grub2 bootloaders</b> allows switching between legacy grub (pv-grub) and grub2.  
+
<b>Option 9</b> allows switching between legacy grub (pv-grub) and grub2.  
  
<b>Exit</b> will end the ssh session.
+
<b>Option 0</b> will end the ssh session.
 
 
 
 
The new console has two additional options:
 
 
 
<b>Install new OS image</b> which offers a menu that looks like this:
 
 
 
<pre>Installation will reset your system to boot from disk.
 
 
 
Options:
 
1. Ubuntu Trusty 14.04 - 64 bit
 
2. Ubuntu Trusty 14.04 Docker - 64 bit
 
3. Ubuntu Xenial 16.04 - 64 bit
 
4. Ubuntu Xenial 16.04 Docker - 64 bit
 
5. Debian Wheezy - 64 bit
 
6. Debian Jessie - 64 bit
 
7. Centos 6 - 64 bit
 
8. Centos 7 - 64 bit
 
9. Centos 7 Docker - 64 bit
 
a. Fedora 23 - 64 bit
 
b. Fedora 24 - 64 bit</pre>
 
 
 
<b>System details,</b> whose output looks something like
 
 
 
<pre>Command result:
 
        Virtualization mode: HVM
 
        Memory: 640 MiB
 
        VCPUs: 1
 
        Total disk: 15 GiB
 
        IPs: 71.19.146.8 2605:2700:0:3:a800:ff:fe24:a3a0
 
        Last installed OS: Centos 7 - 64 bit
 
        Boot option: Disk
 
</pre>
 
  
 
{{c|for Users}}
 
{{c|for Users}}
 
{{c|Getting Started}}
 
{{c|Getting Started}}
 
{{c|Prgmr}}
 
{{c|Prgmr}}

Revision as of 21:21, 2 September 2016

When you sign up, you give us an OpenSSH format public key. This key gives you access to simple text-based menu that lets you turn your domain on, off, and allows you to connect to the serial console. If you need help on how to make a key, please refer to Making an ssh key.


Logging in from an OpenSSH Client (Linux, Windows Cygwin) or Terminal (OS X)

To login to the console, use the command

ssh -i <secret key> <user>@<user>.console.xen.prgmr.com

If this is your first time logging in, use the server public key list to verify the server fingerprint based on IP address.

Logging in via PuTTY Client (Windows only)

If you are unable to connect, please verify your version of PuTTY is up to date (0.64 or newer). You want to be using 0.64 or newer anyway since private keys were not completely wiped from memory before 0.64.

Starting from initial defaults the PuTTY Configuration settings are as follows:

  • "Session:Host Name" needs to be <vpsname>.console.xen.prgmr.com, example "icecream.console.xen.prgmr.com" for a VPS named "icecream"
  • "Session:Connection type" needs to be SSH
  • "Connection/Data: Auto-login username" needs to be <vpsname>, example "icecream" for a VPS named "icecream"
  • "Connection/SSH/Auth:Private key file for authentication" needs to point to the .ppk file associated with the public key used.

Under "Session:Saved Sessions", name this session "Management for <vpsname>.xen.prgmr.com" and save. Click open to connect to the management console.
You may use this registry file as a starting point, however PLEASE open it with a text editor and review it before importing. Use at your own risk.

If this is your first time logging in, use the server public key list to verify the server fingerprint based on IP address.

Using

Once you log in, you see this menu (here, the domain is called cnryfield:)

Name                                        ID   Mem VCPUs	State	Time(s)
cnryfield                                  218  1024     1     r-----    1898.8

    Wiki at http://wiki.prgmr.com
    Please contact support@prgmr.com with any issues accessing your machine.

    Options for "cnryfield"
    1. out of band console (press ctrl-] to escape, not resizeable)
    2. create/start, opens OOB console (try this if the machine is not running)
    3. shutdown (requests operating system to shut down)
    4. force power off (destroy/hard shutdown)
    5. reboot (requests operating system to reboot)
    6. swap i386/amd64 bootloaders currently "i386"
    7. view/add/remove ssh authorized_keys
    8. set reverse dns
    9. swap pvgrub/grub2 bootloaders currently "pv-grub"

    0. exit

Option 1 can be used to access the serial console when the domain is running. Like other serial consoles, often you see nothing until you use ctrl-c or hit return, at which point you should see the normal login prompt

CentOS release 5.2 (Final)
Kernel 2.6.18-53.1.14.el5xen on an i686

cnryfield login: 

To exit the console once at the login screen shown above in most terminals, the escape sequence is ctrl+].

Option 2 should be used when the domain is not running. Before printing the menu the script runs the xen command showing the status of the domain. Example output from when the domain is not running:

Domain cnryfield is not running.

Option 3 is used to nicely shut down the domain, like hitting the power button of a physical machine briefly.

Option 4 is used to force the domain to shut down, like holding down the power button of a physical machine for several seconds.

Option 5 requests the domain to reboot. Note that if your IPs have changed since the last time you started the machine, you will need to do a shutdown (3) or destroy (4) instead of just a reboot.

Option 6 should be used if you are reinstalling your OS with a different architecture; almost all operating systems come in 32 bit (i386) and 64 bit (amd64) flavors.

Option 7 should be used if you wish to add or remove ssh keys authorized to access this menu. It will not change the keys on your domain as we have a policy of not modifying user disk images.

Option 8 allows you to modify reverse DNS, IE the dns name that comes back when you type 'host <myip>' .

Option 9 allows switching between legacy grub (pv-grub) and grub2.

Option 0 will end the ssh session.