Logi Product Upgrades

Each new release of Logi Analytics products 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, modifying, and uninstalling your Logi product installations, and managing the related versions of your Logi applications.

Information about which Logi Info and add-on module versions we recommend using together is available in Introduction to Add-on Modules. For more information about Logi Info releases, see Release Notes.

The installation tool, InstallShield, does not remove any files or folders created or modified after the initial installation, including Sample Applications provided with Logi products that you may have modified.

General Requirements

  • Logi products for the Windows environment and Logi Studio require the .NET Framework 4.x. If not already in place, with your consent, appropriate versions of the .NET Framework are installed when Logi products are installed. They are also available for free from the Microsoft Download Center.

    Microsoft ended support for .NET Framework 4.0 and 4.5 in January 2016. We recommend use of .NET 4.6.
     
  • Separate installations of different versions of Logi products and applications can co-exist as long as they are installed in different folders.
     
  • IIS users need to implement separate Application Pools to isolate Logi applications using different .NET Framework versions. Application Pools are a standard feature of IIS 7+ and can be implemented in IIS 6 using the instructions provided later in this topic.

  • Logi v12 Java applications require the Oracle JDK or OpenJDK 8 or (Info v12.6 SP2+) 11, 12, 13, 14.

    Oracle has changed its Java usage policies - see Java Usage Policy for important information.
     

Back to top

Upgrade Impacts

 Logi v12 products include several changes you should know about before upgrading:
 

  • Logi v12 products include 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 comprehensive upgrade.
     
  • The built-in Themes shipped with Logi v12.1+ have been changed internally to allow customization with the Theme Editor tool. Custom Themes you may have created based on earlier versions of the built-in Themes will continue to work correctly in v12.1+ but may not be editable in the Theme Editor. To make them so, you will have to recreate your customizations starting with one of the new built-in Themes.
     
  • 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 application, Studio will create a new application pool, named "Logi Info .Net v4.x", and will assign the application to it.
     
  • Logi Info includes a free, 15-day trial license but, when it expires, you will need to purchase a regular license. If you're a customer in good standing, Logi Customer Service will assign that license to you in advance, but you will need to go to DevNet and download the license file.
     

Back to top

 

Upgrading the Products

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

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 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 questions 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 entirely.
 

Backup Scheduler Data

 If you have previously installed and used the Logi Scheduler service and are not using the optional storage configuration to store your scheduled tasks on a networked database server, we recommend that you make a safety copy of your existing schedule data, before upgrading: (Windows .NET) C:\Program Files\LogiXML IES Dev\LogiXML Scheduler Service\Schedules.vdb3
(Windows Java) C:\Program Files\LogiXML IES Dev\LogiXML Scheduler Service Java\Schedules\*.*
(Linux/UNIX)   <installFolder>/Schedules/*.*
and then proceed with the upgrade installation. Your existing data file should be upgraded in place without any difficulty.

Back to top

 

Changing .NET Application Versions

In order to use all of the features in the latest Logi Info release, after you install it you will need to change the application version on all of your Logi applications. There are two methods for changing an application version:
 


1. Using Logi Studio - When you open an application, Studio will display a warning in its Application tab, as shown above, if the application's version does not match the version of the Logi product being used. Click the Change Version... link to replace your Logi application's version-specific binary files with the files for a version that 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.  

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.

2. Using Server Manager - You can also change application versions using Server Manager, which is installed 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 neither 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.

Back to top

 

Changing Java Application Versions

In order to use all of the features in the latest Logi Info release, after you install it you will need to change the application version on all of your Logi applications.

The process for upgrading a Logi Java application on your development machine is the same as it is for .NET apps: use the Change Version link in Studio as discussed in an earlier section.

The Server Manager tool discussed in the previous section is intended for use only with .NET applications, and expects to work with the IIS or Cassini web servers. You cannot use Server Manager for Java applications.

Changing your Java application version on a Linux/Unix production server (which won't have Logi Studio or Server Manager installed as they are Windows apps) is a little more complicated. You could just copy the application files and folders from the development machine to the production machine but that will likely result in an undesirable proliferation of .jar files over time. Instead, we recommend the following:

  1. Change the version of your Logi app on your development machine using Studio or Server Manager.
  2. On the production server, create a new folder which will become your new Logi app folder.
  3. Copy everything from the app folder on your development machine (which is the new version) to this new folder.
  4. Copy any files specific to the production app, such as _Settings.lgx, which might have different connection settings, from the original Logi app folder on the production server to the new app folder on the production server.
  5. Rename the old and new app folders, or adjust any references so the new app folder is now the recognized location for your Logi app.
  6. You may need to change the General element's Application Path attribute in _Settings.lgx if the path or folder name have changed.
  7. Test your application.
  8. Archive or delete the old app folder on the production server.

Back to top

 

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. 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 ProgramsAdministrative 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 selected. Click OK
  4. Right-click the Application Pools item in the list on the left and click Refresh to see your new pool.

     

To assign an application to the new Application Pool:

  1. Expand the Sites item in the list on the left, 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.

Back to top

 

Creating Application Pools in IIS 6

Microsoft IIS 6 introduced Application Pools as a method of isolating different applications within the server, in order to provide improved reliability. The "Default Application Pool" is created by default 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 ProgramsAdministrative Tools )
  2. Select and right-click the Applications Pools item in the list on the left. Select New 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 selected. Click OK
  4. Expand the Application Pools item in the list on the left to see your new pool.
     


To assign an application to the new Application Pool:

  1. Expand the Web Sites item in the list on the left.
  2. Select and right-click the virtual directory representing your application. Select Properties from the popup menu.
  3. Select the new application pool you just created from the list of Application Pools in the Properties dialog box.
  4. Click OK

If you have any doubt about which version of .NET your application is set to use:
 

  Click the ASP.NET tab on the Properties dialog box and inspect the ASP.NET version selection.

Back to top