{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"58f33ffa-4ae8-4b49-9533-8222e25c6fa5"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"4e3bb2be-7f0f-498a-88b1-e29bb45afbc6"}},{"type":"paragraph","content":[{"text":"Abiquo uploads templates using the Appliance Manager (AM) Remote Service. To enable API template upload, Abiquo exposes a resource from the private AM API. The authentication for the use of this resource is performed through the Abiquo API.","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes how to upload:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a standard template to the Appliance Manager using the Appliance Manager API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an OVA file to the Appliance Manager using the Appliance Manager API","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Template files","type":"text"}]},{"type":"paragraph","content":[{"text":"To upload a standard template you will need:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"diskFile","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"one virtual machine disk file, e.g. .vmdk file","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"diskInfo","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JSON or XML representation of the template metadata","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"To upload an OVA file you will need:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"diskFile","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OVA format with a filename extension of \".ova\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"can contain multiple disks","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"no need to provide template metadata, e.g. disk capacity, because this is in the OVF descriptor file","type":"text"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Preparatory steps","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1. Retrieve the appliance manager base URI","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X GET https://myabiquo/api/admin/datacenters/1/remoteservices","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":" {\n \"id\": 3, \n \"links\": [\n {\n \"href\": \"https://myabiquo:443/api/admin/remoteservices/3\", \n \"rel\": \"edit\", \n \"title\": \"APPLIANCEMANAGER\", \n \"type\": \"application/vnd.abiquo.remoteservice+json\"\n }, \n {\n \"href\": \"https://myabiquo:443/api/admin/remoteservices/3/action/check\", \n \"rel\": \"check\", \n \"title\": \"check\", \n \"type\": \"\"\n }, \n {\n \"href\": \"https://myabiquo:443/api/admin/datacenters/1\", \n \"rel\": \"datacenter\", \n \"title\": \"BCDC\", \n \"type\": \"application/vnd.abiquo.datacenter+json\"\n }\n ], \n \"status\": 1, \n \"type\": \"APPLIANCE_MANAGER\", \n \"uri\": \"https://myabiquo:443/am\", \n \"uuid\": \"Abiquo\"\n }, ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2. For a standard template, specify the template meta-data in JSON or XML","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample JSON template","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n\"name\":\"a new template\",\n\"description\":\"this is a test\",\n\"categoryName\":\"simpaticos\",\n\"diskFileFormat\":\"VMDK_FLAT\",\n\"requiredCpu\":1,\n\"requiredHDInMB\":2,\n\"requiredRamInMB\":256\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample XML template","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"TIP: use qemu-img to determine the diskFileFormat and requiredHDInMB (=capacity for compressed formats)","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upload standard template example","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example shows how to upload a single disk file named 'disk.vmdk' and metadata stored in file 'template.json' for the enterprise with id '1'","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ curl --verbose -uadmin:xabiquo -F \"diskInfo=@template.json\" -F \"diskFile=@disk.vmdk\" http://10.60.1.223/am/erepos/1/templates\n> POST /am/erepos/1/templates HTTP/1.1\n> Content-Length: 643854480\n> Expect: 100-continue\n> Content-Type: multipart/form-data; boundary=----------------------------be5dd7d6950d\n>\n< HTTP/1.1 100 Continue\n\n< HTTP/1.1 201 Creado\n< Location: http://10.60.1.223/am/erepos/1/templates/1/10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk\n< Content-Length: 0","type":"text"}]},{"type":"paragraph","content":[{"text":"In the returned 'Location' header there is a link to reference the template that was created.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Check the upload","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the metadata:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ curl --verbose -uadmin:xabiquo -X GET \"http://10.60.1.223/am/erepos/1/templates/1/10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the template content:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ curl --verbose -uadmin:xabiquo -X GET \"http://10.60.1.223/am/files/1/10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk\"","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Identify your template in the API","type":"text"}]},{"type":"paragraph","content":[{"text":"The relative path (1/","type":"text"},{"text":"10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk","type":"text","marks":[{"type":"link","attrs":{"href":"http://10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk"}}]},{"text":") should be used to identify the virtual machine template you created in the abiquo API","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --verbose -uadmin:xabiquo http://localhost/api/admin/enterprises/1/datacenterrepositories/1/virtualmachinetemplates | xmlprint | grep -C 5 /1/10.60.1.223/1fc06416-6696-4b55-9d7c-d58bc51aaf5a/disk.vmdk","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n....\n \n \n \n...\n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upload OVA template example","type":"text"}]},{"type":"paragraph","content":[{"text":"To upload an OVA template, start by reading the above sections that describe the ","type":"text"},{"text":"#Template Files","type":"text","marks":[{"type":"link","attrs":{"href":"#AppliancemanagertemplateAPIuploadanddownload-TemplateFiles"}}]},{"text":" and the ","type":"text"},{"text":"#Preparatory Steps","type":"text","marks":[{"type":"link","attrs":{"href":"#AppliancemanagertemplateAPIuploadanddownload-PreparatorySteps"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example shows how to upload an OVA file, which may have multiple VM disk files. Include the template and disk details in the OVF descriptor file inside the OVA. Do not supply a diskInfo file for the template because this information is included in the OVA file. Supply the OVA file with the filename extension of \".ova\". ","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the same link as for standard template upload.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ curl --verbose -uadmin:xabiquo -F \"diskFile=@disk.ova\" -X POST https://myabiquo:443/am/erepos/8/templates\n> POST /am/erepos/8/templates HTTP/1.1\n> Authorization: Basic YWRtaW46eGFiaXF1bw==\n> User-Agent: curl/7.35.0\n> Host: myabiquo\n> Accept: */*\n> Content-Length: 27279568\n> Expect: 100-continue\n> Content-Type: multipart/form-data; boundary=------------------------934b0504be069532\n> \n< HTTP/1.1 100 Continue\n< HTTP/1.1 201 Created\n< Date: Mon, 28 Sep 2015 15:11:38 GMT\n< Location: https://myabiquo/am/erepos/8/templates/8/myabiquo/b689db73-769f-467e-867d-5913a1f5c281-m0n0wall.ova/m0n0wall/\n< Content-Length: 0\n< Content-Type: text/plain\n< \n* Connection #0 to host myabiquo left intact\n\n\n< Content-Length: 0","type":"text"}]},{"type":"paragraph","content":[{"text":"In the response 'Location' header there is a link to reference the template that was created.","type":"text"}]}],"version":1}