In part 1 we went over how to upgrade the Netscaler to the new enchantment release. We also upgraded the device manager to 8.6. In this part we will be upgrading app controller from version 2.8 to 2.9. We will also look at the process for installing the worx apps on the app controller.
Important note about the new updated MDX Toolkit and Worx Home
There is one important note about the new app controller and the MDX Toolkit. If you wish to wrap the Worx apps (or any apps) using the new toolkit you need the latest version of the Worx Home installed on the device. At the time of me writing this guide the new version of Worx Home has not been released in the Apple or Google Play stores. Citrix has provided a direct download of the .apk for android devices but if you use this version you can’t auto update from the google play store. So it’s basically good for testing. If you use the new MDX toolkit to wrap apps and try to open them in earlier versions of Worx Home you will get an incompatibility error message.
On a secondary note – it is no longer required to use the MDX toolkit to wrap the application. You can just install the Worx apps right from the download with no wrapping required. That said, you do lose all of the policy control, as you can’t set those options without wrapping with the toolkit before adding them to the app controller.
Update App Controller from 2.8 to 2.9
1) Download the App Controller Upgrade from Acc C 2.8 to App C 2.9
2) Sign into the web admin console to the App Controller (by default it runs on port 4443)
3) Click on Settings > Release Management and click the “Upgrade” button.
4) Browse and select the BIN upgrade file you downloaded in step 1.
5) Click “Upload” and wait for the upload to finish and restart when prmopted.
6) Let it boot, login and check the configuration.
Citrix has also published new versions of both worx mail, worx web and sharefile for both iOS and Android devices. One of the new features they are providing with this upgrade is the ability to use the apps provided with no need to MDX wrap them with the toolkit but you’ll most likely want to. If you don’t wrap them you lose out on all the policy functionally.
I’m going to go over how to use the toolkit and wrap the applications but keep in mind you can’t use wrapped applications until you upgrade the Worx Home app and of this writing those are not aviable on the Apple or the Google Play store. There is a direct download for the Android version on Citrix’s Website for the newest Worx Home. You can download this file direct from an android device and install it manually. This is a good way to test but you will lose the ability for auto updates.
MDX Toolkit Notes
The Citrix MDX toolkit requires a Mac running OS X Lion, Mt. Lion or Mavericks. You will also need the correct version of Mac Dev tools (Xcode) and Command Line Developer Tools for Xcode for your version of Mac OS X. You can download Xcode from the app store on your Mac. The Command Line tools have to be downloaded and installed separate and requires an apple developer account.
1) Download and install the correct version of Xcode.
2) Download and install the current MDX Toolkit from the Citrix Website
3) Run the installer package on your Mac computer. It will put a “Citrix” folder in your applications folder. You can launch the app from there.
Before you can use the application there are some other things you need to do first. I’m going to break them down by platform.
Distributing Apps via App Controller for iOS Devices
If you want to wrap iOS apps to distribute via app controller. You need an iOS Developer Enterprise Program membership ($299/year).
Once you have your developer account you will need to log into the portal and generate a distribution certificate and provisioning profile. This is different than your APNS cert.
1) The first thing you will want to do is generate a CSR request from your Mac. Open your keychain (It’s in the applications > utilities folder) and Request a certificate from a Certificate Authority.
2) Fill out the user email name, Common name and CA Email address as you wish. Save the request to disk.
3) Now go to the Apple Developer site, Log in and go to the “Member Center” and Click on the Certificates, Identifiers & Profiles link.
4) Click the Certificates link
5) Click the + button on the iOS Certificates page.
6) Download and then install (open keychain access and drag it to the system keychain) the WWDR intermediate cert on your Mac. Select “In-House and Ad Hoc”and click continue at the bottom of the page.
7) Click Continue
8) Upload the CSR we created in steps 1-2 and Generate the Cert.
9) Once you generate the cert download it and install it (open keychain access and drag it into the login keychain).
10) On the left side under “Identifiers click “App IDs” and click the + button in the upper right hand corner.
11) Enter an App ID Description (Citrix App Wrapping is what I used), Select “Wildcard App ID” and enter a * in the Bundle ID Box. Note: This setting is because we are are going to be wrapping apps we did not develop in house (Worx apps in this example) then click Continue at the bottom of the page.
12) Verify all the info and submit it. Click Done once it’s been submitted.
13) On the left hand side click Distribution and click the + in the upper right hand corner
14) Select the App ID we created in steps 10-12 and click Continue
15) Select the Cert you created in steps 5-9 and click Continue
16) Name your provisioning profile and click Generate.
17) Download this file and save it on your Mac to a save location. You’ll need to keep this for wrapping apps with the MDX Toolkit.
Wrap iOS apps using the MDX Toolkit
We are now ready to start wrapping iOS Apps
1) Open the MDX Toolkit (citrix folder in the applications folder on your Mac)
2) Select “For IT administrators” and click Next
3) Select the ipa file for the Worx app you downloaded from the Citrix Web site you will be deploying and click Next.
4) Fill out the relevant details and click Next.
5) This step is where we will need that provisioning profile we made in the last section. Click Browse and select the provisioning profile file you downloaded in Step 17 of the previous section above. Once you select it the Cert field will auto populate. Click Create and save the MDX file to your Mac.
6) Click Finish and you are ready to upload your new wrapped MDX application to your app controller!
Wrap Android apps using the MDX Toolkit
There are few things you need on your Mac before you can use the MDX toolkit to wrap Android Apps. You need the Java Development Kit v1.7 and the Android ADT Bundle. I’ve included the following links for those that need to download and install these components:
Once you have these installed you can use the MDX Toolkit to wrap Android Apps.
1) Open the MDX toolkit, select for IT Administrators and then Next
2) Browse to the APK app file you are wrapping. If this is your first time wrapping an Android App you need to tell it the path to the Android SDK you downloaded.
3) Enter the relevant information about the Application.
4) check the “use debug keystore” box
5) select a location to save the MDX app and let it create.
6) Click Finish
You are now ready to upload the wrapped MDX app to your app controller.
Installing the MDX Wrapped App to the App Controller
1) Open up the web console to the App Controller.
2) Select the “Apps & Docs” Tab, on the left side select the Platform we are adding an App for.
3) Click the huge green + button and browse to the MDX file we created in the above steps.
4) After the file uploads fill out any details. I would not recommend changing the min OS version.
5) Click Next on the Workflow screen
6) On the Policies page customize the application how you require for your environment and click “Save”.
Your App is now hosted on the App Controller and users can download it via the Worx Home Application (assuming they are using the newest 8.6 version – see my notes earlier in this post).
I’m going to be working with some of the new features as soon as I can – mostly the SSO and cert based changes and will have something posted on these changes as soon as possible.
Thanks for reading, hope this was helpful!