190
Getting Started with Logi Info Java Applications For Linux, UNIX, and Windows servers, with the JDK Logi Info v12.2 March 2017

Getting Started with Logi Info Java Applications · 1 Getting Started with Logi Info for Java Introduction This publication introduces developers to Logi Info v12.2 for use with the

  • Upload
    others

  • View
    13

  • Download
    0

Embed Size (px)

Citation preview

  • Getting Started with Logi Info

    Java Applications For Linux, UNIX, and Windows servers, with the JDK Logi Info v12.2

    March 2017

  • This document has been formatted for double-sided printing, hole-punching, and placement in a ring-binder. Author: Lee Hausman

    Logi Analytics is a trademark of Logi Analytics, Inc. Microsoft, Microsoft Word, Microsoft Excel, Windows, Windows Server, and Visual Basic are registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Other products and company names mentioned in this book may be trademarks of their respective owners.

    Logi Analytics, Inc.

    7900 Westpark Drive, Suite A200 McLean, Virginia 22101

    703-752-9700

    Copyright © 2009-2017, Logi Analytics, Inc. All rights reserved.

  • i

    Table of Contents

    Introduction ............................................................................................................................................................ 1

    System Requirements ............................................................................................................................................. 2

    General Requirements ........................................................................................................................................ 2

    How Should Your Server Be Configured? ............................................................................................................ 3

    How Many Servers Do You Need? ...................................................................................................................... 4

    Server Virtualization ........................................................................................................................................... 4

    Product Licenses ................................................................................................................................................. 4

    Built-in Trial License ................................................................................................................................................................. 5

    About Logi Applications with Java .......................................................................................................................... 6

    Development Options ......................................................................................................................................... 6

    Deployment Options ........................................................................................................................................... 7

    Database Connectivity and Tools ........................................................................................................................ 7

    Required Platform Knowledge ............................................................................................................................ 7

    Product Licenses ................................................................................................................................................. 7

    Differences from Logi Applications for .NET ....................................................................................................... 8

    Sharing Session Variables with Other Apps ........................................................................................................ 8

    Installing Logi Studio on Windows ........................................................................................................................ 10

    Preparing to Install ............................................................................................................................................ 10

    .NET Framework ...................................................................................................................................................................... 11

    Installing/Enabling the IIS Web Server .......................................................................................................................... 11

    The IIS "Default Web Site" .................................................................................................................................................... 13

    Installing the Software ...................................................................................................................................... 13

    Setting File Access Permissions ......................................................................................................................... 19

    Modifying or Repairing the Installation ............................................................................................................ 20

    Product Licensing .................................................................................................................................................. 22

    Major Version Compatibility ............................................................................................................................................... 22

    Built-in Trial License .......................................................................................................................................... 22

    License Keys and License Files .......................................................................................................................... 22

    Centralized License File ........................................................................................................................................................ 23

    OEM License File ...................................................................................................................................................................... 23

    License Management ........................................................................................................................................ 24

    When a License Can’t Be Found ........................................................................................................................ 26

    When a Trial License Expires ............................................................................................................................. 27

    When a Regular License Expires ....................................................................................................................... 28

  • ii

    Licenses and Server Virtualization ..................................................................................................................... 29

    Upgrading Logi Info and Logi Applications ............................................................................................................ 30

    General Requirements ...................................................................................................................................... 30

    Upgrade Impacts ............................................................................................................................................... 30

    Upgrading Logi Info ........................................................................................................................................... 31

    Getting an Upgrade .................................................................................................................................................................. 31

    Evaluations .................................................................................................................................................................................. 31

    Backup Scheduler Data .......................................................................................................................................................... 31

    Changing the Version of Your Logi Applications ............................................................................................... 31

    Changing Versions with Server Manager........................................................................................................................ 33

    Creating Application Pools in IIS 7+ ................................................................................................................... 34

    Logi Application Overview ..................................................................................................................................... 36

    Understanding Logi Applications ....................................................................................................................... 36

    Introducing Elemental Development ................................................................................................................ 37

    General Development Process .......................................................................................................................... 37

    Standard Logi Application Folders ..................................................................................................................... 38

    Standard Logi Application Files ......................................................................................................................... 39

    Default.aspx................................................................................................................................................................................. 39

    Global.asax ................................................................................................................................................................................... 39

    rdLogon.aspx .............................................................................................................................................................................. 40

    Web.config ................................................................................................................................................................................... 41

    Definition Files ........................................................................................................................................................................... 41

    From XML to HTML... .............................................................................................................................................................. 43

    Using Support Files with a Logi Application ...................................................................................................... 43

    Application Deployment .................................................................................................................................... 44

    Additional Helpful Information ......................................................................................................................... 44

    Java Server Configurations .................................................................................................................................... 45

    About Java Server Configurations ..................................................................................................................... 45

    Setting Java Options .......................................................................................................................................... 45

    Typical Performance Settings.............................................................................................................................................. 46

    JConsole Settings (optional, for monitoring) ................................................................................................................ 46

    Tracing Settings (optional, for testing): .......................................................................................................................... 46

    About the Performance Settings ........................................................................................................................................ 47

    "Hot Deployment" Caution ................................................................................................................................................... 47

    Apache Tomcat 5.5 / 6.0 / 7.0 / 8.0 ................................................................................................................... 48

    JBoss 4 ............................................................................................................................................................... 49

    JBoss 5.1 ............................................................................................................................................................ 50

    JBoss 7.1 ............................................................................................................................................................ 51

  • iii

    Sun Glassfish (SJSAS) 2.1 ................................................................................................................................... 52

    Sun Glassfish (SJSAS) 3.0, 3.1 ............................................................................................................................ 52

    BEA WebLogic 10 .............................................................................................................................................. 53

    Oracle WebLogic 12c......................................................................................................................................... 53

    IBM Websphere 7, 8.5 ...................................................................................................................................... 53

    WildFly 10 ......................................................................................................................................................... 54

    Introducing Logi Studio ......................................................................................................................................... 56

    Launching Logi Studio ....................................................................................................................................... 56

    Logi Studio Geography ...................................................................................................................................... 57

    The Getting Started Dialog Box .......................................................................................................................................... 57

    The Welcome Panel ................................................................................................................................................................. 58

    Working on an Application .................................................................................................................................................. 58

    Panel Arrangement ........................................................................................................................................... 61

    General Features ............................................................................................................................................... 62

    Using Logi 12 Studio .............................................................................................................................................. 64

    Getting Started .................................................................................................................................................. 64

    The Welcome Panel .......................................................................................................................................... 65

    Application Files ................................................................................................................................................ 66

    Editing Files ................................................................................................................................................................................ 70

    Working with Elements ..................................................................................................................................... 72

    Element Positioning ................................................................................................................................................................ 75

    Element Seeker ......................................................................................................................................................................... 75

    Setting Element Attributes ............................................................................................................................... 77

    Element ID Attributes ............................................................................................................................................................ 81

    Variable and Parameter Lists .............................................................................................................................................. 81

    Express Attribute Navigation .............................................................................................................................................. 82

    The Attribute Spy ..................................................................................................................................................................... 82

    Intelligent Token Completion ........................................................................................................................... 83

    Token Validation ...................................................................................................................................................................... 85

    Studio Wizards .................................................................................................................................................. 85

    Wizards in Action ..................................................................................................................................................................... 87

    Assigning Themes and Style Sheet Classes ....................................................................................................... 89

    Using Themes ............................................................................................................................................................................ 89

    Using Style Classes .................................................................................................................................................................. 91

    Testing and Debugging Applications ................................................................................................................. 92

    Using the Preview Tab ........................................................................................................................................................... 92

    Using the "Live Preview" Feature ..................................................................................................................................... 94

    Browsing the Default Report Definition ......................................................................................................................... 95

  • iv

    Browsing Any Report Definition ........................................................................................................................................ 95

    Using the Test Parameters Panel ....................................................................................................................................... 96

    Using the Element Seeker ..................................................................................................................................................... 98

    Deploying Logi Applications ............................................................................................................................ 100

    Controlling Which Files Are Deployed .......................................................................................................................... 104

    License Files ............................................................................................................................................................................. 106

    After a First-Time Deployment ........................................................................................................................................ 106

    Ribbon Menu, Shortcuts and Search ............................................................................................................... 106

    The Home Tab ......................................................................................................................................................................... 106

    The Design Tab ....................................................................................................................................................................... 107

    The Tools Tab .......................................................................................................................................................................... 107

    The Wizards Tab .................................................................................................................................................................... 108

    Ribbon Menu Controls ......................................................................................................................................................... 108

    Keyboard Shortcuts .............................................................................................................................................................. 109

    Search & Replace ................................................................................................................................................................... 109

    Studio Options ................................................................................................................................................. 110

    Source Code Repository-Friendly Features ................................................................................................................ 112

    The Database Browser .................................................................................................................................... 114

    The SQL Query Builder .................................................................................................................................... 116

    When Query Has Been Entered Manually ................................................................................................................... 117

    Use with Oracle and Multiple Schemas......................................................................................................................... 117

    The MDX Query Builder ................................................................................................................................... 117

    When a Query Has Been Entered Manually ................................................................................................................ 119

    Working with Studio Panels ............................................................................................................................ 119

    Changing Logi Application Versions ................................................................................................................ 121

    Team Development Features .......................................................................................................................... 123

    System Configuration ........................................................................................................................................................... 126

    Third-Party Source Control Products ........................................................................................................................... 126

    Deleting a Logi Application .............................................................................................................................. 127

    Granting File Access Permissions ........................................................................................................................ 128

    Tell-Tale Errors ...................................................................................................................................................................... 128

    Using .NET? Let the New App Wizard Do It ..................................................................................................... 128

    Using Java? It’s Usually Done for You .............................................................................................................. 129

    Which Accounts? ............................................................................................................................................. 129

    Which Application Sub-Folders? ..................................................................................................................... 129

    Granting File Access Permissions .................................................................................................................... 129

    No Security Tab Visible? ..................................................................................................................................................... 134

  • v

    Managing Support Files ...................................................................................................................................... 135

    Using Themes and Style Sheets .......................................................................................................................... 138

    About Themes ................................................................................................................................................. 138

    Use Beyond Appearance ..................................................................................................................................................... 138

    Selecting a Theme in Studio’s Wizard ............................................................................................................. 139

    Adding Themes Manually ............................................................................................................................... 139

    Themes and Style Sheets .................................................................................................................................................... 140

    Interaction with Other Style Sheets ............................................................................................................................... 141

    Themes and Exports ............................................................................................................................................................. 141

    Creating Your Own Themes ............................................................................................................................ 141

    Creating a Custom Theme Manually .............................................................................................................................. 141

    Your Custom Themes in the New Application Wizard ........................................................................................... 142

    Theme Release Notes ........................................................................................................................................................... 143

    About Cascading Style Sheets ......................................................................................................................... 143

    Create an Example Style Sheet ....................................................................................................................... 144

    Including a Style Sheet in Your Application .................................................................................................... 145

    Editing a Style Sheet in the Workspace .......................................................................................................... 146

    Editing in the Style Sheet Selector .................................................................................................................. 146

    Editing a Style Sheet Using the External Style Sheet Editor ............................................................................ 148

    Applying a Style Sheet to Your Definition ....................................................................................................... 148

    Assignment Using a URL ..................................................................................................................................................... 149

    Global vs. Local Style Sheets .............................................................................................................................................. 149

    Assigning Style Classes to Elements ................................................................................................................ 150

    Create an Alternate Row Class ......................................................................................................................................... 152

    Create Dynamic Row Highlighting .................................................................................................................................. 153

    Development Best Practices ............................................................................................................................... 154

    Debugging Reports .............................................................................................................................................. 156

    Previewing and Browsing ................................................................................................................................ 156

    Using Live Preview ................................................................................................................................................................ 157

    Browsing the Default Report Definition ....................................................................................................................... 158

    Using Comments, Remarks, and Application Notes ....................................................................................... 159

    Remarking Elements ............................................................................................................................................................ 160

    Writing Application Notes .................................................................................................................................................. 160

    Using the Test Parameters Panel .................................................................................................................... 161

    Using the Application Debugger ..................................................................................................................... 162

    Using Debugger Link No Data ........................................................................................................................................... 163

    About the Debugger Trace Report .................................................................................................................................. 163

    Debugging Scripts .................................................................................................................................................................. 166

  • vi

    Using the Element Seeker ............................................................................................................................... 166

    Logging Errors .................................................................................................................................................. 168

    Hello World! Tutorial ........................................................................................................................................... 170

    Glossary ............................................................................................................................................................... 178

    Resources and Support........................................................................................................................................ 182

  • 1 Getting Started with Logi Info for Java

    Introduction This publication introduces developers to Logi Info v12.2 for use with the Java runtime environment. Logi Info is a tool that allows developers to create and run comprehensive reporting solutions and web applica-tions, using a full range of business analytics features and components. Developers working with the .NET Framework on Windows platforms are directed to our companion docu-ment Getting Started with .NET Applications. The general purpose of this publication is to assist developers in installing Logi Info, in making it functional, and in getting a basic understanding of how Logi reports and web applications work. Other publications and online documents are available that focus on specific aspects of Logi applications, such as displaying data in tables or in charts. Documentation for Logi Analytics products, available on the Logi Developer Network web site, will always pre-sent the most up-to-date information. Specifically, you can look there for the newest features; publications like this one are by their nature more difficult to keep current. The technique of “elemental development”, the creation of report pages by combining pre-defined objects (or elements) from a toolbox into a hierarchical tree that mirrors the top-to-bottom layout of an HTML page, makes for speedy report development. New Logi developers are often surprised at how quickly they can pro-duce meaningful reports. In addition, because report designs can be made dynamic at runtime, developers also often find the number of report definitions they must manage reduced, often by as much as 50%. The DevNet web site includes numerous free sample applications that can be quickly downloaded and that provide a great learning opportunity for new developers. Frequently the sample apps mirror the examples in the documents on DevNet. Logi developers are urged to take advantage of these sample apps. What should the Logi developer already know? A prospective Logi developer should already have a good understanding of general web technologies, such as HTML and style sheets, and be familiar with their data sources and the techniques, such as SQL, needed to ac-cess that data. Experience with JavaScript is useful but not required. What information is not presented here? General web server, database server, and network management techniques touch on the successful deploy-ment of Logi applications but are beyond the scope of this publication. The assumption is made that develop-ers have these skills themselves or have access to others within their organizations with them and the specifics of these topics are not included here. We hope you enjoy working with these products and quickly become productive and successful with them. Comments about this publication are welcomed and can be addressed to [email protected].

    http://devnet.logixml.com/mailto:[email protected]

  • 2 Getting Started with Logi Info for Java

    System Requirements The following general hardware and software components are required for Logi Info:

    General Requirements

    Browsers: - Internet Explorer: 11 (Certified); see note below about earlier versions. - Microsoft Edge (Certified) - Firefox, Chrome: all current public versions (Supported) - Opera, Safari: all current public versions (Supported)

    Hardware: - 1.6 GHz or higher processor - 4 GB or higher RAM - 1.5 GB of available hard disk space

    Operating Systems:

    - All OS versions: 64-bit only, 32-bit is not supported - Suse, Red Hat, Ubuntu, CentOS and just about any other flavor of Linux - Solaris, HP-UX (Limited support) - Windows Server 2012 R2, 2008, 2003 - Windows 10 (with Logi Info v12+ only) - Windows 8 (all editions except RT) - Windows 7 (all editions)

    Web Servers: - Apache-Tomcat 6, 7, 8 (without Tomcat FHS) - JBoss 4, 5, 7, EAP-6.3 - Sun GlassFish (SJSAS) 2.1, 3.0, 3.1 - BEA WebLogic 10 - Oracle WebLogic 12c - IBM Websphere 7, 8.5 - WildFly 10

    Software: The following components must be installed: (Development machine, for Logi Studio tool) - Microsoft .NET Framework 4.x (Web server) - Official Sun Java Development Kit (JDK) 1.6, or - Official Sun Java Development Kit (JDK) 1.7, 1.8 (non-Apple platforms) (The JRE is not sufficient but OpenJDK 1.7 and JRockit 1.6 or 1.7 may be used)

    Data Sources: Logi Info can use any of the following data sources/services:

  • 3 Getting Started with Logi Info for Java

    - Amazon SimpleDB - MySQL database server - DB2 database server - ODBC-compliant database servers - Files: Excel, CSV, XML, JSON - OLEDB-compliant database servers - Google Maps, Google Docs - Oracle database server - HP Vertica - HPCC

    - PostgreSQL database server

    - JDBC-compliant database servers - Salesforce.com - Microsoft SQL Server - SMTP email servers - Microsoft SQL Server Analysis Services - Sybase database server - Mongo DB - Twitter.com - Web Services (REST and SOAP)

    Microsoft Internet Information Server (IIS) must be installed before installing Logi Info. The .NET 4.x frame-work is required. If not already in place, with your consent, .NET will be installed when Logi Info is installed. Internet Browsers - We recommend that you use IE 11 or Edge for viewing applications built with Logi Info v12.2+. Microsoft ended support for .NET Framework 4.0 and 4.5 on January 12th, 2016. We recommend use of 4.6. No 32-bit Version - Hardware manufacturers have started focusing almost exclusively on 64-bit server plat-form architectures and major OS manufacturers have transitioned their products to 64-bit only versions, mak-ing it difficult for us to comprehensively test 32-bit versions of our products against them. As a result, with the advent of Logi Info v12.2, we no longer provide 32-bit versions of our software

    How Should Your Server Be Configured? In a typical scenario with an average data size per report (less 10MB of data per report), you should be able serve 50-100 concurrent users per multi-core CPU on a production server, assuming a good amount of RAM (4GB+) and a fast hard drive (12K RPM+). Here are three representative configuration levels for the web server. A low-performance hardware configuration:

    1 multi-core CPU, 4GB RAM, 12K RPM HD, 64-bit OS A better performance configuration (for more users or more data):

    Quad-Core CPU, 6GB+ RAM, 15K RPM HD, 64-bit OS The best performance configuration begins with the previous configuration and adds:

    Additional CPUs (2 or more Quad-Core CPUs), more RAM (8GB+), 64-bit OS, or move to a clustered environment.

    Here are a few general "rules of thumb" when considering server configuration options:

    More Data and Data Complexity = More RAM More Reports, Larger Reports, Complex Reports = Faster hard disk, more available hard disk space More Traffic and Concurrent Visitors = More CPUs/Cores

    https://support.microsoft.com/en-us/lifecycle?p1=14380

  • 4 Getting Started with Logi Info for Java

    How Many Servers Do You Need? You should think of your "reporting server" as a computer that has a web server and the Logi server engine software installed on it. Ideally, this computer should be dedicated to this task alone. However, other configurations are possible and quite feasible, including those in which the web server also serves other functions (i.e. is not dedicated to reporting alone) and/or the database server is also on the re-porting server computer. Which configuration should you use? We do not have guidelines based on specific numbers of users or reports to share with you; each deployment situation is different. Whether you choose to combine functions (web, Logi report, and database servers) on one computer is, ulti-mately, your decision. Numerous factors can affect this decision, including the amount of web server traffic, the number of concurrent database users, the size of the databases, the complexity of the database queries, the frequency of report access, and, not least, cost. You may care to begin with a combined configuration and, as your report usage grows, change to a dedicated configuration. The nature of Logi products allows you to do this easily and without additional cost (if per-server CPU counts remain constant). Recent studies concerning server virtualization suggest that database servers are frequently under-utilized. On the other hand, many database vendors recommend that their products be run on a dedicated server. You may wish to check with your database vendor for their recommendations concerning database servers.

    Server Virtualization Many organizations are using server virtualization to maximize hardware usage and reduce costs. Server virtu-alization products allow the assignment of CPU resources to processes. This may take the form of a maximum percentage of combined CPU utilization, or as specific allocation of logical CPUs, to a virtual machine (VM). The server administrator is responsible for making these configuration decisions. Logi product licenses treat a VM just like a regular, non-virtualized server and run just fine in this environment. In order to ensure good performance in any virtualized server environment, administrators must be careful to allocate appropriate resources to VMs. It's not uncommon to relocate a VM from one hardware platform to another, for example, for hardware maintenance. The Logi license will "move" with the VM, as long as the machine name remains unchanged.

    Product Licenses

  • 5 Getting Started with Logi Info for Java

    Logi Analytics licenses are server-based, rather than individual-user or concurrent-access, licenses, so an un-limited number of end-users can access Logi reports through a single web server. Our Logi Info licensing scheme allows you to install our product on one development machine and one production server. Logi Info requires a license for both our development tool, Studio, and for our Server Engine, which is part of each Logi application you create. Your development system will likely require both but production web servers generally do not need Studio installed on them. So, for Logi Info we offer both a "Studio and Development Server" combination license and a standalone Server license, and this two-license approach allows flexibility in different situations.

    Built-in Trial License Current Logi Info versions come with a built-in 15-day trial license. You don't need to do anything but install the product and you can begin using it immediately. A clearly-visible display above the Logi Studio main menu, shown below, counts down the days remaining in the trial period.

    Clicking the counter display will take you to a web page that offers information about purchasing a Logi Info license.

    After the trial period expires, you won’t be able to use Logi Studio and any Logi applications you may have

    developed will no longer run without a real license. Licenses are keyed to you or your organization; they take the physical form of license files, which are assigned to a specific computer. DevNet includes a License Management page where you can manage your licenses, including reviewing them, assigning and un-assigning them to machines, and generating license files, at any time, without any interaction with our staff. For more detailed information about licenses, the Product Licens-ing chapter in this document. You may not use our products for redistribution with, or embed them in, other products without an OEM li-cense; contact our Sales group for more information if you need OEM licenses.

  • 6 Getting Started with Logi Info for Java

    About Logi Applications with Java Logi Info consists of two parts: Logi Studio and the Logi Server Engine. When a Java application type is selected during development, Studio generates applications that use the JDK libraries rather than the .NET framework. The Server Engine includes special components that allow Logi applications to be deployed as Java applications on Windows or Linux/UNIX platforms.

    Development Options The process of creating Logi applications is identical regardless of output library choice. Some specialized ele-ments that are included to support the Java environment are available, such as Connection.JDBC, when devel-oping Java applications.

    The formats of definition, support, and other files that make up a Logi application and are created by develop-ers remain the same for all versions of Logi managed reporting products, regardless of the OS they run under. Logi Studio, though Java-aware, is a Windows application. Developers creating Logi apps use Studio on a Win-dows PC to develop their Logi applications, regardless of the final deployment environment. Developers have the option of developing and testing their application entirely on a Windows platform before moving it to a production Linux/UNIX server.

  • 7 Getting Started with Logi Info for Java

    Deployment Options Logi applications can be deployed on servers running Windows or Linux/UNIX. A Logi application can be moved to one of these servers and enabled to use the JDK (or other JVM) by adding special folders to the application folder (changes in the _Settings definition, such as the application path and connection attributes, may also be necessary).

    Database Connectivity and Tools Connectivity to databases such as Oracle, MySQL, and MS SQL Server is supported via native connection ele-ments and other connections using JDBC are also available. Connections to a variety of other non-database datasources are also supported, including XML, CSV, Excel data files, and web services. Specific MySQL and MS SQL Server database drivers are provided with the Logi Server Engine, so developers do not need to separately download and install them. However, these may not be the correct version for all cir-cumstances and developers may need to update or replace them. Our SQL Server JDBC driver works with JDK 1.7 and 1.8, and MS SQL Server 2005+. The previous version of the driver's sqljdbc4.jar file, however, is still provided, as sqljdbc4.old, for users who work with MS SQL Server 2000. Developers working with Oracle, who wish to use the Database Browser and Query Builder tools within Stu-dio, need to install and configure the Oracle Client (OLEDB) on the Windows platform where Studio for Java is installed.

    Required Platform Knowledge Developers planning to use Logi for Java applications with Linux/UNIX servers should ensure that they have a good working understanding of the OS, JDK (or other JVM), the web server, and the admin/management tools on their server. The detailed knowledge required to successfully administer these servers can be extensive and complex and is well beyond the scope of Logi documentation.

    Product Licenses Logi Info v12+ come with a built-in 15-day trial license. You don't need to do anything but install the product and you can begin using it immediately. A clearly-visible display in the Studio main menu, shown below, counts down the days remaining in the trial period.

  • 8 Getting Started with Logi Info for Java

    Clicking the counter display will take you to a web page that offers information about purchasing a Logi Info license. After the trial period expires, Studio won't be usable and any Logi reports you may have developed will no longer run without a real license. Logi Analytics licenses are server-based rather than individual-user or concurrent-access licenses, so an unlim-ited number of end-users can access Logi reports through a single web server. Our licensing scheme allows you to deploy our product on one development machine and on one production server. As mentioned earlier, addi-tional separate licenses for Studio, for additional developers, are also available. Licenses are keyed to you or your organization; they take the physical form of license files, which are assigned to a specific computer. DevNet includes a License Management page where you can manage your licenses, including reviewing them, assigning and un-assigning them to machines, and generating license files, at any time, without any interaction with our staff. For more detailed information about licenses, see our document Product Licensing. You may not use our products for redistribution with, or embed them in, other products without an OEM li-cense; contact our Sales group for more information if you need OEM licenses.

    Differences from Logi Applications for .NET Generally, Logi Java applications provide all of the features and functionality found in Logi .NET applications. Occasionally new features will first be released for .NET applications and then for Java in subsequent releases. Naturally, Logi apps created for Java do not support Windows-specific technologies such as OLEDB. Analogous Java technologies, such as JDBC, are supported instead. However, for the best results, developers should try to use native connections, such as Connection.MySQL, before using generic connections like Connection.JDBC. JavaScript is the only scripting language available when building Java applications. However, a built-in "VBScript emulator" essentially allows our intrinsic functions, such as IIF(), which are modeled on VBScript, to be available for use in a Java application. Currently, Logi applications for Java do not have support for the following elements:

    All OLAP elements (note that XOLAP elements, however, are supported) DataLayer.Web Scraper

    Sharing Session Variables with Other Apps On a web server, Logi applications for Java and regular (non-Logi) Java applications maintain their session vari-ables in different ways. And, typically, Logi application session variables are accessed using @Session tokens, while Java application session variables are accessed via JSP or by using the ja-vax.servlet.http.HttpSession object. If a Logi application for Java is to be integrated with a Java application, then how can their session variables be shared? The Java Session Copying element, available in the _Settings definition, provides a selective method for session variable copying between the two applications.

    http://devnet.logixml.com/rdPage.aspx?rdReport=Article&dnDocID=2012

  • 9 Getting Started with Logi Info for Java

    In order to use this feature, you must not use session variable names that contain spaces in your Logi ap-

    plication, and there's a small performance penalty for this process, so it's best to minimize the number of vari-ables copied. It may be necessary to restart your web server if you edit the lists in the attributes described be-low. The element has four attributes, consisting of Regular Expressions, which control which session variables are copied. As it can be difficult to write Regular Expressions which both include and exclude strings, we've provid-ed two attributes ("include") which are processed first, followed by two other attributes ("exclude") which are processed second, making it easier to accomplish both types of operations.

    Attribute Description

    Copy From Java Exclude

    Specifies, as a comma-separated list of Regular Expressions, the Java application session variables that will not be copied to the Logi application session variable space. This attribute is processed after Copy From Java Include, removing varia-bles from that list.

    Copy From Java Include

    Specifies, as a comma-separated list of Regular Expressions, the Java application session variables that will be copied to the Logi application session variable space.

    Copy To Java Exclude

    Specifies, as a comma-separated list of Regular Expressions, the Logi application session variables that will not be copied to the Java application session variable space. This attribute is processed after Copy To Java Include, removing variables from that list.

    Copy To Java Include

    Specifies, as a comma-separated list of Regular Expressions, the Logi application session variables that will be copied to the Java application session variable space.

    Once copied, session variables are identified, in the Java app, using its session object's attribute ID and, in the Logi app, as the name used with a @ Session token. For example: Java JSP: session.getAttribute("userEmail") Logi app: @Session.userEmail~ If circumstances demaind it, it’s possible to return an earlier "copy all" behavior by manually adding the follow-ing XML to your _Settings definition source code, as a child of the tag:

  • 10 Getting Started with Logi Info for Java

    Installing Logi Studio on Windows There are two major parts to the Logi product in the installation file you downloaded: Logi Studio, our development environment, is a Windows application that's typically installed on a Windows development machine and interacts with the local IIS web server for Logi application development and testing. The Logi Server Engine is a set of files that's part of each Logi application and which provides an extension to the IIS web server at runtime. When you build a Logi application, Studio adds the Engine files to the applica-tion. The engine also includes a Windows utility application, Logi Server Manager, which allows you to perform basic configuration of Logi applications without using Studio. A very typical installation scenario is to install Studio and the Server Engine on a Windows development ma-chine, and then install only the Server Engine (including Server Manager) on the production web server. This "development and production" dual installation is allowed by our licensing scheme. Additional copies of Studio may be licensed and installed on additional development machines. There are a number of ways to deploy your Logi applications to production, including Studio's built-in Applica-tion Deployment tool. Other installation scenarios, involving shared network drives and team development, are feasible and can be used. This document covers installation of Studio and the Server Engine on a development machine, but you'll also see what's needed to install the Server Engine on a production server.

    Preparing to Install Logi Info works with all editions of Windows 7, 8, and 10, and with Windows Server. The examples that follow show installation and configuration for Windows 10 but the process for other Windows OS versions is similar. Use the Administrator Account Windows 7 includes a number of security enhancements that impact software installation and it is critical that installation and configuration occur while using the software with the built-in "Administrator" account.

    Even if your personal account has been added to the local Administrators Group, it may not have sufficient privileges, so don't rely on it. As shown at left, the correct practice when running the Logi installation program or using the Command Line to make configuration adjustments is to start the tool by right-clicking its icon and selecting "Run as administrator" from the menu to start the program. This ensures that appropri-

  • 11 Getting Started with Logi Info for Java

    ate permissions are provided for the installed components. Don't see a "Run as administrator" option? If the system is in a network domain, your network admin may have created security policies that don't allow you to see this option, in which case you need to consult your IT staff for assistance. If you’re working the Windows Server or Windows XP operating systems, ensure that you have logged into the machine using an account that’s included in the machine’s local Administrator group.

    .NET Framework Logi Studio requires the .NET Framework components. When Windows 7 and Vista are installed, multiple ver-sions of the framework are typically included. Before doing anything else, ensure that you have .NET installed by using File Explorer to browse to:

    C:\Windows\Microsoft.NET\Framework64

    where you should see several folders, such as v4.0.30319, one for each version of .NET installed. Logi Info v12 requires .NET 4.x. If not already in place, with your consent, appropriate versions of the .NET framework are installed when Logi Info is installed.

    Installing/Enabling the IIS Web Server When Windows is installed, the components for the IIS web server are also installed, but they’re usually not enabled. You must do this manually, before you install your Logi product.

  • 12 Getting Started with Logi Info for Java

    This is accomplished in Control Panel applet, under Programs and Features → Turn Windows features on or off, as shown above. Check the boxes on your machine so they match the image above, then close the dialog boxes.

  • 13 Getting Started with Logi Info for Java

    The example above shows how to navigate within Control Panel to install IIS.

    The IIS "Default Web Site" When it's enabled, IIS creates a "Default Web Site" and the New Application wizard in Logi Studio expects to create all new Logi applications as virtual directories of that web site. If you have renamed, replaced, or disa-bled the "Default Web Site", or have installed another web server that handles HTTP requests on Port 80, the wizard will fail during its application registration phase. Under these circumstances, you can continue to use Logi Studio to develop Logi applications but you will need to manually register them. This process is described in our document Windows IIS Configuration.

    Installing the Software

    This section describes the installation steps and the dialog boxes you'll see when using the interactive tool built into your Logi product installation file. If you need a "silent" (non-interactive) installation, see our online Command Line Installation document Your product version numbers may vary from those shown in the following examples. As usual, you can click Back at any time before the physical installation begins to go back to the previous screen.

    1. To start the installation, right-click the Logi product installation program icon and select "Run as adminis-trator" to launch the installer. Allow it to complete the installation preparation, shown above.

    http://devnet.logianalytics.com/rdPage.aspx?rdReport=Article&dnDocID=1068http://devnet.logianalytics.com/rdPage.aspx?rdReport=Article&dnDocID=2294

  • 14 Getting Started with Logi Info for Java

    2. When the Welcome Screen appears, click Next.

    3. License Agreement: Select the "I accept the terms..." radiobutton after reading the license agreement and click Next to continue.

  • 15 Getting Started with Logi Info for Java

    4. Destination Folder: Click Next to accept the default installation location and continue. Optional - click Change to specify an alternative installation location if you don't like the default location. Multiple versions may be installed on the same machine and will co-exist smoothly using the default value here.

    5. Setup Type: Select the Typical or Custom radiobutton (see Custom information below) and click Next to continue:

  • 16 Getting Started with Logi Info for Java

    If you selected a "Typical" setup, go ahead to Step 6. If you selected a "Custom" setup, the dialog box shown above appears. The following components are available during a Custom setup:

    Logi Info Studio - The integrated development environment used by developers to create ap-plications and report definitions.

    Logi Info Web Server - The Logi Server Engine that processes XML data in report definitions and outputs HTML.

    Logi Info Scheduler Service for .NET- The Logi Windows Service that manages scheduled events; required if you want to have scheduled report generation and distribution.

    Logi Info Scheduler Service for Java- The Logi Java daemon that manages scheduled events; not applicable when using the .NET version of Logi Info.

    Left-click any of the components shown and make a selection from the popup menu to include them in the installation. If desired, click Space to review the disk space requirements for the Custom setup you've selected. Click Next to proceed without the review.

  • 17 Getting Started with Logi Info for Java

    The Disk Space Requirements display gives you information about available storage space and warns you if there isn’t enough space for the installation. You can repeatedly adjust the components in the Custom setup and see the effect on storage here, if necessary. Click OK to return to the previous dialog box.

    6. Installation Summary: Review the installation summary and click Install.

  • 18 Getting Started with Logi Info for Java

    7. The physical installation will begin and you'll see several progress indicators for different tasks.

    8. Installation Complete: click Finish to exit the installer and launch Studio Studio (if you have only installed the Logi Info Web Server, there will be no "Launch Logi Studio" checkbox visible).

  • 19 Getting Started with Logi Info for Java

    9. If you left the "Launch Logi Studio" checkbox checked, Studio will now launch and you should see a splash

    screen like the one shown above.

    You can also launch Studio by using Start Menu All Programs Logi Info or Report Studio.

    Should you need to, you can launch Server Manager using Start Menu All Programs Logi Info or Re-

    port Server Manager or from Studio's Tools menu. More information about using Server Manager is available in our online Using Logi 12 Studio document.

    Installation is complete. However, go on to the next section to complete the IIS configuration.

    Setting File Access Permissions You will need to set file access permissions to allow Logi Studio and IIS to work together smoothly:

    http://devnet.logianalytics.com/rdPage.aspx?rdReport=Article&dnDocID=2029

  • 20 Getting Started with Logi Info for Java

    Set the permissions, as shown above, using these steps:

    1. Use the File Explorer to navigate to C:\Program Files\LogiXML IES Dev and right-click the folder. Select Properties.

    2. Select the Security tab and click Edit, the Add, and add the account NETWORK SERVICE. 3. Set the Permissions for NETWORK SERVICE to Full Control. 4. Click OK as necessary to exit

    Modifying or Repairing the Installation Suppose you installed Logi Info but didn't initially install the Scheduler, and now you find you want to schedule reports. Or you suspect a Logi Studio .DLL file is missing or is corrupted and you want to fix it.

  • 21 Getting Started with Logi Info for Java

    These kinds of situations can be addressed by either modifying or repairing the installation, which you should do by re-running the installation program file (don't forget to right-click it and use "Run as administrator" to start it).

  • 22 Getting Started with Logi Info for Java

    Product Licensing Logi Analytics licenses are server-based, rather than individual-user or concurrent-access, licenses, so an un-limited number of end-users can access Logi reports through a single web server. Our Logi Info and Logi Report licensing scheme allows you to install our product on one development machine and one production server. A license is required for both our development tool, Studio, and for our Server Engine. Your development sys-tem will likely require both but production web servers generally do not need Studio installed on them. So, we offer both a "Studio and Development Server" combination license and a standalone Server license, and this two-license approach allows flexibility in different situations.

    Major Version Compatibility If you upgrade an existing installation of one of our products, or an existing Logi application, from one major version to another major version, for example v11 to v12, you will need a new license for the new prod-uct/application. Contact Customer Service if you want to upgrade and need a new license.

    Built-in Trial License Logi Info comes with a built-in 15-day trial license. You need do nothing but install the product and you can begin using it. A clearly-visible display in the Studio toolbar, shown below, counts down the days remaining in the trial period.

    Clicking the Studio counter display will take you to a web page that offers information about purchasing a product license.

    After the trial period expires, Studio and any Logi reports you may have developed will no longer run without a real license

    License Keys and License Files When you purchase a Logi product, here's what happens in the licensing process:

  • 23 Getting Started with Logi Info for Java

    1. A license key, specific to you or your organization, is created for you by our staff and stored in our li-censing database.

    2. You visit our DevNet web site, login, and go to its License Manager page to create a license file. You do this by assigning your license key to a specific computer, by Computer Name. DevNet then generates a license file.

    3. You then download this file and use it to license each Logi Info/Report application you develop. A typical license file name is lgx100201.lic and licenses are product-specific. When you download your license file, you save it in C:\Program Files\LogiXML IES DEV\LogiStudio to license any new apps, and in the application folder of any existing Logi application that you've created with a trial license or that you'll be updating to v12. If you need to move an application to another machine, or re-install your Logi product on a different machine, you can "un-assign" the license from one machine, assign it to another, and generate a new license file. OEM licenses operate in a similar fashion, but can be assigned to multiple machines.

    Centralized License File If you have a large number of Logi apps on the same web server, you may care to use a single, centralized li-cense file rather than manage multiple copies of it. In Logi Info v12, the General element in the _Settings definition includes a License File Location attribute where the location of the license file is specified. This value is a fully-qualified web server file system path to the folder where the file is stored. For example, C:\myProjects\License.

    You must ensure that all web applications that will use this license run under an account that has security permissions to access files in the folder you specify in License File Location. With this centralized license approach, if you use the exact same file path to your license file on both your de-velopment machine and your production server, you can deploy Logi applications by copying them, without having to replace the license file or adjust your _Settings definition attributes each time.

    OEM License File Customers with OEM licenses can embed the entire license inside their Logi application. In the _Settings defi-nition, the General element has an OEM Distribution License attribute which allows Logi applications to run on a server that does not otherwise have a license key installed. This is especially useful for XCOPY-type deploy-ments: the Logi installation program does not have to be run on the web server. To use this attribute, double-click the attribute name to open its Zoom window and then copy the entire XML contents of your OEM license file into it. This attribute only works with OEM licenses; other types of licenses copied into here will be ignored.

  • 24 Getting Started with Logi Info for Java

    License Management Our DevNet web site includes a License Management page where you can manage your licenses. . In order to

    manage your licenses, you must be a DevNet member and login first, then go to Support Manage Licenses.

    The details of the License Management page are shown above and here's an explanation: 1. Product - This select list displays the names all products licensed to you; select a product to display its li-

    censes. Filtering and search capabilities are available to refine the list, too.

    2. License Key - The license "key" created for you when you purchased the product appears here.

    3. Type & Expires - The license version and type and any expiration date appear here.

    4. License - Click the "Create" link in this column to assign your license to a specific machine. Once done, the machine name will appear in the next column and the link will change to "Download". Click the link again to download and save your license file. You may download the file as many times as necessary but it's only valid on the assigned machine.

    5. Assigned To - This column displays the name of the machine a license has been assigned to. The icon allows you to "un-assign" the license - when this is done, the License link will revert back to "Create", and you may assign the license to another machine.

    6. Note - This column displays optional text you enter to help you more easily identify the computer. Click the

    icon to add or edit this text.

    7. History - Click the icon to display the history of assignments for this license. Here are the details of the process of creating and downloading a license file:

  • 25 Getting Started with Logi Info for Java

    If the link in the Licenses column of the table shown earlier says "Create", clicking it will display the Create Li-cense File pop-up panel, shown above. You use it to assign the license to a specific machine, by entering the computer name. The Optional Note input is for your use if you want to further identify the machine and its text appears in the table of licenses shown earlier. If the computer on which this license is to be used runs a Windows OS, then the computer name value is what's known in Windows parlance as the "machine name". You can open a Command Prompt window on the machine and enter "hostname", then press Enter to have the name displayed. If a multi-part name is dis-played, such as "myPC.myCompany.local", use just the first part, "myPC". If the computer on which this license is to be used runs a Linux or other UNIX-derivative OS, then the "com-puter name" value is the computer's "hostname". You can go to a command line and enter "#hostname", then press Enter to have the name displayed. Use the full hostname value, exactly as it's displayed, for your com-puter name value entry. Click OK to generate the license file for the designated computer.

  • 26 Getting Started with Logi Info for Java

    Once the license file has been generated, the link in the Licenses column will change to "Download". Click this link to display the Download License File pop-up panel, shown above. Click the Download button to download and save the license file.

    Some browsers may add an .xml file extension to the downloaded file, which is wrong. A typical license

    filename looks like lgx110201.lic so don't let your browser add anything to it. If the computer on which this license is to be used runs a Windows OS, then save the license file to

    C:\Program Files\LogiXML IES Dev\LogiStudio

    This will provide licensing for development work using Logi Studio, as well as for new Logi applications that are developed on the machine and run there using any web server. If you're upgrading any older Logi applications, you'll also need to copy the license file into their application folder.

    When a License Can’t Be Found As mentioned earlier, Logi Studio and your Logi applications require license files.

  • 27 Getting Started with Logi Info for Java

    If no license file can be found when you start Logi Studio, a trial license will be automatically created but it may be expired (it's based on the date when the product was installed). If so, you'll see a message similar to the one above and be unable to use Studio.

    If no license file can be found when you try to browse a Logi application, you'll see a message similar to the one above in your browser, instead of the application page. Providing copies of a valid license file in the correct locations will allow Logi Studio and the application to run.

    When a Trial License Expires When your trial license expires, and there is no regular license, you'll see the following messages:

    If the trial license has expired, when you start Logi Studio, you'll see a message similar to the one above and be unable to continue to use Studio.

  • 28 Getting Started with Logi Info for Java

    If the trial license has expired and you try to browse a Logi application, you'll see a message similar to the one above in your browser, instead of the application page. Providing copies of a valid license file in the correct locations will allow Logi Studio and the application to run.

    When a Regular License Expires When your regular license expires, you'll see the following messages:

    If the regular license has expired, when you start Logi Studio, you'll see a message similar to the one above and be unable to continue to use Studio.

    If the regular license has expired and you try to browse a Logi application, your application page will be dis-played with a special warning banner added at the top, as shown above. A 7-day grace period is provided from the date when the license expired.

  • 29 Getting Started with Logi Info for Java

    Once the grace period ends, reports will no longer run and only the message shown above will be displayed in the browser. Providing copies of a valid license file in the correct locations will allow Logi Studio to be used and the applica-tion to run without the warning banner.

    Licenses and Server Virtualization Many organizations are using server virtualization to maximize hardware usage and reduce costs. Server virtualization products allow the assignment of CPU resources to processes. This may take the form of a maximum percentage of combined CPU utilization, or as specific allocation of logical CPUs, to a virtual machine (VM). The server administrator is responsible for making these configuration decisions. Logi v12 licenses treat a VM just like a regular, non-virtualized server and run just fine in this environment. In order to ensure good performance in any virtualized server environment, administrators must be careful to allocate appropriate resources to VMs. It's not uncommon to relocate a VM from one hardware platform to another, for example, for hardware maintenance. The Logi license will "move" with the VM, as long as its machine name doesn't change.

  • 30 Getting Started with Logi Info for Java

    Upgrading Logi Info and Logi Applications Each new release of Logi Info provides feature enhancements and improvements. Customers are encouraged to take advantage of these improvements by upgrading to the latest releases when they become available. These instructions provide guidance for the process of upgrading, uninstalling, or modifying your Logi product installations and managing the related versions of your Logi applications. The installation tool, InstallShield, does not remove any files or folders created or modified after the initial in-stallation, including Sample Applications that you may have modified, so your report definitions are safe during an upgrade.

    General Requirements Logi Info for the Windows environment, including Logi Studio, requires the .NET Framework 4.x. If not al-

    ready in place, with your consent, appropriate versions of the .NET framework are installed when Logi Info is installed. Microsoft ended support for .NET Framework 4.0 and 4.5 on January 12th, 2016. We recommend use of 4.6.

    Separate installations of different versions of Logi Info can co-exist as long as they are installed in different directories.

    IIS 6 users may need to implement Application Pools to isolate Logi applications using different .NET framework versions. This is an IIS configuration task and is explained later in this document. Application Pools are a standard feature of IIS 7+.

    Upgrade Impacts

    Logi v12 includes stylistic and appearance improvements in charts, Super Elements, Themes, etc. which are noticeably different. You may care to do a test upgrade before committing to a comprehen-sive upgrade.

    You must use Application Pools that use .NET 4.x. If such an application pool doesn't exist, Studio will generate a warning when you upgrade an existing Logi application. When you create a new applica-tion, Studio will create a new application pool, named "Logi Info .Net v4.x", and will assign the applica-tion to it.

    You are urged to visit the DevNet Release Notes page for your product to understand the technical changes in new versions, before upgrading.

    https://support.microsoft.com/en-us/lifecycle?p1=14380

  • 31 Getting Started with Logi Info for Java

    Upgrading Logi Info Upgrading to a new version involves two steps: installing the new release of Logi Info, and upgrading the ver-sion of any existing Logi applications. You can do the former without doing the latter; applications are not au-tomatically upgraded. Original and upgraded applications can co-exist, so upgrading can be phased in as de-sired.

    Getting an Upgrade How do you get an upgrade? Customers who have purchased a maintenance plan for Logi Info, or are using it under an OEM agreement, may be able to download new product releases directly from our DevNet web site. See Support → Download Products. If the DevNet download links are not available to you, contact Logi Customer Service via email or telephone (703-752-9700) for alternate instructions for downloading upgrades. Customer Service can also answer ques-tions you may have about purchasing or renewing a maintenance plan. To upgrade your Logi product, run the downloaded installation program and install the new version into the same location as the previous version, or to a different location if you wish to have both versions installed. No un-installation of the original version is required, and existing definitions or data will not be overwritten. The upgrade installation will take 2-3 minutes to complete.

    Evaluations If you wish to install an upgrade for evaluation purposes, we recommend that you install it into a different folder than any previous version, such as C:\Program Files\LogiXML IES Dev Test. This will preserve the previous version of Studio. If you install an update into the same folder as a previous version, Studio will be updated and you will not be able to roll it back without uninstalling and re-installing the previous version en-tirely.

    Backup Scheduler Data

    If you have previously installed and used the Logi Scheduler service, we recommend that you make a safe-ty copy of your existing schedule data, before upgrading: (Win Java) C:\Program Files\LogiXML IES Dev\LogiXML Scheduler Service Java\Schedules\*.*

    (Lin/UNIX) /Schedules/*.*

    and then proceed with the upgrade installation. Your existing data file should be upgraded in place without any difficulty.

    Changing the Version of Your Logi Applications In order to use all of the features in the latest Logi release, you will need to change application versions on all machines, development or production, where you upgrade your Logi product. You can use one of two methods to change application versions.

    mailto:[email protected]

  • 32 Getting Started with Logi Info for Java

    When you open an application, Studio displays a warning in its Application tab, as shown above, if the applica-tion's version does not match the version of Logi Info and Studio being used. This is important in Studio be-cause the rules governing the use of elements will be out of sync. Clicking the Change Version... link will cause the application's version-specific binary files to be replaced with the files for a version you select from a list of installed versions. This will not affect any definitions or support files.

    A progress indicator, like the one shown above, will be displayed.

  • 33 Getting Started with Logi Info for Java

    Changing an application version will also trigger some web server diagnostics to run after the upgrade and you'll see some information about that process. Once the tests end, you'll the results, as shown above.

    The failure of any test indicates that something is wrong with your web server environment's ability to run

    the upgraded application. This could be caused by a number of things, such as failing to install the new Logi version as an Administrator, or having incorrect file permissions on the application folder, or failing to have the correct version of .NET installed. Contact Logi Support for assistance.

    Changing Versions with Server Manager Another method of changing an application's version is by using Server Manager, shown below, which is in-stalled with Studio and is available via Studio's Tools menu or the Start Menu. . It's a tool that allows you to examine all of the Logi applications on the web server and manage them individually or in a batch.

    Server Manager, shown above, only works with .NET applications, using the IIS or Cassini web servers; if nei-ther of these servers is installed, Server Manager will prompt you to install them. The Server Manager dialog box displays a table showing each application installed on the local web server and a list of all the Logi product versions installed on the machine. To change an application's version, check one or more applications, select the version desired, and click Change Version. The process usually takes less than a minute for each application selected. Versions can be upgraded or downgraded.

  • 34 Getting Started with Logi Info for Java

    Creating Application Pools in IIS 7+ The Application Pool is a method of isolating different .NET applications within the web server, in order to provide improved reliability. In IIS 7, the default application pool, "DefaultAppPool" is created at installation and all virtual directory applications, when created, are assigned to this default pool. However, applications using different .NET versions can't be run at the same time in the same pool. If they are, error messages will appear for whichever application is started last. The recommended practice is to create a new application pool and assign all applications that use the same .NET version to it.

    To create a new application pool:

    1. Open the IIS Manager (see All Programs → Administrative Tools ) 2. Select and right-click the Applications Pools item in the list on the left. Select Add Application Pool...

    from the pop-up menu. 3. Enter the new name of your choice as the Application Pool ID and leave the default pool settings se-

    lected. Click OK 4. Right-click the Application Pools item in the list on the left and click Refresh to see your new pool.

  • 35 Getting Started with Logi Info for Java

    To assign an application to the new Application Pool:

    1. Expand the Sites item in the list on the left, and then expand the Default Web Site item below it.

    2. Find and select your application in the list.

    3. In the right-hand Actions Panel, click Basic Settings...

    4. A dialog box like the one shown above will appear. Click Select... and choose your new Application Pool from the list.

    5. Click OK. Your application is now assigned to your new Application Pool.

  • 36 Getting Started with Logi Info for Java

    Logi Application Overview This chapter introduces Logi Analytics' application architecture. A key concept, Elemental Development, is in-troduced, along with report definition files, elements and attributes. Elemental Development is the foundation of Logi applications. In this overview, you'll learn how Logi applications deliver content to the web and how to include external files such as images, scripts, and XML data files.

    Understanding Logi Applications A Logi application generally consists of one or more reports. A report is really a web page so, while Logi prod-ucts are most frequently used as reporting tools, they can also be used to create rich, web-based applications. The Logi Analytics DevNet web site, for example, is built entirely with Logi Info. Logi reports deliver data in a presentable and accessible manner as web pages. They use Internet technologies and browser software to distribute rich, interactive reports and applications. Logi reporting tools bring leading-edge Internet technologies together, allowing developers to quickly deliver results efficiently. The framework underlying this consists of:

    An integrated development environment (Logi Studio) An XML-based language, coded in text-based definition files A runtime server (the Logi Server Engine)

    Logi reporting tools separate the report development, data access, and presentation processes:

    1. Report Definitions are text files that contain the information describing report layout and contents, stored as XML documents. While it is possible to write definitions with any text editor, Logi Studio provides an integrated development environment with lots of tools and helpful wizards that do much

  • 37 Getting Started with Logi Info for Java

    of the coding for you and reduce development time.

    2. When a report is requested by a user, the Logi Server Engine on the web server processes the report definitions and accesses data sources as required. A wide variety of data sources are supported.

    3. The Logi Server Engine formats the retrieved data and presentation details based on the definition and accompanying style sheets; generates HTML and JavaScript, and returns the report page to the user's browser for viewing.

    This arrangement allows the Logi Server Engine to operate as a stand-alone entity that's completely inde-pendent of systems that call upon it for reports. Separate applications, regardless of their host OS, environ-ment, or development language, that wish to embed or access Logi reports, for example, need only include a standard hyperlink to do so.

    Introducing Elemental Development Elemental Development is the process of creating flexible reporting applications using predefined, XML-based objects or "elements". The advantages of Elemental Development are:

    XML elements are reusable and encapsulate specific functionality common to most web applications

    A hierarchical layout of elements makes it easy to manage the presentation and functionality of large web-based reports

    Studio's drag-and-drop user