GGV Elements: Video Service Release 10.5.0

1. Release 10.5.0 Video Service

2. GGV Elements • ACPU Processor 2 includes below elements, • Content Loader : LRU which used to transfer media content to ACPU HDD/SSD from USB Sticks • Content Server (CS): Tomcat webserver that shall deliver http video to the gogo Wi-Fi client. • Content Manager (CM): The Content Manager shall audit the CS and provide alerts and metrics wrt content. • DRM (Widevine/ Adobe) Server VM • Individualization server VM • Wallet server VM • IPTV Container VM

3. Modules in GGV • Content Management • Batch Synchronization • Audit Functionality • Mini-Audit • Full-Audit • Content Sync • App Package • Content Package • Catalog.xml • Rules.xml • Ground Configuration JSON file • Package Sync Service (PSS) • Airborne Portal Service (ASP) • Valid Media list creation • IFE Browsing • Free video • Movie Purchase

4. Changes from previous release • Earlier service video service process is based on journal xml file now moved to DB based for processing speed. • Batch Sync status file also changed to DB file • IFE Control is also maintained a separate Ground configuration as IFE is enabled or disabled on corresponding flight phase with country code. This JSON file is loaded/updated via Content package.

5. Content Management • Content Manager is doing media download from USB which are connected in CL Device to ACPU. • Medias download based on file size and media rank • Media files are downloaded to ACPU from USB during Batch sync based on SSDs space availability. • /mnt/media/media should have valid soft links to the media directories under mnt/media1/media and /mnt/media2/media.

6. Mini-Audit • Mini-auditis performed on every P2 reboot. During mini-audit ACPU calculates the size of media files available under /mnt/media1/media and /mnt/media2/media and compares with mediaFileSize in acpu_v2.journal. • If both the size matches then “miniAuditStatus” is updated as “success” else it will be updated as “Failure”. Mini-audit status will be set to “NotStarted” before mini-audit

7. Full-Audit • Full-audit is performed for every 50th P2 reboot. During full-audit ACPU calculates size and md5sum of media files under /mnt/media1/media and /mnt/media2/media and compares with md5sum in acpu_v2.journal [.ts files md5sum will be compared with md5sum in md5.mf file]. • “FullAuditStatus” will be updated as “success “ when calculated md5sum matches with md5sum in acpu_v2.journal [md5.mf file] else it will be updated as “Failure”. Full-audit status will be set to “Not Started” before full-audit.

8. Full-Audit (continued…) • Full audit is not performed for media files with mini-audit status “Failure”. • Full-audit status will be set to “Not Started” before full-audit. • Full-Audit is configured in acpu_v2.conf • MD5sum Check is configured in acpu_v2.conf

9. Batch Synchronization • The batch synchronization process perform by the ACPU Content Manager also utilizes the acpu_v2.journal to manage the media file transfers from USB to disk • Batch Sync will be trigged in below conditions • When new USB is inserted • When USB of higher batch version is inserted • On P2/ACPU reboot • Journal Recovery: • ACPU stores mf and journal file in /var/abs/FCC/config/acpu/java/video for backup. If journal file is corrupted in /mnt/media/media ACPU is processed journal file from /var/abs/FCC/config/acpu/java/video • The ACPU as part of the journal recovery process shall process those media entries within the acpu_v2.mf in order by ascending media rank (“<mediaRank>”).

10. Batch Synchronization • Complete -> “transferStatus” is updated as “Complete” in acpu_v2.journal when tar file extraction is successful, size and md5sum of all files matches with size and md5sum in acpu_v2.mf file and md5sum of all .ts files matches with md5sum in md5.mf file. • Failure -> “transferStatus” is updated as “Failure” in acpu_v2.journal when tar file Extraction fails, size or md5sum of tar file does not match with size and md5sum value in acpu_v2.mf or media files not present in USB. • Incomplete -> “transferStatus” is updated as “Incomplete” in acpu_v2.journal when tar file extraction is successful but size or md5sum mismatch for few .ts files or .ts file count in tar file is less than the “quantity” in acpu_v2.mf file. • InProgress -> “transferStatus” is updated as “InProgress” during media file download.

