• Changing the site name in Cloud Director

    After deploying new or upgrading your Cloud Director environment to 10.2 you may notice the tenants site name displaying something similar to “Site name undefined (Site ID: 6d2f1162-b138-4aef-ac42-320f32b5d45c)”

    This is because the site name is not something you set during the initial setup, it has to be manually changed after deployment. When left unset it may appear as a UUID, hostname of the installations API public address or the IP of the Cell.

    To make the changes I will be using Postman. You can download a free copy from the following link

    To get started enter your Cloud Director URL and append it with /api/versions and click Send

    Example – https://vcloud.stevenonofaro.net/api/versions

    This should return a status of 200 OK. Scroll down in the body and look for a valid API version.

    Look for one of the versions listed under the value of VersionInfo deprecated=”false” as these will be the current working API versions.

    For this example I will go with the latest version 35.0

    <VersionInfo deprecated=”false”>

    <Version>35.0</Version>

    Create a new connection at the top by clicking on the + button then change the type to POST and enter your Cloud Director URL and append it with /api/sessions.

    Example – https://vcloud.stevenonofaro.net/api/sessions

    Then click on Authorization, change the type to Basic Auth and enter your username and password.

    Then click on the Headers tab, set the Key to Accept and the Value to application/*+xml;version=35.0

    Now click Send. It should then return a status of 200 OK and if you click on the Headers tab again you will see your X-VMWARE-VCLOUD-ACCESS-TOKEN.

    Copy the value as we will use this to change the authentication type.

    Now switch back to the first GET tab we created initially. Click on the Authorization tab and change the type to Bearer Token. Then paste in the token we just copied from the previous POST tab.

    Then click on Headers and set the Key to Accept and the Value to application/*+xml;version=35.0

    Now update the GET URL to the following,

    Example – https://vcloud.stevenonofaro.net/api/site/associations/localAssociationData

    Then click Send, you should get a status of 200 Ok. This way when the bearer token expires (which it does after 30 minutes) you can just go back to the POST tab and get an updated token.

    Next up we need to look through the Body and try to locate the href URL for the Cloud Director site. It will reference the UUID that is shown in the image below.

    The information we are looking for is the following,

    <Link rel=”edit” href=”https://vcloud.stevenonofaro.net/api/site/associations/6d2f1162-b138-4aef-ac42-320f32b5d45c&#8221; type=”application/vnd.vmware.admin.siteAssociation+xml”/>

    Now we need to perform a GET request using the following URL – https://vcloud.stevenonofaro.net/api/site/associations/6d2f1162-b138-4aef-ac42-320f32b5d45c

    Update the GET box and click Send.

    You should again get a status of 200 Ok.

    Note – If you get an error you may need to update your bearer token and check the headers tab to make sure the api version is still set and try again.

    Scroll down in the body and near the end you should see the following,

    <SiteName>Site name undefined (Site ID: 6d2f1162-b138-4aef-ac42-320f32b5d45c)</SiteName>

    This is the site name section that we need to update.

    Now copy the whole response and then click on Body, click the raw checkbox and change txt to xml. Then paste the entry into the box.

    Scroll down and update the site name in the following way,

    <SiteName>Perth</SiteName>

    I have just updated my site name to Perth.

    Click on the Headers tab and set a new Key to Content-type and set the Value to application/vnd.vmware.admin.siteAssociation+xml

    Then change the drop down from GET to PUT and click Send.

    This will then return and Status 200 Ok

    Now it’s time to go back to Cloud Director and login to see if our new site name is displayed.

    And from the main Data Centers view,

    You will also see the completed task when logged in as the system administrator. 

     

    As always use the subscribe box above for new post notifications and follow me on twitter @steveonofaro

     

     

     

     

     

     

  • Synology Survey Lucky Draw Event

    To be in the running to win a Synology DS920+ or other Synology Merchandise just click on the link below and complete the survey!

     

    Fill out the survey before April 16th – Click Here

     

    Some of the great prizes on offer include:

    – Synology DS920+

    – Synology insulated water bottles

    – Synology long sleeve sweaters

    – Synology key holders

    – Synology caps

     

    Prize winners will be announced on April 21st, and also contacted through DM or email by Synology.

    For more details, please kindly refer to the terms and conditions in the survey link.

     

     

     

    @steveonofaro

  • Synology Active Backup for Business

    In this post I wanted to run through configuring and using Active Backup for Business on your Synology NAS. The software is free to use and supports Windows Physical Server, Windows PC, vSphere, Hyper-V and File Server Backups. You also have the option to install Active Backup for G Suite and Active Backup for Microsoft 365. For this example, I will be running through a backup and restore of a VM from my VMware vSphere environment.

    It supports vSphere version 5.0 through to 6.7 at this point in time. You will also need to ensure that TCP ports 443 and 902 are open between the Synology NAS and the vSphere environment.

    Before you get started make sure that your DiskStation Manager (DSM) is at the latest version and the user you have logged in with belongs to the administrators group.

    Launch Package Center which is located on the main desktop

    Then locate Active Backup for Business and click Install

    The software will then be downloaded and installed. It will then be available from the main menu.

    Launch Active Backup for Business

    Select Activate to start the activation process. You will require your Synology account for this process.

    Review and accept the privacy statement. Then click Next

    Enter your Synology account details and click Activate

    Once complete click Ok

    You will then be ready to start configuring Active Backup for Business.

    For this example I will be connecting to my vSphere environment. So click on Manage Hypervisor under the VMware vSphere tab.

    Then click on Add

    Enter your vCenter server Name or IP Address, then enter a username and password to connect.

    Once complete click Apply

    Accept the certificate request that appears and once connected close the Manage Hypervisor window.

    The Active Backup for Business window will now show the ESXi hosts and VMs which are currently connected to the vCenter Server.

    Next up its time to create a backup task. Click on the Task List option.

    Click on the Create drop-down menu and select vSphere task

    With the backup destination highlighted click Next

    Note – The file system needs to be Btrfs

    For the Task Name enter a name for the backup job. Then expand your cluster and select which VMs you would like to backup.

    Then click Next.

    Once you are happy with the options you have selected click Next

    The next screen allows you to either perform a manual backup or configure your own backup schedule. For this example I am just going to create a Manual Backup.

    Once complete click Next.

    Next up are the retention policy settings. You can select to keep all version of your backups or create a policy that will keep all versions for the next 14 days as an example.

    I am just going to select Keep all versions for this backup. Once you have made your selection click Next.

    Then select which users you would like to grant restore privileges. I only have my base admin user created at this stage but it would be a good idea to create a specific restore user or group and then select it here.

    Once you have made your selection click Next.

    Review your settings and when you are ready click Apply.

    As I selected a Manual Backup I was then prompted to run the backup now. For this example I will select Yes.

    The backup has now started and can be monitored from the Task List.

    The backup has now completed successfully.

    If you click on Details you will see more information about the job itself.

    Now let’s run through a restore scenario. I could just restore the VM back to its original location in vCenter which would work perfectly fine, but I was keen to test a restore to Virtual Machine Manager on the Synology itself.

    Before we start you need to have Virtual Machine Manager installed. To do this open Package Center and then scroll down until you locate Virtual Machine Manager. Then click Install and follow the prompts.

    Once the installation is complete open Virtual Machine Manager and follow the wizard to complete the configuration. Also add in any networks that you may require for your newly restored VM from the Network tab in Virtual Machine Manager.

    Now switch back over to Active Backup for Business, select Virtual Machine from the left hand menu and then select Task List to see the last backup job.

    Highlight the Backup Task and click Restore

    Next you need to select where you would like to restore the VM. Normally this would just be back to VMware vSphere but for this example I wanted to restore the VM to Virtual Machine Manager on the Synology itself.

    Select Instant Restore to Synology Virtual Machine Manager, then click Next.

    Select the restore point you would like to restore from and click Next.

    Select the storage where the Virtual Machine will be stored and click Next.

    Check the hardware configuration and make any necessary changes and click Next.

    On the Virtual Disk configuration page click Next.

    On the network configuration page click Next.

    You will then be prompted to download the Synology Guest Tool. This is the VMware Tools equivalent and will be mounted to the VM ready to install. Click on Download to continue.

    Then click Next.

    If you have a specific account that you would like to assign permission to interact with this VM, select it here and then click Next.

    Once complete click Apply.

    The Server will then be imported from the backup job and will display in Virtual Machine Manager.

    From the Action drop-down menu you can make any changes you require to the VM prior to powering it on. For this example I have not make any changes to the VM.

    With the virtual machine highlighted select Power On to start the VM.

    Once the Status of the VM shows Running then the Connect button will no longer be greyed out.

    Click on the Connect button to interact with the VM. The Virtual Machine will now power up ready for use in a new window.

    Using the arrow tab on the left on screen you can send a ctrl + alt + del to the VM so that you will be able to login.

    Once logged in you will see that the Synology Guest Tool ISO is mounted.

    Launch the installer and click Next.

    Accept the license agreement and click Next.

    On the destination folder screen click Next.

    Then click Install.

    Once complete click Finish.

    Then select Yes to restart the VM.

    Once the VM has restarted log back in and you will be ready to use your newly restored Virtual Machine which is now running on your Synology.

    That’s it from me, I hope this helps you get started with Active Backup for Business!

     

    @steveonofaro

  • Synology DS1621xs+ Getting Started Guide

    In this post I wanted to run through setting up a new Synology DS1621xs+. Deploying a Synology at home has been on my to do list for some time now. With multiple PC’s and a lab running at home I have accumulated a fair amount of data and as always its stored in all different places. Time to start consolidating!

    The 6 bay unit has an Intel Xeon D-1527 4-core 2.2Ghz CPU and comes with 8GB of DDR4 ECC Memory which you can expand out to 32GB if required. It also has two M.2 2280 NVMe SSD slots which I will be using to setup an SSD Cache. There is also a front mounted USB 3.0 port in the lower right hand corner which will come in handy when copying data onto the NAS. For now, I have 6 x 2TB drives which I will be using during this setup example.

    On the back on the unit you can see the 2 x 1GbE ports and the 1 x 10GbE port. Unfortunately I don’t have 10GbE at home so I will just be connecting both of the 1GbE ports for now but I do like having the option. It also has 2 more USB 3.0 Ports and 2 x eSATA ports.

    I will then be installing 2 x M.2 2280 NVMe SNV3400-400G Solid State Drives. These will be used later to configure my SSD Cache.

    I would recommend removing a few of the empty drive slots to give yourself enough room to install the M.2 drives. Then the M.2 drives just click into place in the mounts provided on the inner left hand wall.

    Next up you will need to install your hard drives. Push on the base of the drive slot at the front to unclick it from the main unit. Then slide the empty drive caddy out. The outer side rails just clip off allowing you to then install your drive into the caddy. Clip the side rails back into place and slide the drive caddy back into the Synology. Then push the base of the caddy down and it will click into place. You can also lock the drives in place with the key provided.

    Now when ready you can connect the two 1Gb Ethernet ports to your switch and then connect the power cable and power on the Synology unit.

    Before we get started make sure the pc that you are going to use to configure your new NAS is on the same network as your Synology and you are able to access the internet.

    Open you browser and enter – http://find.synology.com/

    Once your Synology is located on your network click Continue.

    Click Next on the End User License Agreement.

    Click Continue on the Synology Privacy Statement.

    Then on the Web Assistant page click Set Up.

    Download the latest copy of DSM from the Synology download center.

    Select the copy of DSM that you just downloading using the Browse Button.

    Once started you will be prompted that all of the data on the disks will be removed. Tick the box and click Ok.

    The process will now commence.

    This takes around 10 minutes to complete and the NAS will be restarted during this process.

    Then enter a Server Name for your Synology and a Username and Password.

    Once complete click Next.

    Setting up QuickConnect allows you to access your Synology from outside of your home network without having to configure any port forwarding on your home router or firewall. To do this you will need to setup a Synology Account.

    For this example I will set this up after the initial setup of the unit so I have selected Skip this step.

    With the initial setup complete click on Go.

    When the Smart Update screen appears click Got It.

    You should now see your DiskStation Manager Desktop.

    Select the menu from the top left, then select Storage Manager.

    You will then see an overview of Storage Manager. You should be able to see your disks but no volumes or storage pools just yet.

    Select Storage Pool from the left hand menu and then click Create.

    You have 2 options here, Better Performance or Higher Flexibility. Better Performance supports only 1 volume and Higher Flexibility support multiple volumes. For this example I have selected Higher Flexibility. Then click Next.

    Select your RAID type based on the number of disks you have installed. For this example I am going with RAID 5.

    Once complete click Next.

    Drag each of your available hard drives over to the right.

    Then click Next.

    A warning will appear informing you that all of the data on the disks will be erased. Click Ok to continue.

    Then click Apply.

    When prompted to create a volume click Ok.

    The Storage pool should display a status of Healthy once complete.

    Once the storage pool has been created click on Volume from the left hand menu. Then click Create.

    Select the Storage Pool and click Next.

    Below is a table explaining the features of each file system. Note if you are looking to use applications like Active Backup for Business or Virtual Machine Manager then you will need to select Btrfs.

    Make your selection based on your use case and click Next.

    Set a description and the allocated size and click Next.

    Then click Apply.

    The volume will then be created and the status should appear as Healthy.

    Then click on HDD/SSD from the left hand menu. You will see all of the disks installed in the system. You will also see the NVMe Cache drives I installed earlier.

    It is now time to setup the SSD Cache. Click on SSD Cache from the left hand menu and click Create.

    Choose between Read-write cache or Read-only cache. For this example I am going with Read-write cache.

    Select both of the NVMe drives and click Next.

    Raid 1 is our only real option here so click Next.

    Then click Apply.

    Tick the check box which is informing you that all data on the SSDs will be removed and click Ok.

    Once complete the SSD Cache should show as Healthy.

    That’s it your Synology is now configured and ready to use. Close the Storage Manager window.

    Launch Package Center which is located on the desktop.

    Then browse through the packages available to install on your new Synology. A great place to start is Virtual Machine Manager, Cloud Sync and Active Backup for Business!

    As you can see the Synology DS1621xs+ is very straight forward to setup and I have been extremely impressed with how it has been performing so far. With the Xeon 4-core processor and the dual M2 NVMe Cache drives you really can’t go wrong! If you are looking at upgrade options at the moment, I would highly recommend you checkout this NAS.

    That’s it from me, I hope this has helped you get started with your new Synology DS1621xs+.

     

     

    @steveonofaro

     

     

  • Google Cloud Object Storage option now available in Veeam v11

    One of the new options available in Veeam Backup & Replication v11 is the ability to add Google Cloud Storage in as a Capacity Tier option for your Scale-Out backup repository. With each new release we are seeing the object storage options available to users grow. Whether you want to use your own on-premise solution or leverage one of the public cloud providers Veeam have you covered.

    With that said let’s first run through creating your new Google Cloud Storage Bucket.

    When you first sign up to GCP you can leverage the Free Tier program. Be sure to check the Free Tier usage limits as some of the options are only available from certain regions.

    https://cloud.google.com/free/docs/gcp-free-tier

    Your free trial also includes $300 in credit to spend in the next 90 days which is great if you are just getting to know the platform.

    I will be leveraging my Cloud Storage from the Australia-southeast1 location which is based in Sydney. This unfortunately doesn’t fall under the free tier bracket. Luckily Google provides a monthly estimate calculator which you can use when you first create your bucket.

    After logging in you select the drop-down menu from the top left and then click on Storage. As I am not using Cloud Storage from one of the US Regions (which falls under the free tier) I need to click on Enable Billing before I can create a bucket.

    Next up select your billing account from the drop-down menu and click Set Account.

    Now the Create Bucket option is no longer greyed out. Click Create Bucket.

    Enter a bucket name and then click Continue.

    Next up select where you would like to store your data. I just need a single region for this example, so I have selected the first option Region. Then select your location from the drop-down menu and click Continue.

    Currently only Standard and Nearline are supported by Veeam v11 so select one of these options. In this example I have selected Nearline. Remember which option you select here as you will need it later during the configuration in VBR.

    Then click Continue.

    Select your preferred Access Control method and click Continue. I am just keeping things simple here and have gone with Uniform.

    For the encryption settings I have just selected Google-managed key. Then click Create.

    Once complete your bucket will be created.

    Now we need to configure the Access Keys so that you can connect to the bucket from VBR. Select Settings from the left-hand menu. Again, this is my lab so I am keeping things simple here.

    Then select Interoperability.

    Scroll down and Set your default project. I have left mine as the default name.

    Then click on Create A Key.

    Take a copy of your Access key and Secret as we will need this when creating the connection from the VBR console. The access key and secret you see below have been modified.

    Next up open your Veeam Backup & Replication 11 console and click on Add Backup Repository. Then select Object Storage.

    Then click on Google Cloud Storage.

    Add in a Name and Description for this new Object Storage Repository. Then click Next.

    Click on Add and enter in your Access key and Secret Key, then click Ok.

    Once your access key has been added you can now select a gateway server to proxy access to Google Cloud Storage. 

    Then click Next.

    First up you will see your Data center region. Then select your bucket name from the drop-down menu and set the folder you would like to use.

    Select the checkbox next to Limit object storage consumption to and set your soft limit if required.

    You will also notice there is no option to make the backups immutable just yet. I am sure this is something that will come in due course, possibly by utilizing Googles retention policy settings. This is just me taking a guess, but we will see what happens.

    Then you have the option to select the nearline storage class for a lower price per GB. I created my bucket using nearline storage so I have enabled this.

    Once complete click Apply.

    Then click Finish

    That’s it! Your new Google Cloud backup repository is now connected as a repository in VBR.

    Now let’s run through adding it to my existing Scale Out Backup Repository. Right click the SOBR and select Properties.

    Select Next.

    Note – You can skip ahead and just click on Capacity Tier but I thought I would show each section.

    Then click Next.

    Click Next.

    Click on the check box next to Extend scale-out backup repository capacity with object storage. Then select the Google Cloud Object Storage repository from the drop-down menu.

    You then have the option to copy backups to object storage after they are created or to Move backups to object storage as they age out of the operational restore window.

    In this example I have selected Copy backups to object storage as soon as they are created. Once the normal backup job is complete the offload job to copy the data to the capacity tier will start.

    Once complete click Apply.

    Click Finish.

    For this example I have just created a new backup job using the newly edited Scale-Out Backup Repository.

    The backup itself will run and then once complete the Offload job will start.

    As the data is copied over the directory structure on the Google Cloud capacity extent is laid out in the following way by the VBR server,

    When the job has completed you will notice the Object Storage option in the left-hand menu. Once selected you will see the job that was recently run. You will also see how many restore points are available to restore from and the various restore options available.

     

    That’s it from me, stay tuned for more updates and features coming out with Veeam Backup & Replication v11!

     

     

  • Getting started with the Veeam v11 Native Plug-in for vCloud Director

    With the upcoming release of Veeam Backup & Replication v11 comes the new version of the Veeam Native vCloud Director Plugin. This addition has been a big hit with Service Providers as it allows them to integrate the Veeam Self-Service Portal directly into the vCloud Director interface. One new addition to the plugin that everyone will be happy to hear is available is single sign on using the tenants vCloud Director Credentials.

    Let’s go over a few things that you need to have in place first prior to installing the new plugin.

    First step is to have Veeam Backup & Replication v11 and Veeam Enterprise Manager v11 installed. Then add your vCloud Director instance to Veeam Backup & Replication. You can do this by opening the VBR console and selecting Inventory, Add Server, VMware vSphere and then select vCloud Director. Then follow the prompts to add your vCD instance in.

    Note – I am currently running Cloud Director 10.2 but I have also tested the plugin on 10.0.0, 10.1.0, 10.1.1 and 10.1.2. Now technically I should be referring to it as Cloud Director throughout this post but I just can’t bring myself to drop the “v” yet, it’s too soon.

    The next thing you will need is a Tenant Organization setup in your vCloud Director instance with a couple of VMs running. For this example we will use TENANT01 that I have setup below.

    Now let’s go through to the process to configure the Enterprise Manager Self-Service portal for use with vCloud Director and then we will setup the new Veeam v11 Plugin.

    Double click on the Veeam Backup Enterprise Manager icon on your desktop and login.

    While we are here you will also notice the new drop-down option to change the default language.

    I thought I may as well test out my German,

    As you can see once you have logged in the interface is also updated.

    Ok back to the Enterprise Manager configuration. Once logged in click on Configuration.

    From the Backup Server menu select Add to add in your Veeam Backup & Replication Server.

    Enter your Veeam Backup & Replication server details and click Ok.

    Once the collection has completed the Self-Service option will display on the left-hand menu.

    Click on Self-Service then select vCloud and click Add

    Note – If you do not have the Self-Service option available then check that you have your Service Provider Enterprise Plus license installed and try again.

    Then complete the following fields,

    Organization – Select the Cloud Director Tenant.

    Repository – Select the Backup Repository you would like to use for this tenant’s backups.

    Friendly Name – Set a friendly name for this customer. This friendly name will also be used as the repository name the tenant can see when creating a new job.

    Quota – Set a backup storage quota limit for this tenant.

    Job Scheduling – Select the permissions for job scheduling from the drop-down menu.

    Job Priority – Select between Normal and High. Default option is set to Normal.

    The newly created Tenants account will now be displayed.

    The self-service backup portal is now accessible to the customer using a dedicated URL and their existing vCloud Director login details. Here is an example of the self-service backup portal for TENANT01 – https://backup.stevenonofaro.net:9443/vCloud/TENANT01

    Having a separate portal to log into for the customers backups can be helpful but why not integrate it into the main vCloud Director interface?

    With that said let’s look at getting the new Veeam v11 Plugin for vCloud Director up and running. To get started mount the Veeam Backup & Replication v11 ISO to your management server, the plugin is located in the following directory – “Plugins\vCloud Director\plugin.zip”

    Then login to the vCloud Director provider portal, select the More drop-down menu and click on Customize Portal.

    Select the Upload button

    Then click on Select Plugin File

    Browse to the plugin location on the Veeam Backup & Replication ISO – “Plugins\vCloud Director\plugin.zip”

    Then click Open

    Once the plugin file has been selected click Next

    Set the Scope and select which Tenants you would like to publish the plugin too and click on Next

    Then select Finish

    The plugin will now be displayed below,

    Then you can either refresh the browser or log out of vCloud Director and then log back in. Next select the More drop-down menu and select Veeam Data Protection.

    Enter the URL for your Enterprise Manager Server and click Save.

    Note – For this to work correctly you will need to have installed an SSL Certificate on your Enterprise Manager Server. If you haven’t already done so install the certificate on the Enterprise Manager Server now. Then Open IIS and expand out your sites and select VeeamBackup. Then select Bindings on the right-hand menu and click on https and select Edit. On the SSL Certificate drop down menu select your SSL Cert and click Ok. Under Manage Website on the right-hand menu click on Restart.

    Next log out of the vCloud Director Provider Portal and log in as the Tenant. Below is an example of the Tenant URL – https://vcloud.stevenonofaro.net/tenant/TENANT01

    Select the More drop-down menu and click on Veeam Data Protection

    You will now be logged directly into the Self-Service Backup Portal from within the vCloud Director interface. You will also notice that the top section of the Self-Service Portal has been removed and the colour theme has been updated to match the default vCloud Director theme. The interface blends perfectly now and looks like a natural extension of vCloud Director.

    Once you have created a backup job for your tenant there is also one other bonus feature Veeam have added in with v11. If you select the Actions button next to one of your VMs you will also notice Add to Backup has been inserted into the vCloud Director VM menu system.

    Note – For Cloud Director 10.0.0, 10.1.0, 10.1.1 and 10.1.2 you will first see Veeam Data Protection in the menu, then Add to Backup

    After selecting Add to Backup you will then be prompted to select the backup job to add the VM too. Click Add to Job. The VM has now been added into the backup job without you even having to switch over to the Self-Service Portal.

    That’s it from me, stay tuned for more updates and features coming out with Veeam Backup & Replication v11!

    @steveonofaro

     

     

  • Upgrade to Cloud Director 10.2

    First off before we begin the upgrade its important to take a snapshot of the appliance. To do this shutdown the appliance from vCenter and then take a snapshot. Once complete power Cloud Director back on.

    If you have multiple Cloud Cell’s then log into one of the appliances on port 5480 to identify which is the primary appliance (write that down) as we will need to use this cell later on to back up the database.

    The current version of Cloud Director in my lab is 10.1.2.16779297

    Then download the appliance update package from VMware.

    Next up use putty to ssh to your Cloud Director Appliance and run the following command,

    mkdir /tmp/local-update-package

    Then copy the update package to the newly created local-update-package directory on the appliance. To do this I just used winscp and connected to the appliance and transferred the file.

    Then browse to the newly created directory cd /tmp/local-update-package

    Now extract the package in the local-update-package directory by running the following command,

    tar -zxf VMware_Cloud_Director_10.2.0.5190-17029810_update.tar.gz

    Next we need to set the newly created local-update-package directory as our update repository for the appliance. To do this run the following command,

    vamicli update –repo file:///tmp/local-update-package

    Now let’s check that it has set our new directory as the local update repository. To do this run,

    vamicli update – -check

    You should see an output like the image below, it should show the package we downloaded as an available update.

    Then shutdown the Cloud Director cell by running the following command,

    /opt/vmware/vcloud-director/bin/cell-management-tool -u administrator cell –shutdown

    You will be prompted for the administrator password.

    Next let’s kick off the upgrade, to do so run the following command,

    vamicli update – -install latest

    If you have multiple cell’s then you will need to complete all of the previous steps on each cell before upgrading the database.

    Next up we need to back up the database, if you only have the one cell then this is easy. If you have more than one, then as I mentioned earlier you can identify which is the primary by connecting to the cell ip on port 5480. To back up the database we need to be connected to the primary cell before running the following command,

    /opt/vmware/appliance/bin/create-db-backup

    Now let’s complete the database upgrade, this can be run from any cell.

    /opt/vmware/vcloud-director/bin/upgrade

    You will be prompted with “Do you wish to upgrade the product now?” Enter Y to continue with the upgrade.

    During the process it will ask if you have taken a backup of the database, to continue enter yes to continue here also.

    Once complete it will prompt you to start the cell, enter y to start the services.

    You will then need to restart each of the cells after the upgrade is complete, to do this run the following command,

    shutdown -r now

    Once the Cloud Director cell has rebooted you will then be able to login to your newly upgraded appliance.

    Then if you click on the drop-down menu and select About you will see the newly upgraded version.

     

     

    As always use the subscribe box above for new post notifications and follow me on twitter @steveonofaro

     

     

     

     

     

     

     

  • Veeam Enterprise Manager 10 – How to modify the default theme

    In a previous post I walked you through how to modify the default theme of Enterprise Manager 9.5. Now it’s time to do the same with Enterprise Manager 10. I have been playing with Enterprise Manager for a while now and I especially like the ability to integrate the product with vCloud Director. After using the Enterprise Manager plugin for vCloud Director I wanted to make a few changes to the theme so that I could better integrate it with our customized vCloud theme. The below guide covers some of the basic changes you can make to the main Enterprise Manager Portal theme and also the Self-Service Backup Portal.

    This is default Enterprise Manager 10 main menu.

    We are going to edit the following files to change the default Veeam green to blue for this example. Take a backup of each file before continuing,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\resources\MainApp-all_1.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\resources\MainApp-all_2.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\resources\MainApp-all_3.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MonthlyReportApp\resources\MonthlyReportApp-all.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\static\assets\errors.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\VCloud\resources\VCloud-all.css

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\VSphere\resources\VSphere-all.css

    Once again I have used Visual Studio Code to make the changes to each of the files. Click on File then Open File to open each one in a different tab then select Edit from the drop down menu then Replace. Enter the default green #2a6e52 colour code at the top and then your new colour code #2E86C1 below, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. This colour will be present in each file.

    Then select File and Save All.

    Next we have a few more codes to change, enter the other default green #245f47 colour code at the top and then your new colour code #2874A6 below, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. Note the second two green colour codes don’t appear in the MainApp-all_3.css and errors.css file.

    Then select File and Save All.

    Then again in the Find box change the colour code to #1b4735 and then change the Replace code to #21618C, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. Note the second two green colour codes don’t appear in the MainApp-all_3.css and errors.css file.

    Feel free to get more creative with your colours, I am just using a few different variations of blue for this example.

    Then select File and Save All.

    In the Find box change the colour code to #215741 and then change the Replace code to #21618C, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. Note that MainApp-all_3.css and errors.css does not have this colour code present.

    In the Find box change the colour code to #4e846e and then change the Replace code to #2E86C1, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. Note that MainApp-all_2.css, MainApp-all_3.css and errors.css does not have this colour code present.

    In the Find box change the colour code to #54b948 and then change the Replace code to #2E86C1 (try a lighter version of your previous colour), then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button. Note that MainApp-all_2.css, MainApp-all_3.css and errors.css does not have this colour code present.

    Then open the following css file,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\web\css\prettify.css

    In the Find box change the colour code to #060, #066, #080 and #044 and then change the Replace code to #2E86C1, then click the Replace All icon to the right. Click on each of the CSS file tabs and click the Replace All button.

    Then select File and Save All.

    Now you are ready to launch Enterprise Manager and view the new updated menu colour scheme. Initially you may need to open your browser in incognito mode to show the changes straight away.

    Below is an example from the Self-Service Backup Portal.

    The updated view once logged in from the Self-Service Backup Portal.

    Next we need to modify the default green colour which appears when you hover over the main menu items and the user menu in the top right. Below is an example from the vCloud Self-Service Portal.

    Here is an example from the main Enterprise Manager Portal.

    Once again its time to change another colour code so we can repeat the same process.

    Now this colour code was fun to locate! In the Find box change the colour code to #245c45 and then change the Replace code to #2874A6 (use a light colour here again), then click the Replace All icon to the right. This code only needs to be changed on the MainApp-all_2.css, MonthlyReportApp-all.css, Vcloud-all.css and vSphere-all.css.

    Then select File and Save All.

    Then in the Find box change the colour code to #1f4d3a and then change the Replace code to #2874A6, then click the Replace All icon to the right. This code only needs to be changed on the MainApp-all_2.css, MainApp-all_3.css, MonthlyReportApp-all.css, Vcloud-all.css and vSphere-all.css.

    Then select File and Save All.

    Then refresh each of the portals, now when we hover over the buttons the green background is gone and it has changed to a different shade of blue.

    Example from the vCloud Self-Service Portal.

    Example from the main Enterprise Manager Portal.

    Now it’s time to remove the icon that displays on the left-hand side of the menu. The icon itself is very small and you can replace the image with anything you like but for this example I am just going to remove it.

    Icon from the Tenant Self Service Portal.

    Icon from the main Enterprise Manager Portal.

    Browse to the following directory and take a backup copy of the png file.

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\VCloud\resources\images\siteLogo16.png

    Rename siteLogo16.png to old_siteLogo16.png

    Close and open the page and the icon will no longer appear.

    Now for the main Enterprise Manager portal

    Browse to the following directory and take a backup copy of the png file.

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\resources\images\veeam\icons\logo32.png

    Rename logo32.png to old_logo32.png

    Close and open the page and the icon will no longer appear. If it doesn’t change straight away try it using incognito or inprivate browsing mode to see if it’s just cached.

    Now let’s edit the logon screen welcome message for the vCloud Self-Service Portal,

    Open the following file,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\VCloud\login\app.js

    Then click Edit, Replace and in the Find box enter Welcome! Please sign in. and in the Replace box enter the text you would like to display then click the Replace All button.

    Then click File and Save All

    Once again if it doesn’t update straight away just close the browser and open another incognito window as its most likely cached. The logon screen welcome message should now be updated.

    You can also update the logon message for the main Enterprise Manager Portal.  To do this open the following file,  

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\login\app.js

    Then click Edit, Replace and in the Find box enter Sign in and in the Replace box enter the text you would like to display then click the Replace All button.

    Then select File and Save All

    Once again if it doesn’t update straight away just close the browser and open another incognito window as its most likely cached. The logon screen welcome message should now be updated.

    You can also modify the header section at the top of the vCloud Self-Service Portal login screen.

    To do this we need to open the following file,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\VCloud\resources\localization.js

    In the Find box enter Self-Service and in the Replace box enter the text you would like to display then click the Replace All button.

    Next open the web.config file from the following location,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\Web.config

    In the Find box enter Self-Service and in the Replace box enter the text you would like to display then click the Replace All button.

    Then select File and Save.

    Then close and open your browser and the portal should be updated! You may need to initially clear your browser cache or open incognito mode for it change.

    The same modification can also be made to the main Enterprise Manager Portal login screen.

    To change the heading Veeam Backup Enterprise Manager which is displayed in the top left corner open the following app.js file.

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\scripts\build\production\MainApp\login\app.js

    In the Find box enter Veeam Backup Enterprise Manager and in the Replace box enter the text you would like to display then click the Replace All button.

    Next open the web.config file from the following location,

    C:\Program Files\Veeam\Backup and Replication\Enterprise Manager\WebApp\Web.config

    In the Find box enter Veeam Backup Enterprise Manager and in the Replace box enter the text you would like to display then click the Replace All button.

    Then select File and Save.

    Then close and open your browser and the portal should be updated! You may need to initially clear your browser cache or open incognito mode for it change.

    I hope this post has helped you guys put your own personal touch on the Enterprise Manager Portal. If you are not using it then it’s time to get on board because it’s a great product! Especially when it comes to vCloud Director Integration!

     

    As always use the subscribe box above for new post notifications and follow me on twitter @steveonofaro

     

     

     

     

     

     

  • Smart Licence Commands Fail on HX Edge Cluster

    I came across an interesting error when trying to licence a Hyperflex Edge Cluster the other day. Each time I ran the stcli license show all command I received the following message,

    The cluster itself is running 4.0(2a) which turns out to be the reason why we are currently seeing this issue.

    So at this point there are two options available. You can either upgrade your cluster to 4.0(2b) which requires a little more planning or contact Cisco Support and get a copy of a patch file which will resolve the issue. When you log a TAC case ask them for a copy of a file called nesla-3.0.9.jar which is directly related to Cisco Bug CSCvt13929. This patch can be applied at any time without the need for any sort of outage.

    Below are the steps required to install the fix on the cluster in question,

    Copy the file nesla-3.0.9.jar to the /tmp directory on each of the storage controllers using winscp.

    Then run the following command,

    cp /tmp/nesla-3.0.9.jar /opt/springpath/storfs-mgmt/dependencies/lib/nesla-3.0.9.jar

    Then restart the service,

    restart hxLicenseSvc

    Give it a minute and then run,

    stcli license show status

    Then you should see the following,

    Now you can go through the process of registering your HX Cluster.

    First step is to login to your smart portal and create a token, then copy the token string.

    Then SSH to one of the controllers in the cluster and enter the following command (adding your token string at the end)

    stcli license register –idtoken “past in token” 

    Give it a minute and then check the license status,

    stcli license show status

    That’s it, your new HX Cluster should now be registered with your Cisco Smart Account

     

  • How to enable the Flex UI in vCloud Director 10.0

    In the last few releases of vCloud Director more and more capabilities have been added into the HTML5 interface to bring it in line with the older Flex UI. While it has come a long way there are still a few things (refer to the release notes) missing that some people may do on a regular basis. In vCloud 10.0 when you attempt to browse to the Flex UI by appending /cloud to the end of your vCloud URL it will automatically redirect to the HTML5 interface.

    The old Flex UI hasn’t been removed just yet and there is still a way to enable it. So whether there is an option you don’t have in the HTML5 interface yet or you have been working with the Flex UI for so long you are just more comfortable with it, here is how you enable it.

    There are 2 options available, you can enable it for all users or just the system administrators.

    Login via SSH to each of your vCloud Cells as the root user,

    To enable it for all users run the following command,

    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n flex.ui.enabled -v true

    If you want to only enable it for the system administrators then you can run the following command,

    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n flex.ui.enabled -v sys-admin-only

    If you have more than one vCloud Cell make sure you run it on each of your cells.

    Then restart the vmware-vcd service on each cell you have made the change

    service vmware-vcd restart

    And we are back,

    If you want to disable the old Flex UI at a later stage you can run the following command to do so,

    cell-management-tool manage-config -n flex.ui.enabled -v false