Restoring manta images.

manta-images.md

Exporting and Importing Custom Images

Custom images for Triton are stored within the Manta Object Store for that region. In the event of a Manta reset, these custom images will be lost if they are not backed up.

Note: This requires the use of the node-triton command line tooling; this cannot be currently handled from within the DevOps portal. For information on the node-triton tooling, please see XXXX

Listing Custom Images

• Ensure that your API endpoint is set to the correct Manta region and that you are using the correct account

• List your custom images

$ triton image ls public=false
SHORTID   NAME          VERSION  FLAGS  OS       TYPE          PUBDATE
3851731d  ghost-latest  1.0      I      smartos  zone-dataset  2016-11-29
98120cce  test          1.0      I      smartos  zone-dataset  2016-11-29

Backing Up Custom Images

• Ensure that your API endpoint is set to the correct Manta region and that you are using the correct account

• Export your image to a manta path Note: the full manta pathname must be given

$ triton image export ghost-latest /jay.schmidt/stor/image-backup
Exporting image ghost-latest to /jay.schmidt/stor/image-backup
    Manta URL: https://us-east.manta.joyent.com
Manifest path: /jay.schmidt/stor/image-backup/ghost-latest-1.0.imgmanifest
   Image path: /jay.schmidt/stor/image-backup/ghost-latest-1.0.zfs.gz

• Download your images Note: you must download both the manifest and the data file

$ mkdir image-backup
$ cd image-backup
$ mget -O /jay.schmidt/stor/image-backup/ghost-latest-1.0.imgmanifest
$ mget -O /jay.schmidt/stor/image-backup/ghost-latest-1.0.zfs.gz

Restoring Custom Images

• Reupload the manifest and data file to Manta

$ cd image-backup
$ mmkdir /jay.schmidt/stor/image-backup
$ mput -f ghost-latest-1.0.imgmanifest /jay.schmidt/stor/image-backup
$ mput -f ghost-latest-1.0.zfs.gz /jay.schmidt/stor/image-backup

• Raise a suport request including the folowing

  • The region you are working in (ie, US-EAST)
  • The full path to your image backup directory
  • The name of your manifest file and your data file

• The support team will process your upload and then ask you to verify that your image appears correctly in the system using the triton image list public=false command.