Storing Golden Images on the NAS

Each time you have a new Golden Image, you need to store them in an appropriate NAS location.

Note

To store the golden images (all profiles in one language) you will need about 40Gb of disk space on the UForge NAS.

You can store your golden images in the NAS location of your choice, but will need to specify the full path when adding the golden to your UForge. We recommend you store the golden images in:

Base dir = Windows/releases/Server2012/x86_64/

The path is:

{Language}/{Edition}/{Type}/{generation date}(YYYY-MM-DD)/goldenImagePathCompressedInGz
Where
  • {Language} is one of English, French or Japanese
  • {Edition} corresponds to an official edition name such as Datacenter, Standard, Enterprise or Webserver
  • {Type} is Full or Core

So for example:

Windows/releases/Server2012/x86_64/English/Standard/Core/2015-10-19/Windows_2012_Standard_Core_2015-10-19.raw.gz

Note

If you plan to deploy generated Windows instances onto K5 Fujitsu Public Cloud, only “Standard” and “Enterprise” editions are supported.

For more detailed information, please refer to official Fujitsu K5 IaaS Documentation.

Adding a Golden Image to UForge AppCenter

Once you have your Golden Image, you need to add it to your UForge AppCenter in order to be able to use the Windows version to create appliance templates. Your golden image must be in one of the following formats:

  • raw.gz
  • raw.zip
  • raw.bz2
  • raw.lrz
  • vdi
  • vhd
  • vmdk

To add your Golden Image to UForge:

  1. Copy the image to:

    $ /tmp/DISTROS/Windows/releases/<windows os version>/x86_64/<language>/<Edition>/<Core|Full>/<YYYY-MM-DD>/golden.xxx

    For example: /tmp/DISTROS/Windows/releases/Server2012/x86_64/English/Standard/Core/2015-04-28/Windows_Server2012_English_Datacenter_Core_2015-04-28.raw.gz

    Note:

    • File and directory ownership should be tomcat:tomcat.
    • Permissions should be readable for all users
    • Disk name must be unique in the /tmp/DISTORS/Windows file tree

  2. You must ensure that the Windows distribution exists on your UForge AppCenter. If it does not, run:

    $ uforge org os add --name Windows --arch x86_64 --version Server2012

  3. In order to add the new golden image to the distribution, run:

    $ uforge org golden create --arch ARCH --edition EDITION --goldenDate GOLDENDATE --goldenPath GOLDENPATH --language LANGUAGE --type TYPE --name NAME --version VERSION --profileName PROFILENAME

    Where the following apply :

    • --edition Should be an official Microsoft Edition (Datacenter, Enterprise, Standard, Webserver)
    • --goldenDate The date of the golden image (YYYY-MM-DD). If the option is not present, will be set to the date the command is run
    • --goldenPath The full path where the golden image is stored.
    • --name The distribution name (Windows)
    • --version The OS version
    • --arch The architecture
    • --profileName The name of the profile, which will be visible in the user interface when creating a new Windows appliance. The name should be unique. If this option is not present, the name is generated automatically with the following info EDITION TYPE LANGUAGE. So for example: Standard Full English.

    For example:

    $ uforge org golden create --name Windows --arch x86_64 --version Server2012 --edition Standard --goldenDate 2016-01-28 --language English --type Full --goldenPath /tmp/DISTROS/Windows/releases/Server2012/x86_64/WS2012.raw.gz --profileName StandardK5

    Warning

    When running uforge org golden create you can use the --force flag. This force flag will allow you to overwrite an existing golden with the same name. The --force flag should be used with caution as the new changes will be applied for all appliances already using this golden image.

Deleting a Golden Image

In order to delete the golden image from your UForge, run the command org golden delete with the following arguments:

  • --arch : The operating system architecture (i386, x86_64).
  • --profileName : The name of the profile to delete
  • --name : Operating system name
  • --version : Operating system version

For example :

$ uforge org golden delete --name Windows --arch x86_64 --version Server2012 --profileName Standard Full Edition