Installation Guide - Mac

Transcription

1 Installation Guide - Mac Release 7.0 Beta Document Relevance and Accuracy This document is considered relevant to the Release stated on this title page and the document version stated on the Revision History page. Remember to always view and download the latest document version relevant to the software release you are using by Kony, Inc. All rights reserved 1 of 59

2 Kony Studio Installation Guide - Mac Copyright 2013 Kony, Inc. All rights reserved. January, 2016 This document contains information proprietary to Kony, Inc., is bound by the Kony license agreements, and may not be used except in the context of understanding the use and methods of Kony, Inc., software without prior, express, written permission. Kony, Empowering Everywhere, Kony Modeler, and Kony Visualizer are trademarks of Kony, Inc. MobileFabric is a registered trademark of Kony, Inc. Microsoft, the Microsoft logo, Internet Explorer, Windows, and Windows Vista are registered trademarks of Microsoft Corporation. Apple, the Apple logo, itunes, iphone, ipad, OS X, Objective-C, Safari, Apple Pay, Apple Watch, and Xcode are trademarks or registered trademarks of Apple, Inc. Google, the Google logo, Android, and the Android logo are registered trademarks of Google, Inc. Chrome is a trademark of Google, Inc. BlackBerry, PlayBook, Research in Motion, and RIM are registered trademarks of BlackBerry. SAP and SAP Business Suite are registered trademarks of SAP SE in Germany and in several other countries. All other terms, trademarks, or service marks mentioned in this document have been capitalized and are to be considered the property of their respective owners by Kony, Inc. All rights reserved 2 of 59

3 Kony Studio Installation Guide - Mac Revision History Date Document Version Description of Modifications/Release 01/13/ Updated for 7.0 Beta. 07/10/ Updated for 6.5 release. 01/09/ Document updated with ios Buid Options. 12/11/ Updated for 6.0 release by Kony, Inc. All rights reserved 3 of 59

4 Kony Studio Installation Guide - Mac Table of Contents 1. Preface Purpose Intended Audience Formatting conventions used in this guide Contact Us 8 2. Prerequisites Software Requirements 9 3. Installing Kony Studio Prerequisites Get your Mac ready for Studio Installation Procedure Launching Kony Studio Downloading Android SDK and APIs Adding Android Emulator Downloading ios SDK Uninstalling Kony Studio Upgrade Kony Studio Upgrade to latest version of Kony Studio Troubleshoot Error Message Appendix A: Switching the Workspace by Kony, Inc. All rights reserved 4 of 59

5 Kony Studio Installation Guide - Mac 11. Appendix B: Configuring NTLM Authentication Appendix C: Frequently Asked Questions (FAQs) by Kony, Inc. All rights reserved 5 of 59

6 1. Preface Kony Studio Installation Guide - Mac 1. Preface Kony Platform provides an integrated approach in the design, development and management of mobile applications. The Platform facilitates the design and development of mobile applications in a device independent manner and delivers them in different formats that run on all the major device platforms. The Kony Platform consists of three main components: Kony Studio: IDE for developing mobile applications. Gradle Gradle is an advanced build toolkit that manages dependencies and allows to define custom build logic. ImageMagick: Generates background images from the skin attributes (applicable for Mobile Web only). For example, the basic version of XHTML does not support gradient backgrounds. To overcome this limitation, use ImageMagick to create a gradient background image. 1.1 Purpose This document explains how to install Kony Platform, including Kony Studio, Kony Server and additional software on your Mac OSX using an installer. To perform a manual installation, see the Kony Studio Installation Guide (Manual Installation). 1.2 Intended Audience This document is intended for engineers or developers who are responsible for installing and configuring Kony Studio. We assume that the reader of this document is familiar with installing applications in a Mac environment. 1.3 Formatting conventions used in this guide Following are the formatting conventions used throughout the document: 2015 by Kony, Inc. All rights reserved 6 of 59

7 1. Preface Kony Studio Installation Guide - Mac Conventions Explanation Monospace User input text, system prompts, and responses File path Commands Program code File names Italic Emphasis Names of books and documents New terminology Bold Windows Menus Buttons Icons Fields Tabs Folders URL Active link to a URL. Note Provides helpful hints or additional information. Important Highlights actions or information that might cause problems to systems or data by Kony, Inc. All rights reserved 7 of 59

