Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

1. Connect to newly launched VM

instance

Instance

  • Using RDP client connect to MayaData VM instance using with the default account name and initial password provided configured by the cloud provider.
  • Change the default password to your own password.
  • Optionally create additional users if needed.

2.

Start the Crossmeta Drivers
  • Launch Windows Command Prompt or PowerShell in Administrator mode.

  • Navigate to Crossmeta installation directory c:\program files\crossmeta and run the script service_crossmeta.cmd as follows.

    Code Block
    languagetext
    themeRDark
    C:\Users\Administrator>cd "\Program Files\crossmeta" 
    C:\Program Files\crossmeta>service_crossmeta.cmd status 
    cxvfs is STOPPED cxfuse is STOPPED
    cxnfs is STOPPED cxhfs is STOPPED 
    cxvfsmgr is STOPPED
    C:\Program Files\crossmeta>service_crossmeta.cmd start 
    Starting Crossmeta kernel driver.
    The CROSSMETA Manager service is starting. 
    The CROSSMETA Manager service was started successfully. 
    Running Crossmeta 2.0.2-RELEASE #240: Mon Apr 8 18:17:44 PDT 2019 on WINNT/10.0_Build 
    C:\Program Files\crossmeta>
  • Once Crossmeta drivers have loaded successfully the Crossmeta V: drive will be available for your use
  • Launch Administration console 

    • Launch vfsadm Administration Console from the shortcut link in Desktop and Run as Administrator

      Image Added

    • Expand the Cloud Disks in the tree view pane to reveal the following management options


      Image Added


    Panel

    On this page:

    Table of Contents

    3.

    Configure your first object storageTo access your object storage from this cloud gateway software

    Create Cloud Profile

    • Use profiles → New to create a cloud profile that provides relevant information for accessing the cloud storage from application.  To start with the configuration you would need access ID  key and secret key generated by your cloud provider

    , if you are using object storage in multi-cloud environment or if
    • from their console settings. It is also possible to skip providing this information, if the compute engine was

    not
    • already authorized to perform

    any
    • S3 object access operations through IAM settings.

      Tip
      titleAWS EC2

      For AWS EC2 instance created with IAM role that authorizes S3 operations it may not be required to configure the accessId and accessKey within the software. Instead use the option --accessEC2IAM=ROLE option with objbaker. This will acquire S3 credentials from EC2 machine

    via IAM role.
      • Create access file with credentials

    Create file v:\etc\.s3wasabi_passwd using notepad and add the access information in this format accessId:accessKey. The acccessId could be account ID, and the accessKey is base64 encoded secret.

    Info

    By starting filename with dot you would avoid Windows adding any .txt extension to the above file. Also make sure there are no extraneous characters or newlines in this file.  This file is accessed by Crossmeta programs as /etc/.s3wasabi_passwd, while WIN32 programs access as v:\etc\.s3wasabi_passwd

    The sidebar on the left displays your pages in a hierarchy. If you have Space Administrator permissions you can click "Space Tools" > "Reorder Pages" to move pages around.Location of SSL certficate bundle
    For SSL to work objbaker  needs to know the location
    Code Block
    C:\Program Files\crossmeta>objbacker.exe  --cacert=ca-bundle.crt  --accessFile=/etc/.s3wasabi  --authVersion=aws2  --baseURL=https://s3.us-west-1.wasabisys.com/  --bucketCommand=list
    objbacker.exe: create amazon_s3 temporary lower layer for command list
    smbtest1        2019-04-30T17:51:51.000Z
    testdisk1       2019-04-25T05:10:32.000Z
    testdisk3       2019-04-25T05:10:06.000Z
    testdisk5       2019-04-25T07:06:38.000Z
    objbacker.exe: done
    
    C:\Program Files\crossmeta>
    C:\Program Files\crossmeta>objbacker.exe  --cacert=ca-bundle.crt  --accessFile=/etc/.s3wasabi  --authVersion=aws2  --baseURL=https://s3.us-west-1.wasabisys.com/  --bucketCommand=list
    objbacker.exe: create amazon_s3 temporary lower layer for command list
    smbtest1        2019-04-30T17:51:51.000Z
    testdisk1       2019-04-25T05:10:32.000Z
    testdisk3       2019-04-25T05:10:06.000Z
    testdisk5       2019-04-25T07:06:38.000Z
    objbacker.exe: done
    
    C:\Program Files\crossmeta>
    
    C:\Program Files\crossmeta>net start cxfuse
    
    The CROSSMETA FUSE kernel mode driver service was started successfully.
    
    :\Program Files\crossmeta>objbacker.exe  --cacert=ca-bundle.crt  --accessFile=/etc/.s3wasabi  --authVersion=aws2  --baseURL=https://s3.us-west-1.wasabisys.com/ --directIO --noAutoDetect --size=10T --timeout=30 --blockCacheSize=100 --blockCacheThreads=8 --minWriteDelay=5000 --md5CacheSize=1000000 --ssl --blockSize=1024K -o no_pagecache smbtest1  /mnt -f
    objbacker.exe: auto-detection disabled; using configured block size 1m and file size 10t
    objbacker.exe: error: https://s3.us-west-1.wasabisys.com/smbtest1/ appears to be already mounted
    
    C:\Program Files\crossmeta>objbacker.exe  --cacert=ca-bundle.crt  --accessFile=/etc/.s3wasabi  --authVersion=aws2  --baseURL=https://s3.us-west-1.wasabisys.com/ --directIO --noAutoDetect --size=10T --timeout=30 --blockCacheSize=100 --blockCacheThreads=8 --minWriteDelay=5000 --md5CacheSize=1000000 --ssl --blockSize=1024K -o no_pagecache smbtest1 --reset-mounted-flag
    objbacker.exe: auto-detection disabled; using configured block size 1m and file size 10t
    objbacker.exe: resetting mounted flag for https://s3.us-west-1.wasabisys.com/smbtest1/
    objbacker.exe: done
    
    C:\Program Files\crossmeta>objbacker.exe  --cacert=ca-bundle.crt  --accessFile=/etc/.s3wasabi  --authVersion=aws2  --baseURL=https://s3.us-west-1.wasabisys.com/ --directIO --noAutoDetect --size=10T --timeout=30 --blockCacheSize=100 --blockCacheThreads=8 --minWriteDelay=5000 --md5CacheSize=1000000 --ssl --blockSize=1024K -o no_pagecache smbtest1  /mnt -f
    objbacker.exe: auto-detection disabled; using configured block size 1m and file size 10t
     INFO: s3backer process 5312 for /mnt started
     INFO: mounting /mnt
    C:\Program Files\crossmeta>
    
    
    crossmeta-> sheel->
    V:\>mount
    /dev/loop0 on / type ufs (local)
    \fuse.chan5312 on /mnt type fuse
    devfs on /dev type devfs (local)
    
    V:\>umount /mnt
    
    V:\>
    
    
    sc create objdisk1 
    
    
    Labels help keep pages organized and make it easier for you to find the information you need. Click "Labels" at the bottom of a page to add or edit. The "Related pages" section on this page uses labels too!
    • Make templates

    Standardize and speed up the page creation process with templates. You can create and format a template with page layouts, standard headings and instructional text for hints and guidelines. Check out our sample page on "Making a template"

    • instance-data via http://169.254.169.254/latest/meta-data/iam/security-credentials/ROLE every five minutes.


      Use profiles → New to launch the following dialogs.


      Image Added


      Image Added


      The following dialog shows how to configure cloud profile for Wasabi Technologies which comes under Other S3 generic category. In this configuration BaseURL is required to match their service URLs

      Image Added


      Once configured it will provide a list of bucket/container names that is currently present.

      Image Added

    4. Configure your first object storage disk

    Select the cloud profile to use for creating object storage disk.  You can select an existing Bucket from the list or enter one manually which will create a new bucket for you.  Logical size of VHDX up to 64TB allowed by Windows. Fill in the following information for the new Disk

    1. Enter Disk name, which maybe same as bucket name or different.
    2. If you selected existing bucket the Bucket will be autofilled, otherwise enter a new bucket name to be created.
    3. Enter Size for the Disk representing the Bucket.  This is only a logical size while the bucket storage size is physical. Logical size of VHDX up to 64TB allowed by Windows.
    4. Select the Blocksize of the physical blocks in the cloud bucket.  This would normally match the application blocksize for optimal performance.  For NTFS it would match the cluster size of the file system.
    5. Click Create to proceed with the configuration.


    Image Added


    5. Register the object storage disk as service

    • Once cloud disk was setup Register it as service program so that it is available automatically on system startup.

      Right-click on Disk and select Register from popup menu.

      Image Added


    • In the Register cloud disk service you may accept the default values or change accordingly.


      Image Added


    • To start the service Right-click on Disk and select Start from popup menu.

      Warning
      titleReset-mounted flag

      If starting the service after unclean shutdown of earlier successful mount it is required to clear the mounted flag by selecting Reset-Mounted menu option and then attempt to start the service.


      After the above command finishes the object storage is accessible as V:\mnt\file.vhdx as one giant file and in this example it shows logical capacity as 10TB.

      Code Block
      titleqemu-img
      C:\Program Files\qemu>dir v:\mnt
       Volume in drive V is vfsroot
       Volume Serial Number is 0122-B5C1
      
       Directory of v:\mnt
      
      05/22/2019  07:48 PM    <DIR>          .
      05/22/2019  07:48 PM    <DIR>          ..
      05/22/2019  07:48 PM10,995,116,277,760 file.vhdx
      05/22/2019  07:48 PM             1,422 stats
                     2 File(s) 10,995,116,279,182 bytes
                     2 Dir(s)       5,242,880 bytes free 

    6. Configure the object storage disk as VHDX

    For Windows to make use of  object storage bucket  we have to initialize the object storage as VHDX image.  VHDX is preferred over VHD because of inherent journal feature to protect against unsafe shutdown and also it can support up to 64TB for a single image

    • To create new VHDX image click mount/umount from the treeview pane.
    • Select the Disk and Right-Click for the popup-menu and choose Create VHD menu option


      Image Added

    7. Mount the VHDX image of object storage disk

    • Select Disk and Right-Click to choose Mount VHD menu option to attach the VHDX image as Disk to Windows.
    • Only for newly created VHDX image
      Launch diskmgmt.msc to initialize disk for the first time and assign a drive letter.  You may create a file system within Disk Management GUI or from Command Prompt.

      Image Added


      To Create a file system NTFS or ReFS from command prompt. Use the actual drive letter that was assigned from the above command and allocation size of 1MB is chosen to match with the block size used while configuring cloud disk.

      Code Block
      languagepowershell
      titleFormat
      c:\users\Administrator> format /fs:ntfs /A:1M  /q  F:
      
      
      Warning
      titleNTFS allocation size

      Windows 2019 supports allocation size of 1MB for NTFS file systems while earlier version limited to 64KB only.  This means NTFS created with 1MB allocation size may not be recognized by older Windows.

    8. Detach the  VHDX image

    To stop the objbaker service program for the disk the VHDX image as to be detached first.

    • Select Disk and Right-Click to choose Umount VHD menu option


    9. Stop the service of object storage disk 

    After detaching the VHDX image it is safe to proceed with stopping the service if needed. 

    • Select services → Disk and Right-Click to choose Stop menu option



    Related pages