====== Testnode Access ======
===== Summary =====
We have about 250 baremetal testnodes that get automatically reserved (locked) and unlocked by teuthology "workers."  Workers are daemons on the ''teuthology.front.sepia.ceph.com'' VM that are fed jobs via a beanstalk queue.  This page will cover setting up your workstation to lock and unlock testnodes as well as schedule teuthology suites.

Baremetal testnodes get OSes automatically "installed" using [[services:FOG]] when you lock them either via ''teuthology-lock'' or ''teuthology-suite''.

===== Teuthology Config =====
Most developers schedule suites from the ''teuthology.front.sepia.ceph.com'' VM which automatically locks/unlocks machines.

However, if you wish to run ''teuthology'' commands from your workstation, see http://docs.ceph.com/teuthology/docs/INSTALL.html#installation-and-setup.

Once you've got ''teuthology'' added to your workstation path, make sure you copy the current ''/etc/teuthology.yaml'' from ''teuthology.front.sepia.ceph.com'' to your **local** workstation's ''~/.teuthology.yaml''.

===== SSH Config =====
Baremetal testnodes get reprovisioned with an already-configured OS image including a home dir for your user account.  Your ssh public key should be in your user's **and** the ''/home/ubuntu/.ssh/authorized_keys'' file on each testnode.  You should always SSH as your username.

**Example**
<code>ssh -i ~/.ssh/id_rsa YOURUSER@testnode123.front.sepia.ceph.com</code>
//You should replace// ''~/.ssh/id_rsa'' //with whatever private key corresponds with your private key listed [[https://github.com/ceph/keys/tree/master/ssh|here]]//

To avoid interfering with other contributors' tests, you should refrain from logging into hosts that aren't locked by you via ''teuthology-lock''.

If you run into any issues with a testnode that appear to be OS, network, or environment relatated (in other words: not ceph/test related), please [[http://tracker.ceph.com/projects/teuthology/issues/new|file a ticket]].

Unless you have a separate public/private key pair on the teuthology machine, you'll want to use SSH agent forwarding when SSH'ing to teuthology.front.sepia.ceph.com.  You can do this either by using ''ssh -A USER@teuthology.front.sepia.ceph.com'' or adding the following to your workstation's ''~/.ssh/config'':

<code>
host teuthology.front.sepia.ceph.com
        User $YOURUSER
        IdentityFile ~/.ssh/id_rsa # (This should be the private key matching the public key you provided in your user access ticket)
        ForwardAgent yes # <- This is the important part

host smithi* mira* gibba*
        StrictHostKeyChecking no
        UserKnownHostsFile=/dev/null
</code>

This will allow you to SSH from your workstation -> teuthology machine -> all testnodes

Your SSH config on ''teuthology.front.sepia.ceph.com'' should have this:

<code>
Host *
  StrictHostKeyChecking no
  UserKnownHostsFile=/dev/null
</code>

===== VPSes =====
VPS (Virtual Private Servers) are ephemeral KVM virtual machines that are spun up on demand using, for example:
\\ ''%%teuthology-lock --lock-many 1 --machine-type vps --os-type ubuntu --os-version 14.04%%''

**More Information**
  * http://docs.ceph.com/teuthology/docs/downburst_vms.html
  * https://github.com/ceph/downburst

Their hostnames are ''vpm{001..200}.front.sepia.ceph.com''.  A few [[hardware:mira]] are set aside as hypervisors.  See [[services:vpshosts]].

You must create an RSA SSH keypair (named id_rsa/id_rsa.pub) to ssh to VPSes from the teuthology host.  We also recommend you have us add the public key to your pubkey file in the [[https://github.com/ceph/keys|keys repo]].

//Note: You still need a keypair even when using SSH agent forwarding from your workstation.//

The following ''~/.ssh/config'' is required for you to lock VPSes from the teuthology host.

<code>
Host *
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null

Host vpm*
  User ubuntu
</code>

===== Troubleshooting =====
==== SSHException: Error reading SSH protocol banner ====
<code>
teuthology.exceptions.MaxWhileTries: reached maximum tries (100) after waiting for 600 seconds
</code>

  - If you're using a static key file (as in you have a ''~/.ssh/id_rsa'' file) on ''teuthology.front.sepia.ceph.com'', make sure its permissions are ''0600''
  - The SSH key can NOT have a passphrase (unless you're doing SSH Agent Forwarding?)
  - The SSH key can NOT have been generated using OpenSSH version >= 7.8p1-1 (''[dpkg -l|rpm -qa] | grep openssh'' to find out)
    - Either generate your SSH key from ''teuthology.front.sepia.ceph.com'' or try ''ssh-keygen -t rsa -m PEM''
  - ''rm -f ~/.ssh/known_hosts'' and add ''UserKnownHostsFile /dev/null'' to your SSH config.
  - Ask Adam Kraitman or Dan Mick to capture new FOG images that include your public SSH key.
  - You **must** have ''ForwardAgent yes'' set for ''teuthology.front.sepia.ceph.com'' in your workstation's ''~/.ssh/config'' file.

The newest version of paramiko doesn't support SSH keys that have ''BEGIN OPENSSH PRIVATE KEY'' in them.  See https://github.com/paramiko/paramiko/issues/1015.

-----
===== Out-Of-Band Management =====
==== Further reading ====
  * [[wp>Intelligent_Platform_Management_Interface]]
  * [[wp>Serial_over_LAN]]
  * [[wp>Out-of-band_management]]

==== IPMI ====
Baremetal testnodes are accessible via out-of-band (OOB) management controllers, or BMCs.  If you're unable to reach a host via ssh on its front.sepia.ceph.com address, you can try accessing it using [[services:conserver]] and power cycle via ''ipmitool''.

==== Power Cycle Example ====
<code>
ipmitool -I lanplus -U inktank -P XXXXX -H testnode123.ipmi.sepia.ceph.com chassis power cycle
</code>
//Note the 'ipmi' vs 'front' in the FQDN//

Other common IPMI power commands include:
<code>
chassis power on
chassis power off
chassis power status
</code>

==== Java Console ====
Some OOB controllers will also have a Java console you can access by opening the IPMI address in a browser.
On most SuperMicro machines, this can be accessed at **Remote Control > Console Redirection**

**Example**
{{ ::screenshot_from_2016-02-24_18_13_59.png?direct&600 |}}