8 1. Preface Kony Studio Installation Guide - Mac 1.4 Contact Us We welcome your feedback on our documentation. us at techpubs@kony.com. For technical questions, suggestions, comments or to report problems on Kony's product line, contact productsupport@kony.com by Kony, Inc. All rights reserved 8 of 59

9 2. Prerequisites Kony Studio Installation Guide - Mac 2. Prerequisites Read this section to understand the system requirements and necessary software before installing the Kony Studio. 2.1 Software Requirements Operating System Mac OS X version 10.7 and above Software Requirement JDK bit installed with the Studio. (Minimum supported: JDK 1.7.0_25) (Mandatory) KonyStudioSetup.app Installer File (Mandatory) Android SDK and Emulators (Optional) Note: Xcode 6.1 does not support IPA file generation with Kony Studio Hardware Requirements Component Requirement Processor x86-64 CPU (64-bit Macs, with an Intel Core 2 Duo, Intel Core i3, Intel Core i5, Intel Core i7, or Xeon processor.) Memory 4 GB Internal Storage 150 GB Network Ethernet Port 2015 by Kony, Inc. All rights reserved 9 of 59

10 2. Prerequisites Kony Studio Installation Guide - Mac Install Java Development Kit A Java Development Kit (JDK) provides the Java run-time environment (the Java Virtual Machine, or JVM) and tools for compiling and debugging Java applications. The Java Virtual Machine is required for Java applications to interpret the Java byte code so that the Java application can be run. The recommended JDK is "Java SE Development Kit 7" Update 67, which is installed automatically when Kony Studio is installed. The minimum supported JDK is Java SE 7 update 25. Note: After installing Kony Studio and if you upgrade to Mac OS Yosemite, you will be prompted to install Java. Ensure you install Java before working with Kony Studio by Kony, Inc. All rights reserved 10 of 59

11 3. Installing Kony Studio Kony Studio Installation Guide - Mac 3. Installing Kony Studio The Kony Studio installer package consists of the following modules: Kony Studio The Kony Studio IDE for developing mobile applications. Gradle Gradle is an advanced build toolkit that manages dependencies and allows to define custom build logic. ImageMagick ImageMagick generates background images from the skin attributes (applicable for Mobile Web only). For example, the basic version of XHTML does not support gradient backgrounds. To overcome this limitation, use ImageMagick to create a gradient background image. Download Kony Studio Installer from the community portal to a location on your machine. 1. Kony Studio 2. Visualizer plug-in for Adobe Photoshop 3.1 Prerequisites Administrative rights on your computer to install Kony Studio. Select Anywhere option in Security & Privacy > General settings. The default installation folder for Kony Studio is /Applications/Kony. During the installation, you can choose a different location if you wish. Ensure that there is at least 2 GB of space available in the system drive where you install Kony Studio. HTTP (direct or proxy) access during the installation process. The /Applications/Kony/_Kony Studio_installation\Logs directory contains the log files documenting each invocation of the installer or uninstaller. Provide these log files to Kony when reporting an issue to help expedite issue identification. In case the installation is canceled, the logs are generated on the desktop by Kony, Inc. All rights reserved 11 of 59

12 3. Installing Kony Studio Kony Studio Installation Guide - Mac 3.2 Get your Mac ready for Studio 7 To get your Mac ready for Studio 7, follow these steps: 1. Open terminal and run the following commands sudo cpan install JSON sudo cpan install Log::Log4perl 3.3 Installation Procedure To install Kony Studio using the installer, follow these steps: 2015 by Kony, Inc. All rights reserved 12 of 59

13 3. Installing Kony Studio Kony Studio Installation Guide - Mac 1. Navigate to the location where you downloaded the Kony Studio installer file. 2. Double-click KonyStudioSetup file. The Kony Studio installer dialog appears by Kony, Inc. All rights reserved 13 of 59

14 3. Installing Kony Studio Kony Studio Installation Guide - Mac 3. Click Next. The License Agreement page appears. 4. Select I accept the terms of the License Agreement to accept the license agreement. 5. The installer automatically detects the Android SDK version. Change the Android SDK Home using Choose... button by Kony, Inc. All rights reserved 14 of 59

