If you are installing Log Parser Studio for the first time, you don't need anything in this post. If this your first time using LPS please see this post which explains the prerequisites and how to get LPS up and running quickly. If you already have LPS V1 installed and you have been modifying existing queries and/or creating your own queries and adding them to the library there are a few things to be aware of. Every attempt to create a seamless upgrade experience has been made but we all know the unexpected always seems to find away to occur so let's cover what we can now to help mitigate any potential confusion or issues.
The biggest changes that may affect upgrades is the schema of the library itself and there is a new library with additional queries. In order to make the library more robust there have been schema changes and new fields added such as date modified which allows us to know when a query was last saved. The challenge this presents is that LPS V2 may not be able to parse LPS V1 library XML files, you want the newest V2 library anyway and you don't want to lose your custom queries you saved in V1. Again, this only matters if you have modified the default V1 library and don't want to lose any queries you have previously saved.
Ideally you will want to use the new V2 library then import your modified queries from V1. If V1 already exists LPS V2 may auto-convert, then use the converted V1 library. It behaves this way in an attempt to not overwrite existing custom queries but you don't get to use the new V2 queries this way. So, if you have custom V1 queries you wish to keep and you want to use LPS V2 along with it new queries, consider the following steps:
1. Before running V2, open LPS V1 and export any queries you wish to use keep using File > Export > Library as XML. You can select only the queries you wish to export by using CTRL+CLICK.
2. Run LPS V2. If you see any messages about not being able to read/find/load the library or if you are asked to attempt to convert, choose no and allow a blank library to be created. If you choose to convert, that's fine but you'll be left with the V1 library which we will fix in step 3 anyway.
3. Now choose Help > Recover Library to generate the new V2 library.
4. Now we need to both convert and import the queries you exported earlier and merge them into the new V2 library:
» Find the custom queries XML file you exported earlier and drag-n-drop it onto convertlib.exe.
» Convertlib will attempt to convert the exported queries to the new format.
» If the conversion is successful, use File > Import > XML to Library, browse to the *_converted.XML file and load it.
» Choose Merge Now to merge these into the new library. Do not choose replace now!
5. If you don't have any custom queries you wish to keep, just run LPS V2, ignore any library warnings then generate the new V2 library using Help > Recover library.
The above covers most common scenarios. If you don't have previously saved V1 queries you care about none of the above really applies other than step 5. Even if you have V1 installed and V2 sees the old library and complains you can simply cancel out etc. and use Help > Recover Library to create a brand new default V2 library. You can use the recover feature at any time, just remember that it always overwrites existing queries so you'll want to export any customizations first. Lastly, you could just convert and keep using the old V1 library but you'd be missing out on all the newly included V2 queries.
SUMMARY
If you have V1 and simply want to upgrade to V2, just run V2 and recover the library using Help > Recover Library and you are done.
If you have V1 and you also have custom queries in the library that you don't want to lose, export them first, recover the library, convert with convertlib.exe and import back into LPS V2.
If you don't have LPS V1 and you just downloaded LPS V2 and want to use it now you don't have to do anything.