Cloud Drive Mapper ( CDM ) is fully compatible within Citrix / RDSH environments and can be deployed relatively easily.

Follow link to see a short demo video of CDM within a Citrix environment, link here.



Prerequisites :-

  • Cloud Drive Mapper Licence Key ( Obtained via IAM Cloud Portal / Support Team )
  • At least .net 4.8
  • Webclient Service installed and running. This is not installed by default on 2016 and above 


On shared servers where multiple users run sessions at the same time 

( Desktop Sessions / App Sessions ) then the following reg key is required within HKLM to this hive -  Computer\HKEY_LOCAL_MACHINE\SOFTWARE\IAM Cloud\CloudDriveMapper :



mastersettings = 256. This is a string value / reg_sz


REG ADD "HKLM\Software\IAM Cloud\CloudDriveMapper" /v "mastersettings" /t "REG_SZ" /d "256 " /f



Installation of CDM


Download the msi from here


The MSI can be pushed via MSIExec / GPO / SCCM etc in the same manner as any other MSI installer.

No special keys need to be pushed with the msi.


Details on using msiexec can be found here.


Once installed check the following location and delete any entries for Cloud Drive Mapper as we will need to start CDM as described further down:


HKLM\Software\Microsoft\Windows\Currentversion\Run

HKCU\Software\Microsoft\Windows\Currentversion\Run

Common start up - found here - run / shell:common startup 





Starting CDM


Unlike most other software CDM is required to authenticate in order to correctly map a users drives. It is therefore imperative that CDM is started in user context and not at an elevated cmd level.


Where CDM is to be used in an "app front-end" environment the user will have no interaction with the CDM application, it is therefore imperative that SSO ( SIngle Sign On ) be fully working in order for CDM to auto authenticate the user and map any drives required during the "app session"


We have found there are four different methods of starting CDM, in order of success we have found these to be :-

  1. Manipulate the Userinit reg key ( by far the most successful and widely used method )
  2. Batch file but targeting a specific user group
  3. GPedit ( via script )
  4. GPO to HKCU/run ( Least used method )


PLEASE NOTE - If you are using v2.21, then the path is - C:\Program Files\IAM Cloud\Cloud Drive Mapper Legacy


In depth explanation of the options above :-


1) Userinit method


The userinit key is located in the following location :-

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon


Here we will create a .bat file and refer to this from the UserInit key.


Normally the userinit key will have the following entry :- C:\Windows\system32\userinit.exe,

We will change this to be :- C:\Windows\system32\userinit.exe, "C:\Scripts\CDM\CDM.bat"


Within the cdm.bat file


:: Cloud Drive Mapper startup script
Start "" "C:\Program Files\IAM Cloud\Cloud Drive Mapper\CloudDriveMapper.exe" -r
exit 0


Where this is being run from a shared server and you do not wish for CDM to start for all users then Opt 2) below might be best suited.


2) Batch file via sched task

   

Where we do not want CDM starting for all users and the Ifmember section above isn't viable, then we can use a scheduled task to target our cdm.bat file, we will set the sched task to be run only for users of a specific security group.


See Images Below :-


General Tab

Set the section "When running the task........"    to be set against the specific security group.


Trigger Tab


At log on & Any User


Actions


Target our CDM bat file



Settings Tab


Make sure to set " Run a new instance in parallel "  <-- as we're running it for each user who logs on




3) GPedit Method


As above we will call the same cdm.bat file, except via the Logon/Logoff method as shown below:-

Note this is a LOCAL policy NOT GPO.





4) HKCU/Run GPO


Here we have created a security group CDMGrp and assigned the policy to that group with the following parameters :-


N/B :- Making sure to tick "Run in logged-on user's security context (user policy option)


Action :-     Update

Hive :-        HKCU

Key path :- Software\Microsoft\Windows\CurrentVersion\Run

Value Name :- Start-CDM

Value Type :- Reg_SZ

Value Data :- C:\Program Files\IAM Cloud\Cloud Drive Mapper\CloudDriveMapper.exe




Log off in a published app environment 


When a user disconnects from a published app, Cloud Drive Mapper may still keep running on the server. To ensure a full log off add clouddrivemapper.exe to the follow registry location:


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI

Value Name: LogoffCheckSysModules

Type: REG_SZ

String: CloudDriveMapper.exe



If you need any assistance please do not hesitate to contact support@iamcloud.com