15 3. Installing Kony Studio Kony Studio Installation Guide - Mac 6. Ensure the information in Prerequisites page is correct and click Next. The installer checks availability of the required programs and their versions in this stage of installation. a. Type or choose the Android SDK location in Android SDK Home box. b. If SDK is not present in the provided path, an Invalid SDK Path dialog appears. 7. Click Proceed to continue without installing Android SDK. The Download Sources screen appears by Kony, Inc. All rights reserved 15 of 59

16 3. Installing Kony Studio Kony Studio Installation Guide - Mac 8. Download the Android SDK from the hyperlink or click Next to proceed with the installation. The Choose Install Folder screen appears. 9. Click Choose and select a destination folder to install Kony Studio. By default, the location is set to Application/Kony folder by Kony, Inc. All rights reserved 16 of 59

17 3. Installing Kony Studio Kony Studio Installation Guide - Mac You can also restore the installation folder to the default location using Restore Default Folder option. 10. Click Next. The Pre-Installation Summary appears by Kony, Inc. All rights reserved 17 of 59

18 3. Installing Kony Studio Kony Studio Installation Guide - Mac 11. Review the information in Pre-Installation Summary page and click Install by Kony, Inc. All rights reserved 18 of 59

19 3. Installing Kony Studio Kony Studio Installation Guide - Mac 12. After the installation is complete, the Proxy Settings page appears. In case you are running behind a proxy server, perform configuration steps by reading the information in Configure Proxy hyperlink by Kony, Inc. All rights reserved 19 of 59

20 3. Installing Kony Studio Kony Studio Installation Guide - Mac 2015 by Kony, Inc. All rights reserved 20 of 59

21 3. Installing Kony Studio Kony Studio Installation Guide - Mac 13. Click Next. The Install Complete page appears. 14. Select Launch KonyStudio option and click Done. The Kony Studio application launches and a shortcut icon will be placed on desktop by Kony, Inc. All rights reserved 21 of 59

22 4. Launching Kony Studio Kony Studio Installation Guide - Mac 4. Launching Kony Studio The installer creates shortcuts to the Kony Studio IDE on the desktop and in the install folder. You can launch Kony Studio using either shortcut. To launch Kony Studio, follow these steps: 1. Double-click the Kony Studio shortcut on the desktop. Note: You could also navigate to the folder where Kony Studio is installed and double-click Kony Studio shortcut to launch Kony Studio. 2. Kony Studio prompts to provide your desired Workspace folder location to use. Select your path and click OK. A workspace is a folder on the hard drive, which is a central repository of all application files. The applications you create in the IDE are saved in the workspace. The default workspace has a sample application. The default workspace is Home/KonySampleApps. It is recommend that you choose this workspace if you are a new user. 3. After Kony Studio is launched, the following pop-up messages might appear: 2015 by Kony, Inc. All rights reserved 22 of 59

23 4. Launching Kony Studio Kony Studio Installation Guide - Mac To accept the incoming network connection, click Allow. If command line tool is not installed, the following pop-up appears. To install command line build tools, click Install. 4. If you have not provided the license details during installation, the following dialog appears: 2015 by Kony, Inc. All rights reserved 23 of 59

24 4. Launching Kony Studio Kony Studio Installation Guide - Mac a. You can either provide the Kony Cloud credentials or select a license(.lic) file in this dialog to login to Kony Studio. Kony Login - If you choose this option, enter your Username and Password that you created on the Kony Cloud portal and click Next. License - If you choose this option, browse and select your *.lic file path that you received and click Next. 5. If you have selected the license file option, accept the license agreement and click Next. The Enter Customer Details page appears. 6. Provide the information and click Next. The license is validated and Registering License page appears by Kony, Inc. All rights reserved 24 of 59

25 4. Launching Kony Studio Kony Studio Installation Guide - Mac 7. Click Finish. Kony Studio launches with a sample application by Kony, Inc. All rights reserved 25 of 59

26 5. Downloading Android SDK and APIs Kony Studio Installation Guide - Mac 5. Downloading Android SDK and APIs Mobile applications that are developed in Kony Studio need to be tested for appearance and performance. To do this, you need device emulators. These emulators are provided by the device manufacturers or mobile platform vendors. This topic provides information on the following areas: 1. Download Android SDK 2. Download Android APIs To download the Android SDK, follow these steps: 1. Navigate to Android Developers site. 2. Scroll down the page and click VIEW ALL DOWNLOADS AND SIZES. Available downloads appear by Kony, Inc. All rights reserved 26 of 59

