VirtualBox

source: vbox/trunk/src/VBox/Main/ApplianceImplExport.cpp@ 29945

Last change on this file since 29945 was 29925, checked in by vboxsync, 15 years ago

OVF: respect override of import parameters (setFinalValues) also when vbox:Machine is present, first batch (everything except storage)

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 79.0 KB
Line 
1/* $Id: ApplianceImplExport.cpp 29925 2010-05-31 18:33:15Z vboxsync $ */
2/** @file
3 *
4 * IAppliance and IVirtualSystem COM class implementations.
5 */
6
7/*
8 * Copyright (C) 2008-2010 Oracle Corporation
9 *
10 * This file is part of VirtualBox Open Source Edition (OSE), as
11 * available from http://www.virtualbox.org. This file is free software;
12 * you can redistribute it and/or modify it under the terms of the GNU
13 * General Public License (GPL) as published by the Free Software
14 * Foundation, in version 2 as it comes in the "COPYING" file of the
15 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
16 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
17 */
18
19#include <iprt/path.h>
20#include <iprt/dir.h>
21#include <iprt/param.h>
22#include <iprt/s3.h>
23#include <iprt/manifest.h>
24
25#include <VBox/version.h>
26
27#include "ApplianceImpl.h"
28#include "VirtualBoxImpl.h"
29
30#include "ProgressImpl.h"
31#include "MachineImpl.h"
32
33#include "AutoCaller.h"
34#include "Logging.h"
35
36#include "ApplianceImplPrivate.h"
37
38using namespace std;
39
40////////////////////////////////////////////////////////////////////////////////
41//
42// IMachine public methods
43//
44////////////////////////////////////////////////////////////////////////////////
45
46// This code is here so we won't have to include the appliance headers in the
47// IMachine implementation, and we also need to access private appliance data.
48
49/**
50* Public method implementation.
51* @param appliance
52* @return
53*/
54
55STDMETHODIMP Machine::Export(IAppliance *aAppliance, IVirtualSystemDescription **aDescription)
56{
57 HRESULT rc = S_OK;
58
59 if (!aAppliance)
60 return E_POINTER;
61
62 AutoCaller autoCaller(this);
63 if (FAILED(autoCaller.rc())) return autoCaller.rc();
64
65 ComObjPtr<VirtualSystemDescription> pNewDesc;
66
67 try
68 {
69 // create a new virtual system to store in the appliance
70 rc = pNewDesc.createObject();
71 if (FAILED(rc)) throw rc;
72 rc = pNewDesc->init();
73 if (FAILED(rc)) throw rc;
74
75 // store the machine object so we can dump the XML in Appliance::Write()
76 pNewDesc->m->pMachine = this;
77
78 // now fill it with description items
79 Bstr bstrName1;
80 Bstr bstrDescription;
81 Bstr bstrGuestOSType;
82 uint32_t cCPUs;
83 uint32_t ulMemSizeMB;
84 BOOL fUSBEnabled;
85 BOOL fAudioEnabled;
86 AudioControllerType_T audioController;
87
88 ComPtr<IUSBController> pUsbController;
89 ComPtr<IAudioAdapter> pAudioAdapter;
90
91 // first, call the COM methods, as they request locks
92 rc = COMGETTER(USBController)(pUsbController.asOutParam());
93 if (FAILED(rc))
94 fUSBEnabled = false;
95 else
96 rc = pUsbController->COMGETTER(Enabled)(&fUSBEnabled);
97
98 // request the machine lock while acessing internal members
99 AutoReadLock alock1(this COMMA_LOCKVAL_SRC_POS);
100
101 pAudioAdapter = mAudioAdapter;
102 rc = pAudioAdapter->COMGETTER(Enabled)(&fAudioEnabled);
103 if (FAILED(rc)) throw rc;
104 rc = pAudioAdapter->COMGETTER(AudioController)(&audioController);
105 if (FAILED(rc)) throw rc;
106
107 // get name
108 bstrName1 = mUserData->mName;
109 // get description
110 bstrDescription = mUserData->mDescription;
111 // get guest OS
112 bstrGuestOSType = mUserData->mOSTypeId;
113 // CPU count
114 cCPUs = mHWData->mCPUCount;
115 // memory size in MB
116 ulMemSizeMB = mHWData->mMemorySize;
117 // VRAM size?
118 // BIOS settings?
119 // 3D acceleration enabled?
120 // hardware virtualization enabled?
121 // nested paging enabled?
122 // HWVirtExVPIDEnabled?
123 // PAEEnabled?
124 // snapshotFolder?
125 // VRDPServer?
126
127 /* Guest OS type */
128 Utf8Str strOsTypeVBox(bstrGuestOSType);
129 ovf::CIMOSType_T cim = convertVBoxOSType2CIMOSType(strOsTypeVBox.c_str());
130 pNewDesc->addEntry(VirtualSystemDescriptionType_OS,
131 "",
132 Utf8StrFmt("%RI32", cim),
133 strOsTypeVBox);
134
135 /* VM name */
136 Utf8Str strVMName(bstrName1);
137 pNewDesc->addEntry(VirtualSystemDescriptionType_Name,
138 "",
139 strVMName,
140 strVMName);
141
142 // description
143 Utf8Str strDescription(bstrDescription);
144 pNewDesc->addEntry(VirtualSystemDescriptionType_Description,
145 "",
146 strDescription,
147 strDescription);
148
149 /* CPU count*/
150 Utf8Str strCpuCount = Utf8StrFmt("%RI32", cCPUs);
151 pNewDesc->addEntry(VirtualSystemDescriptionType_CPU,
152 "",
153 strCpuCount,
154 strCpuCount);
155
156 /* Memory */
157 Utf8Str strMemory = Utf8StrFmt("%RI64", (uint64_t)ulMemSizeMB * _1M);
158 pNewDesc->addEntry(VirtualSystemDescriptionType_Memory,
159 "",
160 strMemory,
161 strMemory);
162
163 // the one VirtualBox IDE controller has two channels with two ports each, which is
164 // considered two IDE controllers with two ports each by OVF, so export it as two
165 int32_t lIDEControllerPrimaryIndex = 0;
166 int32_t lIDEControllerSecondaryIndex = 0;
167 int32_t lSATAControllerIndex = 0;
168 int32_t lSCSIControllerIndex = 0;
169
170 /* Fetch all available storage controllers */
171 com::SafeIfaceArray<IStorageController> nwControllers;
172 rc = COMGETTER(StorageControllers)(ComSafeArrayAsOutParam(nwControllers));
173 if (FAILED(rc)) throw rc;
174
175 ComPtr<IStorageController> pIDEController;
176 ComPtr<IStorageController> pSATAController;
177 ComPtr<IStorageController> pSCSIController;
178 ComPtr<IStorageController> pSASController;
179 for (size_t j = 0; j < nwControllers.size(); ++j)
180 {
181 StorageBus_T eType;
182 rc = nwControllers[j]->COMGETTER(Bus)(&eType);
183 if (FAILED(rc)) throw rc;
184 if ( eType == StorageBus_IDE
185 && pIDEController.isNull())
186 pIDEController = nwControllers[j];
187 else if ( eType == StorageBus_SATA
188 && pSATAController.isNull())
189 pSATAController = nwControllers[j];
190 else if ( eType == StorageBus_SCSI
191 && pSATAController.isNull())
192 pSCSIController = nwControllers[j];
193 else if ( eType == StorageBus_SAS
194 && pSASController.isNull())
195 pSASController = nwControllers[j];
196 }
197
198// <const name="HardDiskControllerIDE" value="6" />
199 if (!pIDEController.isNull())
200 {
201 Utf8Str strVbox;
202 StorageControllerType_T ctlr;
203 rc = pIDEController->COMGETTER(ControllerType)(&ctlr);
204 if (FAILED(rc)) throw rc;
205 switch(ctlr)
206 {
207 case StorageControllerType_PIIX3: strVbox = "PIIX3"; break;
208 case StorageControllerType_PIIX4: strVbox = "PIIX4"; break;
209 case StorageControllerType_ICH6: strVbox = "ICH6"; break;
210 }
211
212 if (strVbox.length())
213 {
214 lIDEControllerPrimaryIndex = (int32_t)pNewDesc->m->llDescriptions.size();
215 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskControllerIDE,
216 Utf8StrFmt("%d", lIDEControllerPrimaryIndex), // strRef
217 strVbox, // aOvfValue
218 strVbox); // aVboxValue
219 lIDEControllerSecondaryIndex = lIDEControllerPrimaryIndex + 1;
220 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskControllerIDE,
221 Utf8StrFmt("%d", lIDEControllerSecondaryIndex),
222 strVbox,
223 strVbox);
224 }
225 }
226
227// <const name="HardDiskControllerSATA" value="7" />
228 if (!pSATAController.isNull())
229 {
230 Utf8Str strVbox = "AHCI";
231 lSATAControllerIndex = (int32_t)pNewDesc->m->llDescriptions.size();
232 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskControllerSATA,
233 Utf8StrFmt("%d", lSATAControllerIndex),
234 strVbox,
235 strVbox);
236 }
237
238// <const name="HardDiskControllerSCSI" value="8" />
239 if (!pSCSIController.isNull())
240 {
241 StorageControllerType_T ctlr;
242 rc = pSCSIController->COMGETTER(ControllerType)(&ctlr);
243 if (SUCCEEDED(rc))
244 {
245 Utf8Str strVbox = "LsiLogic"; // the default in VBox
246 switch(ctlr)
247 {
248 case StorageControllerType_LsiLogic: strVbox = "LsiLogic"; break;
249 case StorageControllerType_BusLogic: strVbox = "BusLogic"; break;
250 }
251 lSCSIControllerIndex = (int32_t)pNewDesc->m->llDescriptions.size();
252 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskControllerSCSI,
253 Utf8StrFmt("%d", lSCSIControllerIndex),
254 strVbox,
255 strVbox);
256 }
257 else
258 throw rc;
259 }
260
261 if (!pSASController.isNull())
262 {
263 // VirtualBox considers the SAS controller a class of its own but in OVF
264 // it should be a SCSI controller
265 Utf8Str strVbox = "LsiLogicSas";
266 lSCSIControllerIndex = (int32_t)pNewDesc->m->llDescriptions.size();
267 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskControllerSCSI,
268 Utf8StrFmt("%d", lSCSIControllerIndex),
269 strVbox,
270 strVbox);
271 }
272
273// <const name="HardDiskImage" value="9" />
274// <const name="Floppy" value="18" />
275// <const name="CDROM" value="19" />
276
277 MediaData::AttachmentList::iterator itA;
278 for (itA = mMediaData->mAttachments.begin();
279 itA != mMediaData->mAttachments.end();
280 ++itA)
281 {
282 ComObjPtr<MediumAttachment> pHDA = *itA;
283
284 // the attachment's data
285 ComPtr<IMedium> pMedium;
286 ComPtr<IStorageController> ctl;
287 Bstr controllerName;
288
289 rc = pHDA->COMGETTER(Controller)(controllerName.asOutParam());
290 if (FAILED(rc)) throw rc;
291
292 rc = GetStorageControllerByName(controllerName, ctl.asOutParam());
293 if (FAILED(rc)) throw rc;
294
295 StorageBus_T storageBus;
296 DeviceType_T deviceType;
297 LONG lChannel;
298 LONG lDevice;
299
300 rc = ctl->COMGETTER(Bus)(&storageBus);
301 if (FAILED(rc)) throw rc;
302
303 rc = pHDA->COMGETTER(Type)(&deviceType);
304 if (FAILED(rc)) throw rc;
305
306 rc = pHDA->COMGETTER(Medium)(pMedium.asOutParam());
307 if (FAILED(rc)) throw rc;
308
309 rc = pHDA->COMGETTER(Port)(&lChannel);
310 if (FAILED(rc)) throw rc;
311
312 rc = pHDA->COMGETTER(Device)(&lDevice);
313 if (FAILED(rc)) throw rc;
314
315 Utf8Str strTargetVmdkName;
316 Utf8Str strLocation;
317 ULONG64 ullSize = 0;
318
319 if ( deviceType == DeviceType_HardDisk
320 && pMedium
321 )
322 {
323 Bstr bstrLocation;
324 rc = pMedium->COMGETTER(Location)(bstrLocation.asOutParam());
325 if (FAILED(rc)) throw rc;
326 strLocation = bstrLocation;
327
328 // find the source's base medium for two things:
329 // 1) we'll use its name to determine the name of the target disk, which is readable,
330 // as opposed to the UUID filename of a differencing image, if pMedium is one
331 // 2) we need the size of the base image so we can give it to addEntry(), and later
332 // on export, the progress will be based on that (and not the diff image)
333 ComPtr<IMedium> pBaseMedium;
334 rc = pMedium->COMGETTER(Base)(pBaseMedium.asOutParam());
335 // returns pMedium if there are no diff images
336 if (FAILED(rc)) throw rc;
337
338 Bstr bstrBaseName;
339 rc = pBaseMedium->COMGETTER(Name)(bstrBaseName.asOutParam());
340 if (FAILED(rc)) throw rc;
341
342 strTargetVmdkName = bstrBaseName;
343 strTargetVmdkName.stripExt();
344 strTargetVmdkName.append(".vmdk");
345
346 // force reading state, or else size will be returned as 0
347 MediumState_T ms;
348 rc = pBaseMedium->RefreshState(&ms);
349 if (FAILED(rc)) throw rc;
350
351 rc = pBaseMedium->COMGETTER(Size)(&ullSize);
352 if (FAILED(rc)) throw rc;
353 }
354
355 // and how this translates to the virtual system
356 int32_t lControllerVsys = 0;
357 LONG lChannelVsys;
358
359 switch (storageBus)
360 {
361 case StorageBus_IDE:
362 // this is the exact reverse to what we're doing in Appliance::taskThreadImportMachines,
363 // and it must be updated when that is changed!
364 // Before 3.2 we exported one IDE controller with channel 0-3, but we now maintain
365 // compatibility with what VMware does and export two IDE controllers with two channels each
366
367 if (lChannel == 0 && lDevice == 0) // primary master
368 {
369 lControllerVsys = lIDEControllerPrimaryIndex;
370 lChannelVsys = 0;
371 }
372 else if (lChannel == 0 && lDevice == 1) // primary slave
373 {
374 lControllerVsys = lIDEControllerPrimaryIndex;
375 lChannelVsys = 1;
376 }
377 else if (lChannel == 1 && lDevice == 0) // secondary master; by default this is the CD-ROM but as of VirtualBox 3.1 that can change
378 {
379 lControllerVsys = lIDEControllerSecondaryIndex;
380 lChannelVsys = 0;
381 }
382 else if (lChannel == 1 && lDevice == 1) // secondary slave
383 {
384 lControllerVsys = lIDEControllerSecondaryIndex;
385 lChannelVsys = 1;
386 }
387 else
388 throw setError(VBOX_E_NOT_SUPPORTED,
389 tr("Cannot handle medium attachment: channel is %d, device is %d"), lChannel, lDevice);
390 break;
391
392 case StorageBus_SATA:
393 lChannelVsys = lChannel; // should be between 0 and 29
394 lControllerVsys = lSATAControllerIndex;
395 break;
396
397 case StorageBus_SCSI:
398 case StorageBus_SAS:
399 lChannelVsys = lChannel; // should be between 0 and 15
400 lControllerVsys = lSCSIControllerIndex;
401 break;
402
403 case StorageBus_Floppy:
404 lChannelVsys = 0;
405 lControllerVsys = 0;
406 break;
407
408 default:
409 throw setError(VBOX_E_NOT_SUPPORTED,
410 tr("Cannot handle medium attachment: storageBus is %d, channel is %d, device is %d"), storageBus, lChannel, lDevice);
411 break;
412 }
413
414 Utf8StrFmt strExtra("controller=%RI32;channel=%RI32", lControllerVsys, lChannelVsys);
415 Utf8Str strEmpty;
416
417 switch (deviceType)
418 {
419 case DeviceType_HardDisk:
420 Log(("Adding VirtualSystemDescriptionType_HardDiskImage, disk size: %RI64\n", ullSize));
421 pNewDesc->addEntry(VirtualSystemDescriptionType_HardDiskImage,
422 strTargetVmdkName, // disk ID: let's use the name
423 strTargetVmdkName, // OVF value:
424 strLocation, // vbox value: media path
425 (uint32_t)(ullSize / _1M),
426 strExtra);
427 break;
428
429 case DeviceType_DVD:
430 pNewDesc->addEntry(VirtualSystemDescriptionType_CDROM,
431 strEmpty, // disk ID
432 strEmpty, // OVF value
433 strEmpty, // vbox value
434 1, // ulSize
435 strExtra);
436 break;
437
438 case DeviceType_Floppy:
439 pNewDesc->addEntry(VirtualSystemDescriptionType_Floppy,
440 strEmpty, // disk ID
441 strEmpty, // OVF value
442 strEmpty, // vbox value
443 1, // ulSize
444 strExtra);
445 break;
446 }
447 }
448
449// <const name="NetworkAdapter" />
450 size_t a;
451 for (a = 0;
452 a < SchemaDefs::NetworkAdapterCount;
453 ++a)
454 {
455 ComPtr<INetworkAdapter> pNetworkAdapter;
456 BOOL fEnabled;
457 NetworkAdapterType_T adapterType;
458 NetworkAttachmentType_T attachmentType;
459
460 rc = GetNetworkAdapter((ULONG)a, pNetworkAdapter.asOutParam());
461 if (FAILED(rc)) throw rc;
462 /* Enable the network card & set the adapter type */
463 rc = pNetworkAdapter->COMGETTER(Enabled)(&fEnabled);
464 if (FAILED(rc)) throw rc;
465
466 if (fEnabled)
467 {
468 Utf8Str strAttachmentType;
469
470 rc = pNetworkAdapter->COMGETTER(AdapterType)(&adapterType);
471 if (FAILED(rc)) throw rc;
472
473 rc = pNetworkAdapter->COMGETTER(AttachmentType)(&attachmentType);
474 if (FAILED(rc)) throw rc;
475
476 switch (attachmentType)
477 {
478 case NetworkAttachmentType_Null:
479 strAttachmentType = "Null";
480 break;
481
482 case NetworkAttachmentType_NAT:
483 strAttachmentType = "NAT";
484 break;
485
486 case NetworkAttachmentType_Bridged:
487 strAttachmentType = "Bridged";
488 break;
489
490 case NetworkAttachmentType_Internal:
491 strAttachmentType = "Internal";
492 break;
493
494 case NetworkAttachmentType_HostOnly:
495 strAttachmentType = "HostOnly";
496 break;
497 }
498
499 pNewDesc->addEntry(VirtualSystemDescriptionType_NetworkAdapter,
500 "", // ref
501 strAttachmentType, // orig
502 Utf8StrFmt("%RI32", (uint32_t)adapterType), // conf
503 0,
504 Utf8StrFmt("type=%s", strAttachmentType.c_str())); // extra conf
505 }
506 }
507
508// <const name="USBController" />
509#ifdef VBOX_WITH_USB
510 if (fUSBEnabled)
511 pNewDesc->addEntry(VirtualSystemDescriptionType_USBController, "", "", "");
512#endif /* VBOX_WITH_USB */
513
514// <const name="SoundCard" />
515 if (fAudioEnabled)
516 pNewDesc->addEntry(VirtualSystemDescriptionType_SoundCard,
517 "",
518 "ensoniq1371", // this is what OVFTool writes and VMware supports
519 Utf8StrFmt("%RI32", audioController));
520
521 // finally, add the virtual system to the appliance
522 Appliance *pAppliance = static_cast<Appliance*>(aAppliance);
523 AutoCaller autoCaller1(pAppliance);
524 if (FAILED(autoCaller1.rc())) return autoCaller1.rc();
525
526 /* We return the new description to the caller */
527 ComPtr<IVirtualSystemDescription> copy(pNewDesc);
528 copy.queryInterfaceTo(aDescription);
529
530 AutoWriteLock alock(pAppliance COMMA_LOCKVAL_SRC_POS);
531
532 pAppliance->m->virtualSystemDescriptions.push_back(pNewDesc);
533 }
534 catch(HRESULT arc)
535 {
536 rc = arc;
537 }
538
539 return rc;
540}
541
542////////////////////////////////////////////////////////////////////////////////
543//
544// IAppliance public methods
545//
546////////////////////////////////////////////////////////////////////////////////
547
548/**
549 * Public method implementation.
550 * @param format
551 * @param path
552 * @param aProgress
553 * @return
554 */
555STDMETHODIMP Appliance::Write(IN_BSTR format, IN_BSTR path, IProgress **aProgress)
556{
557 if (!path) return E_POINTER;
558 CheckComArgOutPointerValid(aProgress);
559
560 AutoCaller autoCaller(this);
561 if (FAILED(autoCaller.rc())) return autoCaller.rc();
562
563 AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
564
565 // do not allow entering this method if the appliance is busy reading or writing
566 if (!isApplianceIdle())
567 return E_ACCESSDENIED;
568
569 // see if we can handle this file; for now we insist it has an ".ovf" extension
570 Utf8Str strPath = path;
571 if (!strPath.endsWith(".ovf", Utf8Str::CaseInsensitive))
572 return setError(VBOX_E_FILE_ERROR,
573 tr("Appliance file must have .ovf extension"));
574
575 Utf8Str strFormat(format);
576 OVFFormat ovfF;
577 if (strFormat == "ovf-0.9")
578 ovfF = OVF_0_9;
579 else if (strFormat == "ovf-1.0")
580 ovfF = OVF_1_0;
581 else
582 return setError(VBOX_E_FILE_ERROR,
583 tr("Invalid format \"%s\" specified"), strFormat.c_str());
584
585 ComObjPtr<Progress> progress;
586 HRESULT rc = S_OK;
587 try
588 {
589 /* Parse all necessary info out of the URI */
590 parseURI(strPath, m->locInfo);
591 rc = writeImpl(ovfF, m->locInfo, progress);
592 }
593 catch (HRESULT aRC)
594 {
595 rc = aRC;
596 }
597
598 if (SUCCEEDED(rc))
599 /* Return progress to the caller */
600 progress.queryInterfaceTo(aProgress);
601
602 return rc;
603}
604
605////////////////////////////////////////////////////////////////////////////////
606//
607// Appliance private methods
608//
609////////////////////////////////////////////////////////////////////////////////
610
611/**
612 * Implementation for writing out the OVF to disk. This starts a new thread which will call
613 * Appliance::taskThreadWriteOVF().
614 *
615 * This is in a separate private method because it is used from two locations:
616 *
617 * 1) from the public Appliance::Write().
618 * 2) from Appliance::writeS3(), which got called from a previous instance of Appliance::taskThreadWriteOVF().
619 *
620 * @param aFormat
621 * @param aLocInfo
622 * @param aProgress
623 * @return
624 */
625HRESULT Appliance::writeImpl(OVFFormat aFormat, const LocationInfo &aLocInfo, ComObjPtr<Progress> &aProgress)
626{
627 HRESULT rc = S_OK;
628 try
629 {
630 rc = setUpProgress(aProgress,
631 BstrFmt(tr("Export appliance '%s'"), aLocInfo.strPath.c_str()),
632 (aLocInfo.storageType == VFSType_File) ? WriteFile : WriteS3);
633
634 /* Initialize our worker task */
635 std::auto_ptr<TaskOVF> task(new TaskOVF(this, TaskOVF::Write, aLocInfo, aProgress));
636 /* The OVF version to write */
637 task->enFormat = aFormat;
638
639 rc = task->startThread();
640 if (FAILED(rc)) throw rc;
641
642 /* Don't destruct on success */
643 task.release();
644 }
645 catch (HRESULT aRC)
646 {
647 rc = aRC;
648 }
649
650 return rc;
651}
652
653/**
654 * Called from Appliance::writeFS() for each virtual system (machine) that needs XML written out.
655 *
656 * @param elmToAddVirtualSystemsTo XML element to append elements to.
657 * @param vsdescThis The IVirtualSystemDescription instance for which to write XML.
658 * @param enFormat OVF format (0.9 or 1.0).
659 * @param stack Structure for temporary private data shared with caller.
660 */
661void Appliance::buildXMLForOneVirtualSystem(xml::ElementNode &elmToAddVirtualSystemsTo,
662 std::list<xml::ElementNode*> *pllElementsWithUuidAttributes,
663 ComObjPtr<VirtualSystemDescription> &vsdescThis,
664 OVFFormat enFormat,
665 XMLStack &stack)
666{
667 LogFlowFunc(("ENTER appliance %p\n", this));
668
669 xml::ElementNode *pelmVirtualSystem;
670 if (enFormat == OVF_0_9)
671 {
672 // <Section xsi:type="ovf:NetworkSection_Type">
673 pelmVirtualSystem = elmToAddVirtualSystemsTo.createChild("Content");
674 pelmVirtualSystem->setAttribute("xsi:type", "ovf:VirtualSystem_Type");
675 }
676 else
677 pelmVirtualSystem = elmToAddVirtualSystemsTo.createChild("VirtualSystem");
678
679 /*xml::ElementNode *pelmVirtualSystemInfo =*/ pelmVirtualSystem->createChild("Info")->addContent("A virtual machine");
680
681 std::list<VirtualSystemDescriptionEntry*> llName = vsdescThis->findByType(VirtualSystemDescriptionType_Name);
682 if (llName.size() != 1)
683 throw setError(VBOX_E_NOT_SUPPORTED,
684 tr("Missing VM name"));
685 Utf8Str &strVMName = llName.front()->strVboxCurrent;
686 pelmVirtualSystem->setAttribute("ovf:id", strVMName);
687
688 // product info
689 std::list<VirtualSystemDescriptionEntry*> llProduct = vsdescThis->findByType(VirtualSystemDescriptionType_Product);
690 std::list<VirtualSystemDescriptionEntry*> llProductUrl = vsdescThis->findByType(VirtualSystemDescriptionType_ProductUrl);
691 std::list<VirtualSystemDescriptionEntry*> llVendor = vsdescThis->findByType(VirtualSystemDescriptionType_Vendor);
692 std::list<VirtualSystemDescriptionEntry*> llVendorUrl = vsdescThis->findByType(VirtualSystemDescriptionType_VendorUrl);
693 std::list<VirtualSystemDescriptionEntry*> llVersion = vsdescThis->findByType(VirtualSystemDescriptionType_Version);
694 bool fProduct = llProduct.size() && !llProduct.front()->strVboxCurrent.isEmpty();
695 bool fProductUrl = llProductUrl.size() && !llProductUrl.front()->strVboxCurrent.isEmpty();
696 bool fVendor = llVendor.size() && !llVendor.front()->strVboxCurrent.isEmpty();
697 bool fVendorUrl = llVendorUrl.size() && !llVendorUrl.front()->strVboxCurrent.isEmpty();
698 bool fVersion = llVersion.size() && !llVersion.front()->strVboxCurrent.isEmpty();
699 if (fProduct ||
700 fProductUrl ||
701 fVersion ||
702 fVendorUrl ||
703 fVersion)
704 {
705 /* <Section ovf:required="false" xsi:type="ovf:ProductSection_Type">
706 <Info>Meta-information about the installed software</Info>
707 <Product>VAtest</Product>
708 <Vendor>SUN Microsystems</Vendor>
709 <Version>10.0</Version>
710 <ProductUrl>http://blogs.sun.com/VirtualGuru</ProductUrl>
711 <VendorUrl>http://www.sun.com</VendorUrl>
712 </Section> */
713 xml::ElementNode *pelmAnnotationSection;
714 if (enFormat == OVF_0_9)
715 {
716 // <Section ovf:required="false" xsi:type="ovf:ProductSection_Type">
717 pelmAnnotationSection = pelmVirtualSystem->createChild("Section");
718 pelmAnnotationSection->setAttribute("xsi:type", "ovf:ProductSection_Type");
719 }
720 else
721 pelmAnnotationSection = pelmVirtualSystem->createChild("ProductSection");
722
723 pelmAnnotationSection->createChild("Info")->addContent("Meta-information about the installed software");
724 if (fProduct)
725 pelmAnnotationSection->createChild("Product")->addContent(llProduct.front()->strVboxCurrent);
726 if (fVendor)
727 pelmAnnotationSection->createChild("Vendor")->addContent(llVendor.front()->strVboxCurrent);
728 if (fVersion)
729 pelmAnnotationSection->createChild("Version")->addContent(llVersion.front()->strVboxCurrent);
730 if (fProductUrl)
731 pelmAnnotationSection->createChild("ProductUrl")->addContent(llProductUrl.front()->strVboxCurrent);
732 if (fVendorUrl)
733 pelmAnnotationSection->createChild("VendorUrl")->addContent(llVendorUrl.front()->strVboxCurrent);
734 }
735
736 // description
737 std::list<VirtualSystemDescriptionEntry*> llDescription = vsdescThis->findByType(VirtualSystemDescriptionType_Description);
738 if (llDescription.size() &&
739 !llDescription.front()->strVboxCurrent.isEmpty())
740 {
741 /* <Section ovf:required="false" xsi:type="ovf:AnnotationSection_Type">
742 <Info>A human-readable annotation</Info>
743 <Annotation>Plan 9</Annotation>
744 </Section> */
745 xml::ElementNode *pelmAnnotationSection;
746 if (enFormat == OVF_0_9)
747 {
748 // <Section ovf:required="false" xsi:type="ovf:AnnotationSection_Type">
749 pelmAnnotationSection = pelmVirtualSystem->createChild("Section");
750 pelmAnnotationSection->setAttribute("xsi:type", "ovf:AnnotationSection_Type");
751 }
752 else
753 pelmAnnotationSection = pelmVirtualSystem->createChild("AnnotationSection");
754
755 pelmAnnotationSection->createChild("Info")->addContent("A human-readable annotation");
756 pelmAnnotationSection->createChild("Annotation")->addContent(llDescription.front()->strVboxCurrent);
757 }
758
759 // license
760 std::list<VirtualSystemDescriptionEntry*> llLicense = vsdescThis->findByType(VirtualSystemDescriptionType_License);
761 if (llLicense.size() &&
762 !llLicense.front()->strVboxCurrent.isEmpty())
763 {
764 /* <EulaSection>
765 <Info ovf:msgid="6">License agreement for the Virtual System.</Info>
766 <License ovf:msgid="1">License terms can go in here.</License>
767 </EulaSection> */
768 xml::ElementNode *pelmEulaSection;
769 if (enFormat == OVF_0_9)
770 {
771 pelmEulaSection = pelmVirtualSystem->createChild("Section");
772 pelmEulaSection->setAttribute("xsi:type", "ovf:EulaSection_Type");
773 }
774 else
775 pelmEulaSection = pelmVirtualSystem->createChild("EulaSection");
776
777 pelmEulaSection->createChild("Info")->addContent("License agreement for the virtual system");
778 pelmEulaSection->createChild("License")->addContent(llLicense.front()->strVboxCurrent);
779 }
780
781 // operating system
782 std::list<VirtualSystemDescriptionEntry*> llOS = vsdescThis->findByType(VirtualSystemDescriptionType_OS);
783 if (llOS.size() != 1)
784 throw setError(VBOX_E_NOT_SUPPORTED,
785 tr("Missing OS type"));
786 /* <OperatingSystemSection ovf:id="82">
787 <Info>Guest Operating System</Info>
788 <Description>Linux 2.6.x</Description>
789 </OperatingSystemSection> */
790 xml::ElementNode *pelmOperatingSystemSection;
791 if (enFormat == OVF_0_9)
792 {
793 pelmOperatingSystemSection = pelmVirtualSystem->createChild("Section");
794 pelmOperatingSystemSection->setAttribute("xsi:type", "ovf:OperatingSystemSection_Type");
795 }
796 else
797 pelmOperatingSystemSection = pelmVirtualSystem->createChild("OperatingSystemSection");
798
799 pelmOperatingSystemSection->setAttribute("ovf:id", llOS.front()->strOvf);
800 pelmOperatingSystemSection->createChild("Info")->addContent("The kind of installed guest operating system");
801 Utf8Str strOSDesc;
802 convertCIMOSType2VBoxOSType(strOSDesc, (ovf::CIMOSType_T)llOS.front()->strOvf.toInt32(), "");
803 pelmOperatingSystemSection->createChild("Description")->addContent(strOSDesc);
804
805 // <VirtualHardwareSection ovf:id="hw1" ovf:transport="iso">
806 xml::ElementNode *pelmVirtualHardwareSection;
807 if (enFormat == OVF_0_9)
808 {
809 // <Section xsi:type="ovf:VirtualHardwareSection_Type">
810 pelmVirtualHardwareSection = pelmVirtualSystem->createChild("Section");
811 pelmVirtualHardwareSection->setAttribute("xsi:type", "ovf:VirtualHardwareSection_Type");
812 }
813 else
814 pelmVirtualHardwareSection = pelmVirtualSystem->createChild("VirtualHardwareSection");
815
816 pelmVirtualHardwareSection->createChild("Info")->addContent("Virtual hardware requirements for a virtual machine");
817
818 /* <System>
819 <vssd:Description>Description of the virtual hardware section.</vssd:Description>
820 <vssd:ElementName>vmware</vssd:ElementName>
821 <vssd:InstanceID>1</vssd:InstanceID>
822 <vssd:VirtualSystemIdentifier>MyLampService</vssd:VirtualSystemIdentifier>
823 <vssd:VirtualSystemType>vmx-4</vssd:VirtualSystemType>
824 </System> */
825 xml::ElementNode *pelmSystem = pelmVirtualHardwareSection->createChild("System");
826
827 pelmSystem->createChild("vssd:ElementName")->addContent("Virtual Hardware Family"); // required OVF 1.0
828
829 // <vssd:InstanceId>0</vssd:InstanceId>
830 if (enFormat == OVF_0_9)
831 pelmSystem->createChild("vssd:InstanceId")->addContent("0");
832 else // capitalization changed...
833 pelmSystem->createChild("vssd:InstanceID")->addContent("0");
834
835 // <vssd:VirtualSystemIdentifier>VAtest</vssd:VirtualSystemIdentifier>
836 pelmSystem->createChild("vssd:VirtualSystemIdentifier")->addContent(strVMName);
837 // <vssd:VirtualSystemType>vmx-4</vssd:VirtualSystemType>
838 const char *pcszHardware = "virtualbox-2.2";
839 if (enFormat == OVF_0_9)
840 // pretend to be vmware compatible then
841 pcszHardware = "vmx-6";
842 pelmSystem->createChild("vssd:VirtualSystemType")->addContent(pcszHardware);
843
844 // loop thru all description entries twice; once to write out all
845 // devices _except_ disk images, and a second time to assign the
846 // disk images; this is because disk images need to reference
847 // IDE controllers, and we can't know their instance IDs without
848 // assigning them first
849
850 uint32_t idIDEPrimaryController = 0;
851 int32_t lIDEPrimaryControllerIndex = 0;
852 uint32_t idIDESecondaryController = 0;
853 int32_t lIDESecondaryControllerIndex = 0;
854 uint32_t idSATAController = 0;
855 int32_t lSATAControllerIndex = 0;
856 uint32_t idSCSIController = 0;
857 int32_t lSCSIControllerIndex = 0;
858
859 uint32_t ulInstanceID = 1;
860
861 for (size_t uLoop = 1; uLoop <= 2; ++uLoop)
862 {
863 int32_t lIndexThis = 0;
864 list<VirtualSystemDescriptionEntry>::const_iterator itD;
865 for (itD = vsdescThis->m->llDescriptions.begin();
866 itD != vsdescThis->m->llDescriptions.end();
867 ++itD, ++lIndexThis)
868 {
869 const VirtualSystemDescriptionEntry &desc = *itD;
870
871 LogFlowFunc(("Loop %u: handling description entry ulIndex=%u, type=%s, strRef=%s, strOvf=%s, strVbox=%s, strExtraConfig=%s\n",
872 uLoop,
873 desc.ulIndex,
874 ( desc.type == VirtualSystemDescriptionType_HardDiskControllerIDE ? "HardDiskControllerIDE"
875 : desc.type == VirtualSystemDescriptionType_HardDiskControllerSATA ? "HardDiskControllerSATA"
876 : desc.type == VirtualSystemDescriptionType_HardDiskControllerSCSI ? "HardDiskControllerSCSI"
877 : desc.type == VirtualSystemDescriptionType_HardDiskImage ? "HardDiskImage"
878 : Utf8StrFmt("%d", desc.type).c_str()),
879 desc.strRef.c_str(),
880 desc.strOvf.c_str(),
881 desc.strVboxCurrent.c_str(),
882 desc.strExtraConfigCurrent.c_str()));
883
884 ovf::ResourceType_T type = (ovf::ResourceType_T)0; // if this becomes != 0 then we do stuff
885 Utf8Str strResourceSubType;
886
887 Utf8Str strDescription; // results in <rasd:Description>...</rasd:Description> block
888 Utf8Str strCaption; // results in <rasd:Caption>...</rasd:Caption> block
889
890 uint32_t ulParent = 0;
891
892 int32_t lVirtualQuantity = -1;
893 Utf8Str strAllocationUnits;
894
895 int32_t lAddress = -1;
896 int32_t lBusNumber = -1;
897 int32_t lAddressOnParent = -1;
898
899 int32_t lAutomaticAllocation = -1; // 0 means "false", 1 means "true"
900 Utf8Str strConnection; // results in <rasd:Connection>...</rasd:Connection> block
901 Utf8Str strHostResource;
902
903 uint64_t uTemp;
904
905 switch (desc.type)
906 {
907 case VirtualSystemDescriptionType_CPU:
908 /* <Item>
909 <rasd:Caption>1 virtual CPU</rasd:Caption>
910 <rasd:Description>Number of virtual CPUs</rasd:Description>
911 <rasd:ElementName>virtual CPU</rasd:ElementName>
912 <rasd:InstanceID>1</rasd:InstanceID>
913 <rasd:ResourceType>3</rasd:ResourceType>
914 <rasd:VirtualQuantity>1</rasd:VirtualQuantity>
915 </Item> */
916 if (uLoop == 1)
917 {
918 strDescription = "Number of virtual CPUs";
919 type = ovf::ResourceType_Processor; // 3
920 desc.strVboxCurrent.toInt(uTemp);
921 lVirtualQuantity = (int32_t)uTemp;
922 strCaption = Utf8StrFmt("%d virtual CPU", lVirtualQuantity); // without this ovftool won't eat the item
923 }
924 break;
925
926 case VirtualSystemDescriptionType_Memory:
927 /* <Item>
928 <rasd:AllocationUnits>MegaBytes</rasd:AllocationUnits>
929 <rasd:Caption>256 MB of memory</rasd:Caption>
930 <rasd:Description>Memory Size</rasd:Description>
931 <rasd:ElementName>Memory</rasd:ElementName>
932 <rasd:InstanceID>2</rasd:InstanceID>
933 <rasd:ResourceType>4</rasd:ResourceType>
934 <rasd:VirtualQuantity>256</rasd:VirtualQuantity>
935 </Item> */
936 if (uLoop == 1)
937 {
938 strDescription = "Memory Size";
939 type = ovf::ResourceType_Memory; // 4
940 desc.strVboxCurrent.toInt(uTemp);
941 lVirtualQuantity = (int32_t)(uTemp / _1M);
942 strAllocationUnits = "MegaBytes";
943 strCaption = Utf8StrFmt("%d MB of memory", lVirtualQuantity); // without this ovftool won't eat the item
944 }
945 break;
946
947 case VirtualSystemDescriptionType_HardDiskControllerIDE:
948 /* <Item>
949 <rasd:Caption>ideController1</rasd:Caption>
950 <rasd:Description>IDE Controller</rasd:Description>
951 <rasd:InstanceId>5</rasd:InstanceId>
952 <rasd:ResourceType>5</rasd:ResourceType>
953 <rasd:Address>1</rasd:Address>
954 <rasd:BusNumber>1</rasd:BusNumber>
955 </Item> */
956 if (uLoop == 1)
957 {
958 strDescription = "IDE Controller";
959 type = ovf::ResourceType_IDEController; // 5
960 strResourceSubType = desc.strVboxCurrent;
961
962 if (!lIDEPrimaryControllerIndex)
963 {
964 // first IDE controller:
965 strCaption = "ideController0";
966 lAddress = 0;
967 lBusNumber = 0;
968 // remember this ID
969 idIDEPrimaryController = ulInstanceID;
970 lIDEPrimaryControllerIndex = lIndexThis;
971 }
972 else
973 {
974 // second IDE controller:
975 strCaption = "ideController1";
976 lAddress = 1;
977 lBusNumber = 1;
978 // remember this ID
979 idIDESecondaryController = ulInstanceID;
980 lIDESecondaryControllerIndex = lIndexThis;
981 }
982 }
983 break;
984
985 case VirtualSystemDescriptionType_HardDiskControllerSATA:
986 /* <Item>
987 <rasd:Caption>sataController0</rasd:Caption>
988 <rasd:Description>SATA Controller</rasd:Description>
989 <rasd:InstanceId>4</rasd:InstanceId>
990 <rasd:ResourceType>20</rasd:ResourceType>
991 <rasd:ResourceSubType>ahci</rasd:ResourceSubType>
992 <rasd:Address>0</rasd:Address>
993 <rasd:BusNumber>0</rasd:BusNumber>
994 </Item>
995 */
996 if (uLoop == 1)
997 {
998 strDescription = "SATA Controller";
999 strCaption = "sataController0";
1000 type = ovf::ResourceType_OtherStorageDevice; // 20
1001 // it seems that OVFTool always writes these two, and since we can only
1002 // have one SATA controller, we'll use this as well
1003 lAddress = 0;
1004 lBusNumber = 0;
1005
1006 if ( desc.strVboxCurrent.isEmpty() // AHCI is the default in VirtualBox
1007 || (!desc.strVboxCurrent.compare("ahci", Utf8Str::CaseInsensitive))
1008 )
1009 strResourceSubType = "AHCI";
1010 else
1011 throw setError(VBOX_E_NOT_SUPPORTED,
1012 tr("Invalid config string \"%s\" in SATA controller"), desc.strVboxCurrent.c_str());
1013
1014 // remember this ID
1015 idSATAController = ulInstanceID;
1016 lSATAControllerIndex = lIndexThis;
1017 }
1018 break;
1019
1020 case VirtualSystemDescriptionType_HardDiskControllerSCSI:
1021 /* <Item>
1022 <rasd:Caption>scsiController0</rasd:Caption>
1023 <rasd:Description>SCSI Controller</rasd:Description>
1024 <rasd:InstanceId>4</rasd:InstanceId>
1025 <rasd:ResourceType>6</rasd:ResourceType>
1026 <rasd:ResourceSubType>buslogic</rasd:ResourceSubType>
1027 <rasd:Address>0</rasd:Address>
1028 <rasd:BusNumber>0</rasd:BusNumber>
1029 </Item>
1030 */
1031 if (uLoop == 1)
1032 {
1033 strDescription = "SCSI Controller";
1034 strCaption = "scsiController0";
1035 type = ovf::ResourceType_ParallelSCSIHBA; // 6
1036 // it seems that OVFTool always writes these two, and since we can only
1037 // have one SATA controller, we'll use this as well
1038 lAddress = 0;
1039 lBusNumber = 0;
1040
1041 if ( desc.strVboxCurrent.isEmpty() // LsiLogic is the default in VirtualBox
1042 || (!desc.strVboxCurrent.compare("lsilogic", Utf8Str::CaseInsensitive))
1043 )
1044 strResourceSubType = "lsilogic";
1045 else if (!desc.strVboxCurrent.compare("buslogic", Utf8Str::CaseInsensitive))
1046 strResourceSubType = "buslogic";
1047 else if (!desc.strVboxCurrent.compare("lsilogicsas", Utf8Str::CaseInsensitive))
1048 strResourceSubType = "lsilogicsas";
1049 else
1050 throw setError(VBOX_E_NOT_SUPPORTED,
1051 tr("Invalid config string \"%s\" in SCSI controller"), desc.strVboxCurrent.c_str());
1052
1053 // remember this ID
1054 idSCSIController = ulInstanceID;
1055 lSCSIControllerIndex = lIndexThis;
1056 }
1057 break;
1058
1059 case VirtualSystemDescriptionType_HardDiskImage:
1060 /* <Item>
1061 <rasd:Caption>disk1</rasd:Caption>
1062 <rasd:InstanceId>8</rasd:InstanceId>
1063 <rasd:ResourceType>17</rasd:ResourceType>
1064 <rasd:HostResource>/disk/vmdisk1</rasd:HostResource>
1065 <rasd:Parent>4</rasd:Parent>
1066 <rasd:AddressOnParent>0</rasd:AddressOnParent>
1067 </Item> */
1068 if (uLoop == 2)
1069 {
1070 uint32_t cDisks = stack.mapDisks.size();
1071 Utf8Str strDiskID = Utf8StrFmt("vmdisk%RI32", ++cDisks);
1072
1073 strDescription = "Disk Image";
1074 strCaption = Utf8StrFmt("disk%RI32", cDisks); // this is not used for anything else
1075 type = ovf::ResourceType_HardDisk; // 17
1076
1077 // the following references the "<Disks>" XML block
1078 strHostResource = Utf8StrFmt("/disk/%s", strDiskID.c_str());
1079
1080 // controller=<index>;channel=<c>
1081 size_t pos1 = desc.strExtraConfigCurrent.find("controller=");
1082 size_t pos2 = desc.strExtraConfigCurrent.find("channel=");
1083 int32_t lControllerIndex = -1;
1084 if (pos1 != Utf8Str::npos)
1085 {
1086 RTStrToInt32Ex(desc.strExtraConfigCurrent.c_str() + pos1 + 11, NULL, 0, &lControllerIndex);
1087 if (lControllerIndex == lIDEPrimaryControllerIndex)
1088 ulParent = idIDEPrimaryController;
1089 else if (lControllerIndex == lIDESecondaryControllerIndex)
1090 ulParent = idIDESecondaryController;
1091 else if (lControllerIndex == lSCSIControllerIndex)
1092 ulParent = idSCSIController;
1093 else if (lControllerIndex == lSATAControllerIndex)
1094 ulParent = idSATAController;
1095 }
1096 if (pos2 != Utf8Str::npos)
1097 RTStrToInt32Ex(desc.strExtraConfigCurrent.c_str() + pos2 + 8, NULL, 0, &lAddressOnParent);
1098
1099 LogFlowFunc(("HardDiskImage details: pos1=%d, pos2=%d, lControllerIndex=%d, lIDEPrimaryControllerIndex=%d, lIDESecondaryControllerIndex=%d, ulParent=%d, lAddressOnParent=%d\n",
1100 pos1, pos2, lControllerIndex, lIDEPrimaryControllerIndex, lIDESecondaryControllerIndex, ulParent, lAddressOnParent));
1101
1102 if ( !ulParent
1103 || lAddressOnParent == -1
1104 )
1105 throw setError(VBOX_E_NOT_SUPPORTED,
1106 tr("Missing or bad extra config string in hard disk image: \"%s\""), desc.strExtraConfigCurrent.c_str());
1107
1108 stack.mapDisks[strDiskID] = &desc;
1109 }
1110 break;
1111
1112 case VirtualSystemDescriptionType_Floppy:
1113 if (uLoop == 1)
1114 {
1115 strDescription = "Floppy Drive";
1116 strCaption = "floppy0"; // this is what OVFTool writes
1117 type = ovf::ResourceType_FloppyDrive; // 14
1118 lAutomaticAllocation = 0;
1119 lAddressOnParent = 0; // this is what OVFTool writes
1120 }
1121 break;
1122
1123 case VirtualSystemDescriptionType_CDROM:
1124 if (uLoop == 2)
1125 {
1126 // we can't have a CD without an IDE controller
1127 if (!idIDESecondaryController)
1128 throw setError(VBOX_E_NOT_SUPPORTED,
1129 tr("Can't have CD-ROM without secondary IDE controller"));
1130
1131 strDescription = "CD-ROM Drive";
1132 strCaption = "cdrom1"; // this is what OVFTool writes
1133 type = ovf::ResourceType_CDDrive; // 15
1134 lAutomaticAllocation = 1;
1135 ulParent = idIDESecondaryController;
1136 lAddressOnParent = 0; // this is what OVFTool writes
1137 }
1138 break;
1139
1140 case VirtualSystemDescriptionType_NetworkAdapter:
1141 /* <Item>
1142 <rasd:AutomaticAllocation>true</rasd:AutomaticAllocation>
1143 <rasd:Caption>Ethernet adapter on 'VM Network'</rasd:Caption>
1144 <rasd:Connection>VM Network</rasd:Connection>
1145 <rasd:ElementName>VM network</rasd:ElementName>
1146 <rasd:InstanceID>3</rasd:InstanceID>
1147 <rasd:ResourceType>10</rasd:ResourceType>
1148 </Item> */
1149 if (uLoop == 1)
1150 {
1151 lAutomaticAllocation = 1;
1152 strCaption = Utf8StrFmt("Ethernet adapter on '%s'", desc.strOvf.c_str());
1153 type = ovf::ResourceType_EthernetAdapter; // 10
1154 /* Set the hardware type to something useful.
1155 * To be compatible with vmware & others we set
1156 * PCNet32 for our PCNet types & E1000 for the
1157 * E1000 cards. */
1158 switch (desc.strVboxCurrent.toInt32())
1159 {
1160 case NetworkAdapterType_Am79C970A:
1161 case NetworkAdapterType_Am79C973: strResourceSubType = "PCNet32"; break;
1162#ifdef VBOX_WITH_E1000
1163 case NetworkAdapterType_I82540EM:
1164 case NetworkAdapterType_I82545EM:
1165 case NetworkAdapterType_I82543GC: strResourceSubType = "E1000"; break;
1166#endif /* VBOX_WITH_E1000 */
1167 }
1168 strConnection = desc.strOvf;
1169
1170 stack.mapNetworks[desc.strOvf] = true;
1171 }
1172 break;
1173
1174 case VirtualSystemDescriptionType_USBController:
1175 /* <Item ovf:required="false">
1176 <rasd:Caption>usb</rasd:Caption>
1177 <rasd:Description>USB Controller</rasd:Description>
1178 <rasd:InstanceId>3</rasd:InstanceId>
1179 <rasd:ResourceType>23</rasd:ResourceType>
1180 <rasd:Address>0</rasd:Address>
1181 <rasd:BusNumber>0</rasd:BusNumber>
1182 </Item> */
1183 if (uLoop == 1)
1184 {
1185 strDescription = "USB Controller";
1186 strCaption = "usb";
1187 type = ovf::ResourceType_USBController; // 23
1188 lAddress = 0; // this is what OVFTool writes
1189 lBusNumber = 0; // this is what OVFTool writes
1190 }
1191 break;
1192
1193 case VirtualSystemDescriptionType_SoundCard:
1194 /* <Item ovf:required="false">
1195 <rasd:Caption>sound</rasd:Caption>
1196 <rasd:Description>Sound Card</rasd:Description>
1197 <rasd:InstanceId>10</rasd:InstanceId>
1198 <rasd:ResourceType>35</rasd:ResourceType>
1199 <rasd:ResourceSubType>ensoniq1371</rasd:ResourceSubType>
1200 <rasd:AutomaticAllocation>false</rasd:AutomaticAllocation>
1201 <rasd:AddressOnParent>3</rasd:AddressOnParent>
1202 </Item> */
1203 if (uLoop == 1)
1204 {
1205 strDescription = "Sound Card";
1206 strCaption = "sound";
1207 type = ovf::ResourceType_SoundCard; // 35
1208 strResourceSubType = desc.strOvf; // e.g. ensoniq1371
1209 lAutomaticAllocation = 0;
1210 lAddressOnParent = 3; // what gives? this is what OVFTool writes
1211 }
1212 break;
1213 }
1214
1215 if (type)
1216 {
1217 xml::ElementNode *pItem;
1218
1219 pItem = pelmVirtualHardwareSection->createChild("Item");
1220
1221 // NOTE: DO NOT CHANGE THE ORDER of these items! The OVF standards prescribes that
1222 // the elements from the rasd: namespace must be sorted by letter, and VMware
1223 // actually requires this as well (see public bug #6612)
1224
1225 if (lAddress != -1)
1226 pItem->createChild("rasd:Address")->addContent(Utf8StrFmt("%d", lAddress));
1227
1228 if (lAddressOnParent != -1)
1229 pItem->createChild("rasd:AddressOnParent")->addContent(Utf8StrFmt("%d", lAddressOnParent));
1230
1231 if (!strAllocationUnits.isEmpty())
1232 pItem->createChild("rasd:AllocationUnits")->addContent(strAllocationUnits);
1233
1234 if (lAutomaticAllocation != -1)
1235 pItem->createChild("rasd:AutomaticAllocation")->addContent( (lAutomaticAllocation) ? "true" : "false" );
1236
1237 if (lBusNumber != -1)
1238 if (enFormat == OVF_0_9) // BusNumber is invalid OVF 1.0 so only write it in 0.9 mode for OVFTool compatibility
1239 pItem->createChild("rasd:BusNumber")->addContent(Utf8StrFmt("%d", lBusNumber));
1240
1241 if (!strCaption.isEmpty())
1242 pItem->createChild("rasd:Caption")->addContent(strCaption);
1243
1244 if (!strConnection.isEmpty())
1245 pItem->createChild("rasd:Connection")->addContent(strConnection);
1246
1247 if (!strDescription.isEmpty())
1248 pItem->createChild("rasd:Description")->addContent(strDescription);
1249
1250 if (!strCaption.isEmpty())
1251 if (enFormat == OVF_1_0)
1252 pItem->createChild("rasd:ElementName")->addContent(strCaption);
1253
1254 if (!strHostResource.isEmpty())
1255 pItem->createChild("rasd:HostResource")->addContent(strHostResource);
1256
1257 // <rasd:InstanceID>1</rasd:InstanceID>
1258 xml::ElementNode *pelmInstanceID;
1259 if (enFormat == OVF_0_9)
1260 pelmInstanceID = pItem->createChild("rasd:InstanceId");
1261 else
1262 pelmInstanceID = pItem->createChild("rasd:InstanceID"); // capitalization changed...
1263 pelmInstanceID->addContent(Utf8StrFmt("%d", ulInstanceID++));
1264
1265 if (ulParent)
1266 pItem->createChild("rasd:Parent")->addContent(Utf8StrFmt("%d", ulParent));
1267
1268 if (!strResourceSubType.isEmpty())
1269 pItem->createChild("rasd:ResourceSubType")->addContent(strResourceSubType);
1270
1271 // <rasd:ResourceType>3</rasd:ResourceType>
1272 pItem->createChild("rasd:ResourceType")->addContent(Utf8StrFmt("%d", type));
1273
1274 // <rasd:VirtualQuantity>1</rasd:VirtualQuantity>
1275 if (lVirtualQuantity != -1)
1276 pItem->createChild("rasd:VirtualQuantity")->addContent(Utf8StrFmt("%d", lVirtualQuantity));
1277 }
1278 }
1279 } // for (size_t uLoop = 1; uLoop <= 2; ++uLoop)
1280
1281 // now that we're done with the official OVF <Item> tags under <VirtualSystem>, write out VirtualBox XML
1282 // under the vbox: namespace
1283 xml::ElementNode *pelmVBoxMachine = pelmVirtualSystem->createChild("vbox:Machine");
1284 // ovf:required="false" tells other OVF parsers that they can ignore this thing
1285 pelmVBoxMachine->setAttribute("ovf:required", "false");
1286 // ovf:Info element is required or VMware will bail out on the vbox:Machine element
1287 pelmVBoxMachine->createChild("ovf:Info")->addContent("Complete VirtualBox machine configuration in VirtualBox format");
1288
1289 // create an empty machine config
1290 settings::MachineConfigFile *pConfig = new settings::MachineConfigFile(NULL);
1291
1292 try
1293 {
1294 AutoWriteLock machineLock(vsdescThis->m->pMachine COMMA_LOCKVAL_SRC_POS);
1295 // fill the machine config
1296 vsdescThis->m->pMachine->copyMachineDataToSettings(*pConfig);
1297 // write the machine config to the vbox:Machine element
1298 pConfig->buildMachineXML(*pelmVBoxMachine,
1299 settings::MachineConfigFile::BuildMachineXML_WriteVboxVersionAttribute
1300 | settings::MachineConfigFile::BuildMachineXML_SkipRemovableMedia,
1301 // but not BuildMachineXML_IncludeSnapshots
1302 pllElementsWithUuidAttributes);
1303 delete pConfig;
1304 }
1305 catch (...)
1306 {
1307 delete pConfig;
1308 throw;
1309 }
1310}
1311
1312/**
1313 * Actual worker code for writing out OVF to disk. This is called from Appliance::taskThreadWriteOVF()
1314 * and therefore runs on the OVF write worker thread. This runs in two contexts:
1315 *
1316 * 1) in a first worker thread; in that case, Appliance::Write() called Appliance::writeImpl();
1317 *
1318 * 2) in a second worker thread; in that case, Appliance::Write() called Appliance::writeImpl(), which
1319 * called Appliance::writeS3(), which called Appliance::writeImpl(), which then called this. In other
1320 * words, to write to the cloud, the first worker thread first starts a second worker thread to create
1321 * temporary files and then uploads them to the S3 cloud server.
1322 *
1323 * @param pTask
1324 * @return
1325 */
1326HRESULT Appliance::writeFS(const LocationInfo &locInfo, const OVFFormat enFormat, ComObjPtr<Progress> &pProgress)
1327{
1328 LogFlowFunc(("ENTER appliance %p\n", this));
1329
1330 AutoCaller autoCaller(this);
1331 if (FAILED(autoCaller.rc())) return autoCaller.rc();
1332
1333 HRESULT rc = S_OK;
1334
1335 try
1336 {
1337 AutoMultiWriteLock2 multiLock(&mVirtualBox->getMediaTreeLockHandle(), this->lockHandle() COMMA_LOCKVAL_SRC_POS);
1338
1339 xml::Document doc;
1340 xml::ElementNode *pelmRoot = doc.createRootElement("Envelope");
1341
1342 pelmRoot->setAttribute("ovf:version", (enFormat == OVF_1_0) ? "1.0" : "0.9");
1343 pelmRoot->setAttribute("xml:lang", "en-US");
1344
1345 Utf8Str strNamespace = (enFormat == OVF_0_9)
1346 ? "http://www.vmware.com/schema/ovf/1/envelope" // 0.9
1347 : "http://schemas.dmtf.org/ovf/envelope/1"; // 1.0
1348 pelmRoot->setAttribute("xmlns", strNamespace);
1349 pelmRoot->setAttribute("xmlns:ovf", strNamespace);
1350
1351// pelmRoot->setAttribute("xmlns:ovfstr", "http://schema.dmtf.org/ovf/strings/1");
1352 pelmRoot->setAttribute("xmlns:rasd", "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData");
1353 pelmRoot->setAttribute("xmlns:vssd", "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData");
1354 pelmRoot->setAttribute("xmlns:xsi", "http://www.w3.org/2001/XMLSchema-instance");
1355 pelmRoot->setAttribute("xmlns:vbox", "http://www.virtualbox.org/ovf/machine");
1356// pelmRoot->setAttribute("xsi:schemaLocation", "http://schemas.dmtf.org/ovf/envelope/1 ../ovf-envelope.xsd");
1357
1358 // <Envelope>/<References>
1359 xml::ElementNode *pelmReferences = pelmRoot->createChild("References"); // 0.9 and 1.0
1360
1361 /* <Envelope>/<DiskSection>:
1362 <DiskSection>
1363 <Info>List of the virtual disks used in the package</Info>
1364 <Disk ovf:capacity="4294967296" ovf:diskId="lamp" ovf:format="..." ovf:populatedSize="1924967692"/>
1365 </DiskSection> */
1366 xml::ElementNode *pelmDiskSection;
1367 if (enFormat == OVF_0_9)
1368 {
1369 // <Section xsi:type="ovf:DiskSection_Type">
1370 pelmDiskSection = pelmRoot->createChild("Section");
1371 pelmDiskSection->setAttribute("xsi:type", "ovf:DiskSection_Type");
1372 }
1373 else
1374 pelmDiskSection = pelmRoot->createChild("DiskSection");
1375
1376 xml::ElementNode *pelmDiskSectionInfo = pelmDiskSection->createChild("Info");
1377 pelmDiskSectionInfo->addContent("List of the virtual disks used in the package");
1378
1379 // the XML stack contains two maps for disks and networks, which allows us to
1380 // a) have a list of unique disk names (to make sure the same disk name is only added once)
1381 // and b) keep a list of all networks
1382 XMLStack stack;
1383
1384 /* <Envelope>/<NetworkSection>:
1385 <NetworkSection>
1386 <Info>Logical networks used in the package</Info>
1387 <Network ovf:name="VM Network">
1388 <Description>The network that the LAMP Service will be available on</Description>
1389 </Network>
1390 </NetworkSection> */
1391 xml::ElementNode *pelmNetworkSection;
1392 if (enFormat == OVF_0_9)
1393 {
1394 // <Section xsi:type="ovf:NetworkSection_Type">
1395 pelmNetworkSection = pelmRoot->createChild("Section");
1396 pelmNetworkSection->setAttribute("xsi:type", "ovf:NetworkSection_Type");
1397 }
1398 else
1399 pelmNetworkSection = pelmRoot->createChild("NetworkSection");
1400
1401 xml::ElementNode *pelmNetworkSectionInfo = pelmNetworkSection->createChild("Info");
1402 pelmNetworkSectionInfo->addContent("Logical networks used in the package");
1403
1404 // and here come the virtual systems:
1405
1406 // This can take a very long time so leave the locks; in particular, we have the media tree
1407 // lock which Medium::CloneTo() will request, and that would deadlock. Instead, protect
1408 // the appliance by resetting its state so we can safely leave the lock
1409 m->state = Data::ApplianceExporting;
1410 multiLock.release();
1411
1412 // write a collection if we have more than one virtual system _and_ we're
1413 // writing OVF 1.0; otherwise fail since ovftool can't import more than
1414 // one machine, it seems
1415 xml::ElementNode *pelmToAddVirtualSystemsTo;
1416 if (m->virtualSystemDescriptions.size() > 1)
1417 {
1418 if (enFormat == OVF_0_9)
1419 throw setError(VBOX_E_FILE_ERROR,
1420 tr("Cannot export more than one virtual system with OVF 0.9, use OVF 1.0"));
1421
1422 pelmToAddVirtualSystemsTo = pelmRoot->createChild("VirtualSystemCollection");
1423 pelmToAddVirtualSystemsTo->setAttribute("ovf:name", "ExportedVirtualBoxMachines"); // whatever
1424 }
1425 else
1426 pelmToAddVirtualSystemsTo = pelmRoot; // add virtual system directly under root element
1427
1428 // this list receives pointers to the XML elements in the machine XML which
1429 // might have UUIDs that need fixing after we know the UUIDs of the exported images
1430 std::list<xml::ElementNode*> llElementsWithUuidAttributes;
1431
1432 list< ComObjPtr<VirtualSystemDescription> >::const_iterator it;
1433 /* Iterate throughs all virtual systems of that appliance */
1434 for (it = m->virtualSystemDescriptions.begin();
1435 it != m->virtualSystemDescriptions.end();
1436 ++it)
1437 {
1438 ComObjPtr<VirtualSystemDescription> vsdescThis = *it;
1439 buildXMLForOneVirtualSystem(*pelmToAddVirtualSystemsTo,
1440 &llElementsWithUuidAttributes,
1441 vsdescThis,
1442 enFormat,
1443 stack); // disks and networks stack
1444 }
1445
1446 // now, fill in the network section we set up empty above according
1447 // to the networks we found with the hardware items
1448 map<Utf8Str, bool>::const_iterator itN;
1449 for (itN = stack.mapNetworks.begin();
1450 itN != stack.mapNetworks.end();
1451 ++itN)
1452 {
1453 const Utf8Str &strNetwork = itN->first;
1454 xml::ElementNode *pelmNetwork = pelmNetworkSection->createChild("Network");
1455 pelmNetwork->setAttribute("ovf:name", strNetwork.c_str());
1456 pelmNetwork->createChild("Description")->addContent("Logical network used by this appliance.");
1457 }
1458
1459 // Finally, write out the disks!
1460
1461 list<Utf8Str> diskList;
1462 map<Utf8Str, const VirtualSystemDescriptionEntry*>::const_iterator itS;
1463 uint32_t ulFile = 1;
1464 for (itS = stack.mapDisks.begin();
1465 itS != stack.mapDisks.end();
1466 ++itS)
1467 {
1468 const Utf8Str &strDiskID = itS->first;
1469 const VirtualSystemDescriptionEntry *pDiskEntry = itS->second;
1470
1471 // source path: where the VBox image is
1472 const Utf8Str &strSrcFilePath = pDiskEntry->strVboxCurrent;
1473 Bstr bstrSrcFilePath(strSrcFilePath);
1474 if (!RTPathExists(strSrcFilePath.c_str()))
1475 /* This isn't allowed */
1476 throw setError(VBOX_E_FILE_ERROR,
1477 tr("Source virtual disk image file '%s' doesn't exist"),
1478 strSrcFilePath.c_str());
1479
1480 // clone the disk:
1481 ComPtr<IMedium> pSourceDisk;
1482 ComPtr<IMedium> pTargetDisk;
1483 ComPtr<IProgress> pProgress2;
1484
1485 Log(("Finding source disk \"%ls\"\n", bstrSrcFilePath.raw()));
1486 rc = mVirtualBox->FindHardDisk(bstrSrcFilePath, pSourceDisk.asOutParam());
1487 if (FAILED(rc)) throw rc;
1488
1489 Bstr uuidSource;
1490 rc = pSourceDisk->COMGETTER(Id)(uuidSource.asOutParam());
1491 if (FAILED(rc)) throw rc;
1492 Guid guidSource(uuidSource);
1493
1494 // output filename
1495 const Utf8Str &strTargetFileNameOnly = pDiskEntry->strOvf;
1496 // target path needs to be composed from where the output OVF is
1497 Utf8Str strTargetFilePath(locInfo.strPath);
1498 strTargetFilePath.stripFilename();
1499 strTargetFilePath.append("/");
1500 strTargetFilePath.append(strTargetFileNameOnly);
1501
1502 // We are always exporting to VMDK stream optimized for now
1503 Bstr bstrSrcFormat = L"VMDK";
1504
1505 // create a new hard disk interface for the destination disk image
1506 Log(("Creating target disk \"%s\"\n", strTargetFilePath.raw()));
1507 rc = mVirtualBox->CreateHardDisk(bstrSrcFormat, Bstr(strTargetFilePath), pTargetDisk.asOutParam());
1508 if (FAILED(rc)) throw rc;
1509
1510 // the target disk is now registered and needs to be removed again,
1511 // both after successful cloning or if anything goes bad!
1512 try
1513 {
1514 // create a flat copy of the source disk image
1515 rc = pSourceDisk->CloneTo(pTargetDisk, MediumVariant_VmdkStreamOptimized, NULL, pProgress2.asOutParam());
1516 if (FAILED(rc)) throw rc;
1517
1518 // advance to the next operation
1519 pProgress->SetNextOperation(BstrFmt(tr("Exporting to disk image '%s'"), strTargetFilePath.c_str()),
1520 pDiskEntry->ulSizeMB); // operation's weight, as set up with the IProgress originally);
1521
1522 // now wait for the background disk operation to complete; this throws HRESULTs on error
1523 waitForAsyncProgress(pProgress, pProgress2);
1524 }
1525 catch (HRESULT rc3)
1526 {
1527 // upon error after registering, close the disk or
1528 // it'll stick in the registry forever
1529 pTargetDisk->Close();
1530 throw rc3;
1531 }
1532 diskList.push_back(strTargetFilePath);
1533
1534 // we need the following for the XML
1535 ULONG64 cbFile = 0; // actual file size
1536 rc = pTargetDisk->COMGETTER(Size)(&cbFile);
1537 if (FAILED(rc)) throw rc;
1538
1539 ULONG64 cbCapacity = 0; // size reported to guest
1540 rc = pTargetDisk->COMGETTER(LogicalSize)(&cbCapacity);
1541 if (FAILED(rc)) throw rc;
1542 // capacity is reported in megabytes, so...
1543 cbCapacity *= _1M;
1544
1545 Bstr uuidTarget;
1546 rc = pTargetDisk->COMGETTER(Id)(uuidTarget.asOutParam());
1547 if (FAILED(rc)) throw rc;
1548 Guid guidTarget(uuidTarget);
1549
1550 // upon success, close the disk as well
1551 rc = pTargetDisk->Close();
1552 if (FAILED(rc)) throw rc;
1553
1554 // now handle the XML for the disk:
1555 Utf8StrFmt strFileRef("file%RI32", ulFile++);
1556 // <File ovf:href="WindowsXpProfessional-disk1.vmdk" ovf:id="file1" ovf:size="1710381056"/>
1557 xml::ElementNode *pelmFile = pelmReferences->createChild("File");
1558 pelmFile->setAttribute("ovf:href", strTargetFileNameOnly);
1559 pelmFile->setAttribute("ovf:id", strFileRef);
1560 pelmFile->setAttribute("ovf:size", Utf8StrFmt("%RI64", cbFile).c_str());
1561
1562 // add disk to XML Disks section
1563 // <Disk ovf:capacity="8589934592" ovf:diskId="vmdisk1" ovf:fileRef="file1" ovf:format="..."/>
1564 xml::ElementNode *pelmDisk = pelmDiskSection->createChild("Disk");
1565 pelmDisk->setAttribute("ovf:capacity", Utf8StrFmt("%RI64", cbCapacity).c_str());
1566 pelmDisk->setAttribute("ovf:diskId", strDiskID);
1567 pelmDisk->setAttribute("ovf:fileRef", strFileRef);
1568 pelmDisk->setAttribute("ovf:format",
1569 (enFormat == OVF_0_9)
1570 ? "http://www.vmware.com/specifications/vmdk.html#sparse" // must be sparse or ovftool chokes
1571 : "http://www.vmware.com/interfaces/specifications/vmdk.html#streamOptimized"
1572 // correct string as communicated to us by VMware (public bug #6612)
1573 );
1574
1575 // add the UUID of the newly created target image to the OVF disk element, but in the
1576 // vbox: namespace since it's not part of the standard
1577 pelmDisk->setAttribute("vbox:uuid", Utf8StrFmt("%RTuuid", guidTarget.raw()).c_str());
1578
1579 // now, we might have other XML elements from vbox:Machine pointing to this image,
1580 // but those would refer to the UUID of the _source_ image (which we created the
1581 // export image from); those UUIDs need to be fixed to the export image
1582 for (std::list<xml::ElementNode*>::iterator eit = llElementsWithUuidAttributes.begin();
1583 eit != llElementsWithUuidAttributes.end();
1584 ++eit)
1585 {
1586 xml::ElementNode *pelmImage = *eit;
1587 // overwrite existing uuid attribute
1588 pelmImage->setAttribute("uuid", guidTarget.toStringCurly());
1589 }
1590 }
1591
1592 // now go write the XML
1593 xml::XmlFileWriter writer(doc);
1594 writer.write(locInfo.strPath.c_str(), false /*fSafe*/);
1595
1596 // Create & write the manifest file
1597 Utf8Str strMfFile = manifestFileName(locInfo.strPath.c_str());
1598 const char *pcszManifestFileOnly = RTPathFilename(strMfFile.c_str());
1599 pProgress->SetNextOperation(BstrFmt(tr("Creating manifest file '%s'"), pcszManifestFileOnly),
1600 m->ulWeightForManifestOperation); // operation's weight, as set up with the IProgress originally);
1601
1602 const char** ppManifestFiles = (const char**)RTMemAlloc(sizeof(char*)*diskList.size() + 1);
1603 ppManifestFiles[0] = locInfo.strPath.c_str();
1604 list<Utf8Str>::const_iterator it1;
1605 size_t i = 1;
1606 for (it1 = diskList.begin();
1607 it1 != diskList.end();
1608 ++it1, ++i)
1609 ppManifestFiles[i] = (*it1).c_str();
1610 int vrc = RTManifestWriteFiles(strMfFile.c_str(), ppManifestFiles, diskList.size()+1, NULL, NULL);
1611 RTMemFree(ppManifestFiles);
1612 if (RT_FAILURE(vrc))
1613 throw setError(VBOX_E_FILE_ERROR,
1614 tr("Could not create manifest file '%s' (%Rrc)"),
1615 pcszManifestFileOnly, vrc);
1616 }
1617 catch(xml::Error &x)
1618 {
1619 rc = setError(VBOX_E_FILE_ERROR,
1620 x.what());
1621 }
1622 catch(HRESULT aRC)
1623 {
1624 rc = aRC;
1625 }
1626
1627 AutoWriteLock appLock(this COMMA_LOCKVAL_SRC_POS);
1628 // reset the state so others can call methods again
1629 m->state = Data::ApplianceIdle;
1630
1631 LogFlowFunc(("rc=%Rhrc\n", rc));
1632 LogFlowFuncLeave();
1633
1634 return rc;
1635}
1636
1637/**
1638 * Worker code for writing out OVF to the cloud. This is called from Appliance::taskThreadWriteOVF()
1639 * in S3 mode and therefore runs on the OVF write worker thread. This then starts a second worker
1640 * thread to create temporary files (see Appliance::writeFS()).
1641 *
1642 * @param pTask
1643 * @return
1644 */
1645HRESULT Appliance::writeS3(TaskOVF *pTask)
1646{
1647 LogFlowFuncEnter();
1648 LogFlowFunc(("Appliance %p\n", this));
1649
1650 AutoCaller autoCaller(this);
1651 if (FAILED(autoCaller.rc())) return autoCaller.rc();
1652
1653 HRESULT rc = S_OK;
1654
1655 AutoWriteLock appLock(this COMMA_LOCKVAL_SRC_POS);
1656
1657 int vrc = VINF_SUCCESS;
1658 RTS3 hS3 = NIL_RTS3;
1659 char szOSTmpDir[RTPATH_MAX];
1660 RTPathTemp(szOSTmpDir, sizeof(szOSTmpDir));
1661 /* The template for the temporary directory created below */
1662 char *pszTmpDir;
1663 RTStrAPrintf(&pszTmpDir, "%s"RTPATH_SLASH_STR"vbox-ovf-XXXXXX", szOSTmpDir);
1664 list< pair<Utf8Str, ULONG> > filesList;
1665
1666 // todo:
1667 // - usable error codes
1668 // - seems snapshot filenames are problematic {uuid}.vdi
1669 try
1670 {
1671 /* Extract the bucket */
1672 Utf8Str tmpPath = pTask->locInfo.strPath;
1673 Utf8Str bucket;
1674 parseBucket(tmpPath, bucket);
1675
1676 /* We need a temporary directory which we can put the OVF file & all
1677 * disk images in */
1678 vrc = RTDirCreateTemp(pszTmpDir);
1679 if (RT_FAILURE(vrc))
1680 throw setError(VBOX_E_FILE_ERROR,
1681 tr("Cannot create temporary directory '%s'"), pszTmpDir);
1682
1683 /* The temporary name of the target OVF file */
1684 Utf8StrFmt strTmpOvf("%s/%s", pszTmpDir, RTPathFilename(tmpPath.c_str()));
1685
1686 /* Prepare the temporary writing of the OVF */
1687 ComObjPtr<Progress> progress;
1688 /* Create a temporary file based location info for the sub task */
1689 LocationInfo li;
1690 li.strPath = strTmpOvf;
1691 rc = writeImpl(pTask->enFormat, li, progress);
1692 if (FAILED(rc)) throw rc;
1693
1694 /* Unlock the appliance for the writing thread */
1695 appLock.release();
1696 /* Wait until the writing is done, but report the progress back to the
1697 caller */
1698 ComPtr<IProgress> progressInt(progress);
1699 waitForAsyncProgress(pTask->pProgress, progressInt); /* Any errors will be thrown */
1700
1701 /* Again lock the appliance for the next steps */
1702 appLock.acquire();
1703
1704 vrc = RTPathExists(strTmpOvf.c_str()); /* Paranoid check */
1705 if (RT_FAILURE(vrc))
1706 throw setError(VBOX_E_FILE_ERROR,
1707 tr("Cannot find source file '%s'"), strTmpOvf.c_str());
1708 /* Add the OVF file */
1709 filesList.push_back(pair<Utf8Str, ULONG>(strTmpOvf, m->ulWeightForXmlOperation)); /* Use 1% of the total for the OVF file upload */
1710 Utf8Str strMfFile = manifestFileName(strTmpOvf);
1711 filesList.push_back(pair<Utf8Str, ULONG>(strMfFile , m->ulWeightForXmlOperation)); /* Use 1% of the total for the manifest file upload */
1712
1713 /* Now add every disks of every virtual system */
1714 list< ComObjPtr<VirtualSystemDescription> >::const_iterator it;
1715 for (it = m->virtualSystemDescriptions.begin();
1716 it != m->virtualSystemDescriptions.end();
1717 ++it)
1718 {
1719 ComObjPtr<VirtualSystemDescription> vsdescThis = (*it);
1720 std::list<VirtualSystemDescriptionEntry*> avsdeHDs = vsdescThis->findByType(VirtualSystemDescriptionType_HardDiskImage);
1721 std::list<VirtualSystemDescriptionEntry*>::const_iterator itH;
1722 for (itH = avsdeHDs.begin();
1723 itH != avsdeHDs.end();
1724 ++itH)
1725 {
1726 const Utf8Str &strTargetFileNameOnly = (*itH)->strOvf;
1727 /* Target path needs to be composed from where the output OVF is */
1728 Utf8Str strTargetFilePath(strTmpOvf);
1729 strTargetFilePath.stripFilename();
1730 strTargetFilePath.append("/");
1731 strTargetFilePath.append(strTargetFileNameOnly);
1732 vrc = RTPathExists(strTargetFilePath.c_str()); /* Paranoid check */
1733 if (RT_FAILURE(vrc))
1734 throw setError(VBOX_E_FILE_ERROR,
1735 tr("Cannot find source file '%s'"), strTargetFilePath.c_str());
1736 filesList.push_back(pair<Utf8Str, ULONG>(strTargetFilePath, (*itH)->ulSizeMB));
1737 }
1738 }
1739 /* Next we have to upload the OVF & all disk images */
1740 vrc = RTS3Create(&hS3, pTask->locInfo.strUsername.c_str(), pTask->locInfo.strPassword.c_str(), pTask->locInfo.strHostname.c_str(), "virtualbox-agent/"VBOX_VERSION_STRING);
1741 if (RT_FAILURE(vrc))
1742 throw setError(VBOX_E_IPRT_ERROR,
1743 tr("Cannot create S3 service handler"));
1744 RTS3SetProgressCallback(hS3, pTask->updateProgress, &pTask);
1745
1746 /* Upload all files */
1747 for (list< pair<Utf8Str, ULONG> >::const_iterator it1 = filesList.begin(); it1 != filesList.end(); ++it1)
1748 {
1749 const pair<Utf8Str, ULONG> &s = (*it1);
1750 char *pszFilename = RTPathFilename(s.first.c_str());
1751 /* Advance to the next operation */
1752 pTask->pProgress->SetNextOperation(BstrFmt(tr("Uploading file '%s'"), pszFilename), s.second);
1753 vrc = RTS3PutKey(hS3, bucket.c_str(), pszFilename, s.first.c_str());
1754 if (RT_FAILURE(vrc))
1755 {
1756 if (vrc == VERR_S3_CANCELED)
1757 break;
1758 else if (vrc == VERR_S3_ACCESS_DENIED)
1759 throw setError(E_ACCESSDENIED,
1760 tr("Cannot upload file '%s' to S3 storage server (Access denied). Make sure that your credentials are right. Also check that your host clock is properly synced"), pszFilename);
1761 else if (vrc == VERR_S3_NOT_FOUND)
1762 throw setError(VBOX_E_FILE_ERROR,
1763 tr("Cannot upload file '%s' to S3 storage server (File not found)"), pszFilename);
1764 else
1765 throw setError(VBOX_E_IPRT_ERROR,
1766 tr("Cannot upload file '%s' to S3 storage server (%Rrc)"), pszFilename, vrc);
1767 }
1768 }
1769 }
1770 catch(HRESULT aRC)
1771 {
1772 rc = aRC;
1773 }
1774 /* Cleanup */
1775 RTS3Destroy(hS3);
1776 /* Delete all files which where temporary created */
1777 for (list< pair<Utf8Str, ULONG> >::const_iterator it1 = filesList.begin(); it1 != filesList.end(); ++it1)
1778 {
1779 const char *pszFilePath = (*it1).first.c_str();
1780 if (RTPathExists(pszFilePath))
1781 {
1782 vrc = RTFileDelete(pszFilePath);
1783 if (RT_FAILURE(vrc))
1784 rc = setError(VBOX_E_FILE_ERROR,
1785 tr("Cannot delete file '%s' (%Rrc)"), pszFilePath, vrc);
1786 }
1787 }
1788 /* Delete the temporary directory */
1789 if (RTPathExists(pszTmpDir))
1790 {
1791 vrc = RTDirRemove(pszTmpDir);
1792 if (RT_FAILURE(vrc))
1793 rc = setError(VBOX_E_FILE_ERROR,
1794 tr("Cannot delete temporary directory '%s' (%Rrc)"), pszTmpDir, vrc);
1795 }
1796 if (pszTmpDir)
1797 RTStrFree(pszTmpDir);
1798
1799 LogFlowFunc(("rc=%Rhrc\n", rc));
1800 LogFlowFuncLeave();
1801
1802 return rc;
1803}
1804
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette