Service Desk Knowledgebase: XenE

This is the XenE content page of the CL Wiki Service Desk Knowledgebase. Its purpose is to provide information to the Service Desk team on how to handle problems and requests about this CL service. If you are involved with the provision of this CL service please feel free to add to the knowledge about that it.

If CL staff need to tell the Service Desk team about problems with this service please email
sys-admin-aside@cl.cam.ac.uk.

Return to the Service Desk Knowledgebase SERVICE PORTFOLIO

Key Service Description & URLs

• Xen virtual machine monitor
• http://www.wiki.cl.cam.ac.uk/clwiki/SysInfo/HelpDesk/XenE - - CL Sys-Admin Documentation
• http://www.wiki.cl.cam.ac.uk/clwiki/SysInfo/XeneAdmin - CL Documentation
• Computer Laboratory News (Twitter use @UC_CL_SysAdm)

CL Customer Documentation

• ???

Further CL Sys-Admin Documentation

• ???

Underpinning Services

• ??? - Any supporting or underpinning services

Customer-base for this Service

• All staff and students of the Computer Laboratory

Costs

• Free to all current staff and students of the Computer Laboratory

SLA

• N/A

Service Desk Call Handling Procedure

• RT tickets can be escalated by changing the Queue to backoffice with the Owner set to Nobody and the Status as new. Tell the requestor:
  I am passing this request over to the experts who, I'm sure, will be in contact shortly.

Checking if VM is operational

iwm21 (talk) 14:02, 9 July 2015 (BST) (9th July 2015)

• If a server is basically broken (as this one appears to be - cannot ssh in) the first step is to try 'Reboot' from XenCenter.
• If it doesn't reboot after a while, right click on the VM and select 'Force reboot'.
• If it comes up needing a fsck, let it run and accept suggested fixes.
• If it doesn't work after the above (try ssh, and expected services such as web) escalate.

Otherwise ask the user to check that it is OK.

A Xen VM is not running

The procedure below is sufficient to cover the majority of problems reported with VMs not running/available.

1. First make sure you have the Xen console running and the pools visible and connected (see section of Accessing the Xen Console)
2. In the search bar at the top of the left pane type part of the name of the VM you are looking for.
3. Expand any pools and servers that are displayed until you see the VM of interest.
4. If the VM cannot be found then escalate as above.
5. If the machine is stopped then start it and check it boots correctly by selecting the console tab and monitoring progress.
6. If it is running select it and then select the console tab in the main pane.
7. You should then see what is wrong. Linux servers can get stuck performing a file system check and need confirmation before they will fix up errors, allow that to proceed.
8. Any other error needs escalating.

A Xen VM needs more disc space

1. First make sure you have the Xen console running and the pools visible and connected (see section of Accessing the Xen Console)
2. In the search bar at the top of the left pane type part of the name of the VM you are looking for.
3. Expand any pools and servers that are displayed until you see the VM of interest.
4. If the VM cannot be found then escalate as above.
5. Click on the Storage tab in the main pane and look at the disc sizes.
6. Click on the Console tab and then login
7. Check the disk size using df -h to see if the disc is using all the space it has. If the size is much less then you can probably advise the owner to increase the partition using cl-asuser resize2fs (be aware there might be multiple partitions on a disc in which case they are labelled with a final number, if the whole disc is used it ends in a letter - this is only a concern if there are letters other than 1 associated with a disc - check with sudo blkid
8. If it is as big as it can be then you need to arrange with the user when the machine can be shut down. When it can you just use the shutdown button at the top.
9. When the machine is halted (shows as red in left pane) click on the Storage tab again.
10. Select the disc to be expanded with a left click and then click on the Properties button.
11. Click on the Size and Location section and then increase the size as needed.
12. Click OK to close the properties window and then click on Start to restart the VM.
13. Once the machine is running again select the Console tab, login and resize the disc to the requested size using something like (substituting the correct disc name)

cl-asuser resize2fs /dev/xvda1 +2G

A Xen VM needs more memory

Check with the requestor when the VM can be shut down, when it can then

1. First make sure you have the Xen console running and the pools visible and connected (see section of Accessing the Xen Console)
2. In the search bar at the top of the left pane type part of the name of the VM you are looking for.
3. Expand any pools and servers that are displayed until you see the VM of interest.
4. If the VM cannot be found then escalate as above.
5. Select the VM in the left pane, click on the Console tab and check you have the correct machine.
6. Shut it down using the red button in the top bar.
7. When the machine shows with a red label in the left pane click on the Memory tab then on the Edit button.
8. Alter the memory as requested (we always use fixed sizes) and click OK.
9. Restart the machine and check it shows the appropriate value in the Memory tab.
10. Select the Console tab and verify that the machine is running.
11. Any faults escalate as above.

Accessing the Xen Console

1. Use Remote Desktop Connection (RDP) to go to ts01.ad.cl.cam.ac.uk or ts00.ad.cl.cam.ac.uk and login using your CRSid@ad.cl.cam.ac.uk account
2. Use [Start] > All Programs > Citrix > Citrix XenCenter
3. Wait - Citrix XenCenter takes a long while to start up!

iwm21 (talk) 17:00, 9 July 2015 (BST): Notes: you may need to add the ".cl.cam.ac.uk" domain to the server name

The First time it is run (or if no Xen pools are found) the pools of machines need to be added using:

• Click XenCenter (in left panel)
• Click Add a server (in right panel)
  • Set Server: xene-pool1
  • Set User name: root
  • Set Password: "Enable password"
  • Click [Add]
• Click Add a server (in right panel)
  • Set Server: xene-pool2
  • Set User name: root
  • Set Password: "Enable password"
  • Click [Add]
• Click Add a server (in right panel)
  • Set Server: xene-pool3
  • Set User name: root
  • Set Password: "Enable password"
  • Click [Add]
• Click Add a server (in right panel)
  • Set Server: xene-pool4
  • Set User name: root
  • Set Password: "Enable password"
  • Click [Add]

To finish:

1. Close down Citrix XenCenter with [X]
2. Use [Start] [Log off] to terminate your RDP to the TS01 terminal server

Contacts

Primary

• pb22@cl.cam.ac.uk if URGENT for Piete Brooks
• ???@lists.cam.ac.uk (Goes to ???)
• Tel: ???

Other

• Firstname Lastname

Availability

• Monday:
• Tuesday:
• Wednesday:
• Thursday:
• Friday:
• Saturday: Closed
• Sunday: Closed

Additional CL Staff Resources

• ???

Hints, Tips & Known Issues

Checking if VM is operational

iwm21 (talk) 14:02, 9 July 2015 (BST) (9th July 2015)

• If a server is basically broken (as this one appears to be - cannot ssh in) the first step is to try 'Reboot' from XenCenter.
• If it doesn't reboot after a while, right click on the VM and select 'Force reboot'.
• If it comes up needing a fsck, let it run and accept suggested fixes.
• If it doesn't work after the above (try ssh, and expected services such as web) escalate.

Otherwise ask the user to check that it is OK.

---

Categorising Keywords

• XenE Xen XenAppliance XenEnterprise XenServer