27 5. Downloading Android SDK and APIs Kony Studio Installation Guide - Mac 3. In the SDK Tools Only section, click the package link of Mac OS X 32 & 64-bit. The Terms and Conditions page appears. 4. If you agree to the Terms and Conditions, select the I have read and agree with the above terms and conditions check box. 5. Click Download android-sdk_<version>-macosx.zip option. The android-sdk_ <version>-macosx.zip file is downloaded to the Downloads folder. 6. Unpack the compressed file and make a note of the location of the SDK directory. 7. If you are on the installer, provide the extracted android-sdk_<version>-macosx folder path (For example: /Home/Downloads/android-sdk_<version>-macosx) in the Android SDK Home and click Next. Click here to continue with installation. To download the APIs from the Android SDK Manager, follow these steps: 2015 by Kony, Inc. All rights reserved 27 of 59

28 5. Downloading Android SDK and APIs Kony Studio Installation Guide - Mac 1. Open a Terminal and navigate to the tools/ directory in the android-sdk_ <version>-macosx folder, then execute android file. For example: /Home/Downloads/android-sdk_<version>-macosx/tools a. Alternatively, navigate to the folder where you have downloaded the Android SDK. Navigate to Tools folder and double-click Android file. A security exception appears. 2. Click Open. The Android SDK Manager window appears by Kony, Inc. All rights reserved 28 of 59

29 5. Downloading Android SDK and APIs Kony Studio Installation Guide - Mac 3. In Android SDK Managerwindow, select the required APIs and click Install Packages. The Choose Packages to Install dialog appears by Kony, Inc. All rights reserved 29 of 59

30 5. Downloading Android SDK and APIs Kony Studio Installation Guide - Mac 4. Click the head of the each package and click the Accept License option. 5. Click Install. The Android SDK Manager downloads all the selected packages and installs on your machine by Kony, Inc. All rights reserved 30 of 59

31 6. Adding Android Emulator Kony Studio Installation Guide - Mac 6. Adding Android Emulator The Android SDK installed in Eclipse does not include any preconfigured Android Virtual Devices (AVDs). When you want to run any application on the Android emulator, you need to create an AVD. AVDs are configuration options that let you simulate the Android mobile device in an efficient manner. You can create as many AVDs as per your requirement and map them to the emulator. Every AVD you create consists of the following: A set of hardware options and configurations that define the features on the emulator. Android platform; this can be standard Android platform or the one that comes with the Android SDK. Skin options that control the visual aspects of the emulator like screen dimensions, appearance, and so on. A dedicated storage area on your local machine. For more information about AVD, see To add an Android emulator for mobile, follow these steps: 1. Go to Emulators view. 2. Right-click Mobile under Android and select Add by Kony, Inc. All rights reserved 31 of 59

32 6. Adding Android Emulator Kony Studio Installation Guide - Mac The Emulator Info window appears. Note: Kony Studio allows you to specify command line options for Android emulators. The command line options govern the way the emulator is displayed. For more information, see by Kony, Inc. All rights reserved 32 of 59

33 6. Adding Android Emulator Kony Studio Installation Guide - Mac 3. Enter a name for the emulator in the Name field. 4. Browse for the location of the pre-defined emulator under Location field. 5. Enter a name for the Android virtual device in the AVD Name if there is an AVD already created. Click Create AVD if you want to create a new AVD with the name you have entered. For more information about creating AVDs, see Note: The Create AVD button is enabled only when you select the location of the emulator and enter a name for the AVD. Creating a new Android Virtual Device To create a new Android Virtual Device, click Create AVD. The Android Virtual Device Manager dialog appears by Kony, Inc. All rights reserved 33 of 59

34 6. Adding Android Emulator Kony Studio Installation Guide - Mac i. Click New. The Create new Android Virtual Device (AVD) appears. ii. Enter a Name for the AVD. This name should match the name you have entered in the above step. iii. Select the Target. The target can be: Android API Level 3 Android API Level 4 Google APIs (Google Inc.) - API Level 3 Google APIs (Google Inc.) - API Level 4 Note: The target must be Google APIs of the required Android API level. For more information about API levels, see by Kony, Inc. All rights reserved 34 of 59

35 6. Adding Android Emulator Kony Studio Installation Guide - Mac iv. Browse and select the location of the SD Card. v. Select a Skin for the AVD if required. vi. Click Create AVD. 6. Enter the Command Line Arguments to launch this emulator. For more information about command line arguments for emulators, see 7. Click Finish. Kony Studio creates a new Android emulator and it appears under the list of emulators by Kony, Inc. All rights reserved 35 of 59

36 7. Downloading ios SDK Kony Studio Installation Guide - Mac 7. Downloading ios SDK Apple Xcode application helps you to develop applications for iphone or ipad. To install Xcode, follow the link: If you install the Xcode, the emulators and SDKs are pre-configured. You do not have to make any changes on the Mac machine. Viewing applications on the ios Simulator You can view applications in an ios Simulator through Xcode. In Xcode you can launch ios Simulator and then test applications on iphone or ipad. 1. Launch Xcode and open a project. 2. Click Xcode > Open Developer Tool > ios Simulator to launch the ios Simulator. The ios Simulator appears. 3. In ios Simulator, click Hardware > Device > iphone Retina (4 - inch). The ios Simulator works in iphone mode. The application runs in iphone 5 full mode where the application occupies the complete screen. iphone 5 is a 4 inch device with 1136 x 640 resolution. This gives an extra vertical space for the applications, while the width of the screen remains the same as that of old iphone devices. All existing applications will work on iphone 5 without any issues in compatibility mode (letterbox mode) where the extra vertical space is filled with a black patch on top and bottom of the screen. Applications look good in the compatibility mode and function as they would on other iphone devices. Note: For building, running, and testing the applications use Xcode and ios simulator. Using Xcode is mandatory for testing the applications on iphone 5 in full compatibility mode by Kony, Inc. All rights reserved 36 of 59

37 8. Uninstalling Kony Studio Kony Studio Installation Guide - Mac 8. Uninstalling Kony Studio This section explains the procedure to uninstall Kony Studio. Important: In the current release, the uninstaller is not getting created in Mac OS. This is a known issue. Workaround to uninstall Kony Studio: 1. Deactivate the license using Kony Studio or Licensing Tool. 2. Delete the install directory manually. 3. Restart the machine. To uninstall Kony Studio, follow these steps: 1. Navigate to Applications > Kony, and double-click Uninstall. The Uninstall Kony Studio pane appears by Kony, Inc. All rights reserved 37 of 59

38 8. Uninstalling Kony Studio Kony Studio Installation Guide - Mac 2. Click Uninstall. The Uninstall Confirmation pane appears. 3. Click OK. The License Deactivation pane appears. 4. Click YES to deactivate the license or click NO to retain the license on the current system. The Uninstall Kony Studio progress pane appears by Kony, Inc. All rights reserved 38 of 59

39 8. Uninstalling Kony Studio Kony Studio Installation Guide - Mac 5. After the uninstallation is complete, the Uninstall Complete page appears by Kony, Inc. All rights reserved 39 of 59

40 8. Uninstalling Kony Studio Kony Studio Installation Guide - Mac Note: The uninstaller cannot remove the files or directories that were not installed or copied by the installer. These files or directories are created as you use Kony Studio (for example, log files and corresponding directories). You can manually delete those files or directories to complete uninstalling Kony Studio. 6. Click Done and restart the machine by Kony, Inc. All rights reserved 40 of 59

41 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 9. Upgrade Kony Studio This section explains how to upgrade Kony Studio. Before you start make sure: You are connected to Internet. Your current licence is still valid to upgrade Kony Studio. You have valid credentials to access the Kony Developer Portal. Important: - Upgrading from previous versions of Kony Studio to Studio 7 is not possible through the plugins. You must use the latest Studio 7 installer to upgrade from Kony Studio. - If you have already installed Kony Studio by manually copying the plug-ins to the dropins folder, ensure you delete all the plug-ins in the dropins folder before upgrading Kony Studio. - You can revert to older version if you find some feature is not working as expected after upgrading to the latest version. 9.1 Upgrade to latest version of Kony Studio To upgrade Kony Studio: 1. Open Kony Studio. 2. To know the license information, click Help > About Kony License by Kony, Inc. All rights reserved 41 of 59

42 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 3. On the Help menu, click Install New Software. 4. The Install dialog appears. Click Add button in the Work with area by Kony, Inc. All rights reserved 42 of 59

43 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 5. The Add Repository dialog appears. Enter a descriptive name for the update site (such as Kony Updatesite). Enter the following URL in the Location box: Click OK. Click here if you get the below error message. 6. The Login required dialog appears asking for login credentials of the update site. Use your Kony Developer Portal credentials to enter Username and Password and click OK by Kony, Inc. All rights reserved 43 of 59

44 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 7. After successful authentication, the Install dialog box re-displays, and shows any available plugins. Note: For example, if you are using GA plugins and want to upgrade to GA plugins, but if Kony has already released GA plugins, then GA plugins will display by Kony, Inc. All rights reserved 44 of 59

45 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 8. To display all the plugins available for a particular platform, unselect Show only the latest versions of available software. For example, if Android's latest plugin is GA, then all the plugins GA, GA, and GA will display. 9. Expand each item, select the required plugins and click Next. The Install Details dialog box appears. Review the displayed plugins. You can use the Back button to change the selection. 10. Click Next to continue. If you get an error message as "Cannot complete the install because of a conflicting dependency", click Back button and select all features and click Next by Kony, Inc. All rights reserved 45 of 59

46 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac Note: Platform features will have interdependency that may conflict with your existing plugins. In those situations, the error message displays. 11. The Install Review Licenses dialog box appears. Review the Kony Solutions License Agreement. Click I accept the terms of the license agreement and click Finish by Kony, Inc. All rights reserved 46 of 59

47 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 12. The Installing Software window appears showing you the progress of the installation. 13. During the installation process, a Security Warning window appears asking for the authenticity of the software being installed. Click OK by Kony, Inc. All rights reserved 47 of 59

48 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 14. After the installation is completed, a confirmation window appears to restart Kony Studio for the changes to take effect. Click Restart Now to restart Kony Studio. 9.2 Troubleshoot Error Message While adding repository you may sometimes encounter the below error message. This message occurs when duplicate locations are entered or login credentials are not entered for location in the first instance. If you get the error message, follow the below steps to resolve: 1. On the Install dialog, click "Available Software Sites" link by Kony, Inc. All rights reserved 48 of 59

49 9. Upgrade Kony Studio Kony Studio Installation Guide - Mac 2. The Preferences dialog appears. 3. Select the entry from the Available Software Sites and click Remove. Make sure you do not have duplicate entries of the Location. If you still encounter the error message, close Kony Studio and start again. When you solve the error message, continue with step by Kony, Inc. All rights reserved 49 of 59

50 10. Appendix A: Switching the Workspace Kony Studio Installation Guide - Mac 10. Appendix A: Switching the Workspace Workspace is a folder on the hard drive, which is a central repository of all application files. The applications you create in the IDE are saved in the workspace. A workspace can have any number of applications. When you install Kony Studio, a workspace with the name KonySamplesApps is automatically created in /Home/<User Folder> folder on your machine. If needed, you can create your own workspace and switch to the new workspace. To create or switch a workspace, follow these steps: 1. Create a folder on any drive of your machine. For example: /Home/Myworkspace. Note: Create the new workspace folder name without any spaces. 2. Open Eclipse. 3. Select File > Switch Workspace. 4. Click Browse and choose the newly created workspace folder or any other workspace folder located on the hard drive. 5. Click OK. Eclipse restarts and opens with the newly selected workspace by Kony, Inc. All rights reserved 50 of 59

51 11. Appendix B: Configuring NTLM Authentication Kony Studio Installation Guide - Mac 11. Appendix B: Configuring NTLM Authentication If you have NTLM authentication configured at your proxy, you need to add the following configurations in Kony Studio. To add NTLM configurations, follow these steps: 1. Navigate to the folder where Kony Studio is installed. For example, <Install Drive>:\Kony\Kony_Studio. 2. Edit the file eclipse-orig.ini and add the following lines at the end of the file: -Dcom.kony.authentication.ntlm.ads.ws=<location of active directory server) -Dkony.http.proxyHost : <proxy ip address> -Dkony.http.proxyPort : <proxy port> -Dkony.http.proxyUser : <proxy Username> -Dkony.http.proxyPassword : <proxy password> -Dkony.proxy.authentication.mode : NTLM Add the following sample content after adding the above lines: -startup plugins/org.eclipse.equinox.launcher_1.1.0.v jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_ v product org.eclipse.epp.package.rcp.product --launcher.defaultaction openfile --launcher.xxmaxpermsize 256M 2015 by Kony, Inc. All rights reserved 51 of 59