11. Batch Synchronization (continued…) • NotStarted -> transferStatus” is set to “NotStarted” before starting media file download. • NotAvailable -> “transferStatus” is updated as “NotAvailable” in acpu_v2.journal when media partition sda3 or sdb3 gets corrupted. • Batch Sync Status in BatchSyncStatus.properties file: • BS_NEW_USB(0, "NEW USB"), • BS_NOT_STARTED(1, "NOT STARTED"), • BS_INPROGRESS(2, "IN PROGRESS"), • BS_FAILURE(3, "FAILED"), • BS_COMPLETE(4, "COMPLETED"), • BS_ABORTED(5,"ABORTED"), • UNKNOWN(-1, "UNKNOWN");

12. Content Sync • Place updated app and config packages in video server in tail specific directory with correct md5sum and Reboot ACPU P2 • Updated app and config packages are pulled from video server server during Content Sync. • Content Sync is triggered for every 30 minutes by ASP. Duration is configured in /var/abs/FCC/util/apache_tomcat-7.0.42/webapps/asp/WEB-INF/classes/asp.propertiesfile • If md5sum of current.properties matches with current.properties.md5 contents ASP takes app and config version from current.properties and tries to download corresponding app and config packages from video.gogoinflight.com. • On P2 bootup, If the app and Config files are not present, then ACPU will start content sync process immediately after link up. This is called Immediate update. ACPU downloads these files and installs immediately irrespective of flight state.

13. Content Sync (continued…) • If valid app and config packages are available in ACPU extraction will be done in Ground state. • Once download completes app and config packages gets extracted to extract_app and extract_config folders. /mnt/media/FCC/config/asp/app and /mnt/media/FCC/config/asp/config will have soft link to extract_app and extract_config folders respectively.

14. Available Medias • The Medias which are displayed to user will be logged in /var/log/tomcat/video.log as below • Total media count is logged in asp.log • Valid media list is created based on below files • Acpu_v2.journal • Catalog json file • Rules.xml • Productpricelist.xml

15. DRM and Wallet • Inside ACPU2, two VMs are running they are DRM and Wallet • DRM is a license server which will determine whether movie is licensed or not • When user clicks on any movie, APP will try to fetch the DRM Key for the media. If the key is not available, user will not be able to play the movie. • Individualization server is a process running inside DRM which will get track of the User device information (MAC etc) and stores in it. This process will happen for any new devices trying to play the movie. • Application of the Wallet VM is to store the credit card details of the user in Autonomous mode (Where link and GBP are not available) • On Linkup, Wallet will transfer these credit card details to ground

16. PSS • Updated Certificate package will be downloaded to ACPU from ground video server during Package Sync. • Package Sync will be triggered for every 30 minutes. Duration is configured in PSS.conf file [PACKAGE_SYNC_DELAY] • To change Package Sync duration we can edit “PACKAGE_SYNC_DELAY” parameter value in PSS.conf • Packages are placed under /mnt/media/media/FCC/PSS/

17. PSS (continued…) • ACPU P2 logs are logs related to PSS in PSS.log • #tailf/var/log/PSS/PSS.log] • Steps: • Verify that ACPU downloads package_list.xml. • Verify that ACPU downloads packages from video server based on name present in package_list.xml file.

18. PSS (continued…) • Check downloads folder where updated packages are downloaded • Check PSS.log for those downloaded packages are verified and activated • Packagesyncstat.xml file will be updated after activation of updated packages

19. IFE Provisioning in GS • IFE Service is enabled based on System type/Airline/Country code/flight phase/altitude • Even though ACPU is having valid movie list and Autonomous mode is enabled, ACPU disabled/enabled IFE service based on Ground Configuration • Continuous play back at ASA feature which is introduced in R10.3 is not valid from R10.4 onwards

20. IFE Enabled • After valid media list formed, we can check IFE enabled or not in acpi.log • Valid updated video plugin content bundle needs to be installed • Valid whitelist content bundle needs to be installed • IFE should be enabled in ife_service_activation_rules.json for corresponding country code and flight phase

21. IFE Re-direction • Connect VLAN 11 SSID when PAX SSID is enabled for corresponding country code • Browse any non-whitelisted URL it will get re-directed to splash page. • Click on ENTRERTAINMENT link in splash page. It will be re-directed to airbornemedia.gogoinflight.com/app/<airline>/ife/#splash

22. Movie play • Click on any movie bxt image • It will show BUY button if it is rented movie with PLAY button • Else PLAY button only is displayed • Click on BUY button It will redirected to airbornewallet.gogoinflight.com to purchase that movie • After purchase completed, Click PLAY button to play movie.

23. Movie play-vlan11 • Enjoy the Movie   

24. Any queries??? Engineering Excellence. Sourced.

25. THANK YOU Engineering Excellence. Sourced.

26. Revision History