How to deploy WorxMail and WorxWeb for Windows Phone 8.1
While upgrading our sepago XenMobile Environment to support WorxMail and WorxWeb for Windows Phone 8.1 i thought to write a blog post about this since its not easy to find all needed informations.
Let´s start with the prerequisites.
– You will need a Microsoft Developer Account. Register here http://dev.windows.com/
– A Symantec Enterprise Mobile Code Signing Certificate is required. This can be orderd athttps://products.websecurity.symantec.com/orders/enrollment/microsoftCert.do You can find your Symantec-Publisher-ID within your Microsoft Developer Account. Navigate to the Windows Phone Store Dashboard –> Account. Here should your Symantecd-ID be listed. After the ordering process is finished and you followed the instructions provided within the mails you will receive a *.pfx certificate.
– A Windows 8.1 64-bit computer is needed. Also .NET 4.5, Silverlight 5 Runtime, SDK and at least Visual Studio Express 2013 have to be installed.
– The following files from your MyCitrix Account have to be downloaded – MDX Toolkit for Windows Phone 8.1, WorxMail for Windows Phone 8.1 v9, WorxWeb for Windows Phone 8.1 v9 and Worx Home for Windows Phone 8.1 v9
– And of course a fully working XenMobile v9 Enterprise Environment.
If the prerequisites are complete we can finally start doing things
– At first we create a *.aetx file. This one is needed to configure the Windows Phone Enterprise Hub Policy within the Device Management. We need to open the Visual Studio Command Line as an Administrator. We navigate to C:\Program Files (x86)\Microsoft SDKs\Windows Phone\v8.1\Tools\AETGenerator and excute the following command “AetGenerator.exe “c:\Path\to\your\Symantec\Certificate.pfx” passwordforyourcertificate”. You should now find tree new files in the AETGenerator Directory. We only need the AET.aetx file.
– To create the Windows Phone Enterprise Hub Policy we also need to wrap the WorxHome App. We will stay in our Visual Studio Command Line an navigate to the Directory where the MDX Toolkit for Windows Phone 8.1 is located. Here we create two new Directorys. One for our unsigned apps and one for signed apps. You should put the three downloaded Apps from Citrix to the unsigned folder. To wrap the WorxHome App we will execute the following command:
C:\Path\to\the\MDXToolKit\CGAppPrepTool.exe -in:”C:\Path\to\the\unsignedappsfolder\WorxHome_18.104.22.168_Release_ARM.xap” -out:”C:\Path\to\the\signedappsfolder\WorxHome.xap” -C:”c:\Path\to\your\Symantec\Certificate.pfx” -verbose -resign -phonePublisherId:aaaaaaaa-bbbb-cccc-dddd- eeeeeeeeeeee -password:passwordforyourcertificate -mdmServerURL:https://xdm.domain.com/zdm
The phonePulisherId can be found within the Microsoft Developer Account: Login and navigate to Windows Phone Store Dashboard –> Account.
– Now we can create our Windows Phone Enterprise Hub Policy. Login with your Adminstrator Account to your MDM Server and create a new Windows Phone 8.x Enterprise Hub Policy. Enter a Name and if you want a Comment and upload the created AET.aetx und your wrapped WorxHome.xap file. Don´t forget to add the created Policy to a Deployment Package
– To use WorxMail and WorxWeb we also have to wrap them. But the command is this time a bit different since we have to add the MDX Policies. Within the Visual Studio CL we execute the following command for WorxMail
C:\Path\to\the\MDXToolKit\CGAppPrepTool.exe -in:”C:\Path\to\the\unsignedappsfolder\WorxMail_22.214.171.124_Release_ARM.xap” -out:”C:\Path\to\the\signedappsfolder\WorxMail.mdx” -T:”C:\Path\to\the\MDXToolKit\Templates\WorxMail” -C:”c:\Path\to\your\Symantec\Certificate.pfx” -password:passwordforyourcertificate -verbose -resign -phonePublisherId:aaaaaaaa-bbbb-cccc-dddd- eeeeeeeeeeee
and for WorxWeb
C:\Path\to\the\MDXToolKit\CGAppPrepTool.exe -in:”C:\Path\to\the\unsignedappsfolder\WorxWeb_126.96.36.199_Release_ARM.appx” -out:”C:\Path\to\the\signedappsfolder\WorxWeb.mdx” -T:”C:\Path\to\the\MDXToolKit\Templates\WorxWeb” -C:”c:\Path\to\your\Symantec\Certificate.pfx” -password:passwordforyourcertificate -verbose -resign -phonePublisherId:aaaaaaaa-bbbb-cccc-dddd- eeeeeeeeeeee
Make sure you copy the *.mdx file to a save place after you created them. With each new wrapping process the Preptool will emtpy the signed folder. You can upload both Apps now to your AppController and configure the MDX Policies as u used to.
– Finally you can enroll your Windows Phone. Citrix published a very nice Blog Article how to do thishttp://blogs.citrix.com/2014/07/03/windows-phone-8-1-device-enrollment-process-xenmobile-9-0/. But other mentioned in the Citrix Blog Auto Discover is not needed for this. We are the living proof
Thanks for reading