52 11. Appendix B: Configuring NTLM Authentication Kony Studio Installation Guide - Mac -showsplash org.eclipse.platform --launcher.xxmaxpermsize 256m --launcher.defaultaction openfile -vmargs -Dosgi.requiredJavaVersion=1.5 -Dcom.kony.authentication.ntlm.ads.ws=proxytestserv. platformtest.kony.internal -Dcom.kony.authentication.mode=NTLM -Dhttp.proxyHost= Dhttp.proxyPort=8800 -Dhttp.proxyUser=UserName -Dhttp.proxyPassword=Password Note: If authentication mode attribute is not specified or left empty, the Kony Server falls back to the default authentication mechanism. Note: After the user is authenticated from the server, the NTLM connection is re-used and the server continues to serve the incoming requests until the password of the user is changed in the Active Directory server by Kony, Inc. All rights reserved 52 of 59

53 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac 12. Appendix C: Frequently Asked Questions (FAQs) This appendix explains a few Frequently Asked Questions (FAQs) and answers. Studio displays improper Workspace Error You may encounter this issue when you accidentally click on the launch button twice. An Improper Workspace error is displayed as two instances try to access the same workspace. To resolve the error, close the error window and any other related window that is open and re-launch Eclipse. "Kony" not visible in Open Perspective window during the installation of Kony Studio. Kony Studio perspective does not show up in the Open Perspective window if com.pat.soapui_x.x.x plug-in is not available in the plugins/dropins folder of Eclipse. Ensure that the plug-in is available in the plugins/dropins folder of Eclipse. Kony Studio Crashes - Eclipse "OutOfMemoryError" This error is caused if insufficient memory is allocated to the Eclipse instance. This can be solved by increasing the max heap size allocated to Eclipse. To assign additional memory, follow these steps: 1. Navigate to the Kony Studio installation folder. 2. Right-click Eclipse icon and click Show Package Contents by Kony, Inc. All rights reserved 53 of 59

54 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac The Contents folder appears. 3. Right-click eclipse-orig.ini and open with Text Editor application by Kony, Inc. All rights reserved 54 of 59

55 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac 4. Add additional memory to the following line: -Xmx512m. Example: Add 1024 in place of Save the file and launch Kony Studio. Kony Studio Crashes - Eclipse "OutOfMemoryError - PermGen space" This is caused if insufficient PermGen memory is allocated to the Eclipse instance. This can be solved by increasing the max PermGen size allocated to Eclipse. To assign additional memory, follow these steps: 1. Navigate to the Kony Studio installation folder. 2. Right-click Eclipse icon and click Show Package Contents by Kony, Inc. All rights reserved 55 of 59

56 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac The Contents folder appears. 3. Right-click eclipse-orig.ini and open with Text Editor application by Kony, Inc. All rights reserved 56 of 59

57 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac 4. Add additional memory under the line XX:MaxPermSize. 5. Save the file. Get back the Default View of Kony Perspective Some times we may close the tabs on the IDE by mistake or to make additional space on the IDE. We can get back the original layout by resetting the perspective. To reset the perspective, follow these steps: In Kony Studio, select Window > Reset Perspective. Resetting a perspective takes you back to the default view of the Kony Perspective. Emulators window is empty after Kony Studio installation The Emulators are visible only after an application is created for the first time in the IDE. Red cross mark displayed against the Emulators Emulators are displayed with red cross mark if: 1. The emulators in the IDE are not configured with the installation path of the emulators AND. 2. The application is not built for that specific platform. The emulators are marked in green check mark and ready to be launched to test the application when: 2015 by Kony, Inc. All rights reserved 57 of 59

58 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac The application is built successfully for that platform AND. The emulators are configured correctly with the installation path of the emulators. New changes to build applications in Android If you are having issues building applications on Android, ensure the following: 1. Minimum supported Android SDK along with all required SDKs, Google APIs and other required support files must be installed. 2. Click Command + Comma(,) and set Android Home in Kony Studio Preferences window. 3. Map the Android emulators with /Downloads/adt-bundle-mac-x86_ by Kony, Inc. All rights reserved 58 of 59

59 12. Appendix C: Frequently Asked Questions (FAQs) Kony Studio Installation Guide - Mac <DATE>/sdk/tools/emulator path. Note: For additional information, see the Android section of this guide by Kony, Inc. All rights reserved 59 of 59