SageTV Community - How to install a new version of SageTV

SageTV Community (http://forums.sagetv.com/forums/index.php)

- SageTV Beta Test Software (http://forums.sagetv.com/forums/forumdisplay.php?f=17)

- - How to install a new version of SageTV (http://forums.sagetv.com/forums/showthread.php?t=16602)

How to install a new version of SageTV

There is a FAQ entry for this too, but here is some info/suggestions to keep in mind when installing a new beta version of SageTV:

Exit SageTV
Make sure SageTV is not running -- close SageTV, close the client, stop the service. Be thorough and ruthless. Don't just put it to sleep; make sure it isn't running at all.
Backup your current installation.
The easiest way to save your current SageTV data, customizations, settings, etc. is to make a complete copy of your current SageTV installation. Yes, you could save just a couple files, such as wiz.bin and sage.properties... but this method also saves your channel logos, STV customizations, etc.

Note: SageTV will automatically create backups of your wiz.bin and properties files when you start the new version for the first time; the process outlined here helps to backup everything else.

Locate the SageTV install directory (usually something like C:\Program Files\SageTV) and copy the entire directory tree somewhere else. Note: you want to copy the SageTV directory that contains just the Common and SageTV folders, not the SageTV directory that contains many, many files. By copying the main SageTV dir, you will get all those many files & then some.
Backup other files you might need
Do you use the Hauppauge remote? If so, make a backup copy of the irremote.ini file, which is found in your Windows direcotry. If you've never customized this file, you may not need to worry about this step.
Install SageTV
That's right: just install SageTV. You don't need to uninstall the previous version first, unless you are using Windows Home Server. The installer will take care of uninstalling the old version before installing the new one. Notes:
1. If using Windows Home Server, uninstall the old version of SageTV before running the SageTV for WHS installer.
2. Pay attention to the location where the installer will install the new version. You want to make sure it is the same directory where the current version is installed.
3. If you are using the Hauppauge remote, the installer will create the SageTV settings in irremote.ini if you check that option. If you don't check that option & had it checked on a previous installation, the SageTV section will be removed from irremote.ini. This is why you wanted to make a backup copy of irremote.ini, especially if you've customized irremote.ini. Essentially: try to always either check that option or always leave it unchecked, depending on whether you use the default ini settings or custom ini settings.
4. All of your other current settings will be kept, except that the STV will be reset to use the default STV.
Run SageTV
Now that SageTV has been installed, run the service control application (SageTVServiceControl.exe) to configure + start the SageTV service and/or start the SageTV UI (SageTV.exe or SageTVClient.exe). If the latest STV is not loaded automatically, you can select it from Detailed Setup -> Advanced -> Revert to the default STV (or via the SageTV Application Package option).

Check that things work as expected. Recordings, Favorites, etc. still as they were before? Recordings play? Remote work? Significant other still has that adoring smile?

If so, great.

If not, make sure SageTV was installed to the same location as last time, or check other possible mistakes.

If there is a bug, please submit it using the Bug Submission Form. Remember: you can post bug somments in the forum, but to be sure SageTV sees them, use the bug reporting system. (If it isn't a beta version, please fill out a Support Request.)
Apply customizations
Well, not really... you are using a beta version! Please test the default setup so we know whether it works.

heh... OK, OK, so you aren't going to do that, now, are you? Version 7 plugins are now selectable from Setup -> SageTV Plugins. They can be discussed in the SageTV v7 Customizations forum.

Prior to version 7: If you insist on using some customizations, especially STVi imports, remember: any time you install a new version, only the default STV (SageTV7.xml) is overwritten by the one in the installer. Your other STV files are not affected. So, while the imports will still be in your old STV, the new changes in the default STV will not be in the old one where your imports were loaded previously. You would need to start with the new default STV & load any imports again. Note: The List of available customizations includes a link to a plugin that can batch process your list of STV imports.

Unless you deleted your old properties file(s), all of the old setting should still be in place.

Remember: If you have applied customizations or are using a custom STV, please try the default setup if you run into a problem. This will help determine whether the problem is in a customization or in the default configuration.
Relax, enjoy SageTV, and watch some TV.
If you've followed all these steps and I've actually somehow managed to list them without forgetting something important, then just relax, enjoy SageTV, and watch some TV.

What to do if an insurmountable problem is encountered.

In case debug logging isn't turned on, make sure it is enabled in Detailed Setup -> Advanced -> Debug Logging. You will need to restart SageTV after changing that setting for it to take effect. There will be sagetv_0.txt and/or sagetvclient_0.txt log files after each time SageTV is run. Save those files from when a problem occurs to help track down a problem -- they can be emailed to betatest at sagetv.com
If you feel the need to revert to a previous version, then:
1. Uninstall the current version.
2. Install the previous version, making sure to install in the same directory as before.
3. Copy the backed-up copy of the old installation back into place. This step restores all your old data files and configuration settings. Version 7 data files are not compatible with version 6!
4. Run SageTV to make sure it got reverted properly.

Once again: if you run into a problem, Submit a Bug Report. Don't just revert to a previous version and wait for the next update. If no one reports the problem, you may just run into it again the next time.

Did I forget anything?

- Andy

Quote:

Originally Posted by Opus4

[*]Backup your current installation.
...
[*]Backup other files you might need
...

Here is my batch file to make this a little easier: Script for backing up before updating Sage installation

upgrading SageTV

Hi Opus4,

(OK no laughing) Well I am still running the original version 4 of sagetv on server and clients. But I want to upgrade soon, so that I can use the Media MVPs that I purchased. I am just a little hesitant to upgrade because everything is working so nicely now. And I dont have a lot of extra time to be fixing possible problems that come up.

But I know eventually I have to upgrade. :)

So, can you give me a gut feeling of how often you run into problems when upgrading from one version to a new beta version?

I REALLLY want to put my MediaMVP's to use, and to try out placeshifting too, in April when my work schedule allows me more freedom. So I know I have to upgrade the Server and my clients too (which are using the same addins and stv's that I installed on all of them, just to be consistent)

Im just trying to map out the process of upgrading the server, and the clients, and get the Media MVPs working, and avoid problems. :) I just want it all to work like it does now....but I DO need to upgrade! or I cant do any of the new fun stuff.

PS
I know dumb question bit, where do I download the lastest *stable* or non-beta version of Sagetv and SageTV client? I suppose if I just download the versions from the SageTV download page, that will get me the lastest version right ? Just havent downloaded many versions since I started using SageTV, so I wasnt 100% where latest stable version is at.

I can't remember the last time I had a problem installing & running a new version. But, the steps above are intended to 1) provide a way to revert to an older version fairly easily if the upgrade does have problems for you, and 2) keep your current configuration settings & data. You'll still have to apply any STV imports, but that is also covered above.

If you want to try the MVP & placeshifter, I recommend using the latest beta from the beta forum. The non-beta release version from a while back won't have the latest fixes (MVP or otherwise) nor will it have any placeshifter ability.

- Andy

OK, I will just go ahead and make a backup copy of all the important files, and then just DO IT :) I am sure it will be fine based on what you are saying. I will use the latest beta version 4.1.10

Edit: I just made the copy of it, installed the new beta version over the top of existing, on both client and server, and its working just fine. Yeah SageTV!

Now to try out an MVP and then placeshifting....and who knows what after that.

PS
If I understand correctly, I have to re-install any add-ins that I had on the previous version right? Because they are gone now. If so, I will just follow the simple directions for doing that. And add my 3 or 4 add-ins back into my clients. I actually dont install any add-ins on my server, I figured since I dont usually open up the sagetv interface on there too much I dont need to change the base configuration of it.

Edit: Well everything went perfect. Not one glitch. I just made the backup copies, and then installed new beta version 4.1.10 on server and clients. And its all working great. Seems faster too. Also got the first MediaMVP working, just plugged it in and it worked, :) gotta like that

AND placeshifter is working too.

Keep channel line-up?

Opus,
I have been doing the beta thing for some time now, but I'm having a problem with something I'd like to do. I want to do a clean slate install but keep my channel line up and tuner configuration. I.e. When I upgraded last time, I made a backup, then uninstalled SageTV and deleted the "program files\sagetv\" folder en total. Installed the latest beta and re introduced my backup wiz.bin, wiz.bak, channel logo's folder, news.dat etc. I didn't want to re-use my old sage.properties file because I didn't want to miss out on any changes made to the default properties file by the last beta.

The problem is that after doing this I have to re-install my recording sources, and configure my channel line ups again. That wouldn't be too big a problem but zap2it has our lineup all screwy so it takes about an hour to remap all the channels correctly for all three of my different lineups/tuners. Is there a section of the back up sage.properties file that I can copy to the new one created by the setup wizard that will retain my encoder/line-up configurations?

Quote:

Originally Posted by Humanzee

Is there a section of the back up sage.properties file that I can copy to the new one created by the setup wizard that will retain my encoder/line-up configurations?

Rather than trying to list everything that you should keep (which I don't know w/100% certainty), all I can suggest is to go through the properties file & delete anything that doesn't look like it could be related to epg info, channel lineups, and tuner config. Make a copy of both the original & your edited version before restarting SageTV.

I think you'll have better luck with that instead of me trying to list all the properties to keep... and end up w/me forgetting some. :)

- Andy

Quote:

Originally Posted by Opus4

go through the properties file & delete anything that doesn't look like it could be related to epg info, channel lineups, and tuner config.

So if I have a essentially blank sage.properties, sans the area which I think are related to EPG and tuner stuff, the setup wizard will fill in the missing bits and updates, but use my retained info? I.e. not ask me to configure my tuners.

Pretty much, yes. If a property exists, its value will be used. If it doesn't exist, then the default value will be used. That's one way to reset some setting -- if you don't know what it should be, just delete the property & restart.

- Andy

What if you made some minor Studio changes ... such as; text color, change to what menus show up when back his selected, etc.? Do you have to go back in to Studio and make each change again individually??

Thanks, T.

Short answer: yes.

It's possible to write an STVI script that will do the changes for you when you import it. But if you have just a few minor changes, and aren't a Studio wizard, it's probably simpler to just do them again by hand.

That's why I put step #6 is in the first post: "Apply customizations". It states that you have to re-apply changes to the default STV, because your customizations won't be there. (I guess it states "imports", but it applies to all types of STV changes.)

- Andy

Hi I want to do a clean install of windows (maybe even try your linux ver) and was wondering which files to save for favorite recordings and remote setup (USB-UIRT)
is there a list somewhere that explains which files do what?

Quote:

Originally Posted by mtfred99

From the very first post:

Quote:

Backup your current installation.
The easiest way to save your current SageTV data, customizations, settings, etc. is to make a complete copy of your current SageTV installation. Yes, you could save just a couple files, such as wiz.bin and sage.properties... but this method also saves your channel logos, STV customizations, etc.

Gerry

Quote:

Originally Posted by Opus4

Backup other files you might need

- Andy

Two questions Andy ...

1 - Should we back up the old Java files?

2 - If you made say a half dozen minor Studio edits will those be lost in the upgrade?

T.

Quote:

Originally Posted by mightyt

1 - Should we back up the old Java files?

What java files do you mean? If you have java installed, as far as I know, the SageTV installer won't install java at all.

Quote:

2 - If you made say a half dozen minor Studio edits will those be lost in the upgrade?

Didn't we go over this above? The installer only installs a single STV: SageTV3.xml. If you haven't been editing that file, your changes will still be in your custom STV, since any custom STV remains unchanged. And, of course, your custom STV will contain nothing new from the new default STV, since the custom is not changed.

- Andy

Quote:

Originally Posted by Opus4

What java files do you mean? If you have java installed, as far as I know, the SageTV installer won't install java at all.

Didn't we go over this above? The installer only installs a single STV: SageTV3.xml. If you haven't been editing that file, your changes will still be in your custom STV, since any custom STV remains unchanged. And, of course, your custom STV will contain nothing new from the new default STV, since the custom is not changed.

- Andy

Hmm ... Well I seem to remember Java being installed with one of my prior Sage versions?? I still have a "C:\Program Files\Java\j2re1.4.2_06" folder on my client system where I have Sage v.4.1.10. From your response, guess I am from outer sapce ...

I suppose you did go over it, though not specifically referencing Studio changes. But, I should have made the connection myself.

Sorry to have asked dumb questions ...

Quote:

Originally Posted by mightyt

Hmm ... Well I seem to remember Java being installed with one of my prior Sage versions?? I still have a "C:\Program Files\Java\j2re1.4.2_06" folder on my client system where I have Sage v.4.1.10.

And that is my point - if java is already installed, it won't install it; if java isn't installed, the installer will install it.

(I asked "what java files..." since I wasn't sure if that was what you meant.)

- Andy

Quote:

Originally Posted by Opus4

Doesn't seem entirely true. I have 2 machines, the one with Java 1.5.x, SageTV 6 install didn't try to install Java, but the machine with Java 1.6 RC, SageTV6 did try to install 1.4.x.

-D

Quote:

Originally Posted by mdnttoker

but the machine with Java 1.6 RC, SageTV6 did try to install 1.4.x.

Thanks for the reminder -- I believe that's because it is a newer version that SageTV isn't checking for. I think they know about that, but you could always submit it to SageTV to make sure... though it may be considered too new to do anything about yet.

- Andy

Quote:

Originally Posted by Opus4

What I was getting at is ... you were making a point of "backing up other files you might need" to roll back your old Sage. I thought I remembered in the past that not all versions of java worked with all versions of Sage, thus was asking should we also backing up the java folder as well ...

What if you ran the v6 Beta then reverted back to v5, I have some recordings that where recoreded in v6 that are showing as imported videos rather in Sage Recordings, can I use the wiz.bin (or whatever file, bear with me) from v6 so my recordings, favorites that I made using v6 show up in v5?

Quote:

Originally Posted by camus

What if you ran the v6 Beta then reverted back to v5 ... can I use the wiz.bin from v6 so my recordings, favorites that I made using v6 show up in v5?

No, the v6 wiz.bin is not compatible with v5. If you revert back to a previous version, you'll need to restore wiz.bin from that previous version. (If you didn't save it, SageTV automatically makes a copy the first time you run the new version.)

- Andy

Quote:

Originally Posted by camus

No, wiz.bin files are not backwards compatible. That is why you should always back up the wiz.bin before upgrading so if you need to rollback you can replace the old file. Any new recordings made with the newer version will then show up as imported videos.

Edit: Darn I'm slow today.

Un install/ Re install

I need to re install sagetv completely. I have lost all most all my HI def (qam) channels I think because I have increctly cross patch some of them. regular uninstall and deleting the sagetv folders does not work. Obviously there is still something left behind because when I reinstall it, it does not ask for my registration number. The only way around this is to reformat the hard drive. I don't want to do this. What can I do to fix this?

Quote:

Originally Posted by electrofex (Post 276985)

I need to re install sagetv completely. ... regular uninstall and deleting the sagetv folders does not work. Obviously there is still something left behind because when I reinstall it, it does not ask for my registration number. The only way around this is to reformat the hard drive. I don't want to do this. What can I do to fix this?

The existing license registration shouldn't affect a new installation. There's a FAQ about doing a complete reinstallation -- as it says: make sure you are not restoring your old properties file(s). And, you should try a new installation w/o using the old wiz.bin.

If you are using Vista, there might be files left in the VirtualStore, so check that too.

If deleting all those files doesn't help when you do a new install, then check with tech support.

- Andy

I deleted the sage folder which I think has the wiz.bin it did not help. I don't need to save any settings. It seemes to keep my test of adding channels and linking channels. I want to wipe this all out.

If I made some tweaks to my Default UI in v.6.3.10, will I lose them if I upgrade to 6.4.x?

I changes some Fonts and Button Text in Studio.

Will i ahve to do that over again?

Quote:

Originally Posted by mightyt (Post 291351)

If I made some tweaks to my Default UI in v.6.3.10, will I lose them if I upgrade to 6.4.x?

I changes some Fonts and Button Text in Studio.

Will i ahve to do that over again?

From the first post of this topic:

Quote:

Originally Posted by Opus4 (Post 145040)

... any time you install a new version, only the default STV (SageTV3.xml) is overwritten by the one in the installer. Your other STV files are not affected. So, while the imports will still be in your old STV, the new changes in the default STV will not be in the old one where your imports were loaded previously. You would need to start with the new default STV & load any imports again. Note: The List of available customizations includes a link to a plugin that can batch process your list of STV imports.

Unless you deleted your old properties file(s), all of the old setting should still be in place.
...

This means that default STV (currently: SageTV3.xml) will be overwritten and the properties file will not be.

- Andy

Quote:

Originally Posted by Opus4 (Post 291396)

From the first post of this topic:

This means that default STV (currently: SageTV3.xml) will be overwritten and the properties file will not be.

- Andy

Thanks!!

Sorry, not sure I got if actual Studio changes would stick? I did modify a few minor things in there as well.

If you used Studio to edit the default STV and did not re-name the STV file, then your changes will be lost when you do the upgrade.

If you used Studio to edit the default STV or a custom STV and saved it with a different name, then your custom STV file will still be there. However, after the upgrade, the first time you launch Sage, it will open the latest default STV (not your customized file), and you won't see your changes.

You will be able to go back and use your old modified STV, but you won't have the benefits of any new features or fixes that were added to the latest default STV. Also, it is possible that changes made to Sage's core will make your old modified STV no longer work properly.

This is why Sage supports imports. If you make a lot of customizations to the default STV, it is best to create an STVi that contains those customizations. Then when you upgrade Sage, you can just re-import the STVi.

Note that the instructions in the first post of this thread still apply to trying out the v7 beta, though I may now go back & change a few words.

In short: make a backup copy of your current SageTV installation, then install v7 over the existing version.

Extenders & Placeshifters may not automatically select the default SageTV7 STV, but you should be able to easily change that in Detailed Setup -> Advanced -> Revert to the default STV.

- Andy

Where can I find beta v7.0.12?

There's an notification thread stuck at the top of the Announcements forum (and a link at the top of this one) that lists all the previous versions.

- Andy

Quote:

Originally Posted by Opus4 (Post 145040)

There is a FAQ entry ...
[*]Apply customizations

Well, not really... you are using a beta version! Please test the default setup so we know whether it works.

heh... OK, OK, so you aren't going to do that, now, are you? Version 7 plugins are now selectable from Setup -> SageTV Plugins. They can be discussed in the SageTV v7 Customizations forum.

Prior to version 7: If you insist on using some customizations, especially STVi imports, remember: any time you install a new version, only the default STV (SageTV7.xml) is overwritten by the one in the installer. Your other STV files are not affected. So, while the imports will still be in your old STV, the new changes in the default STV will not be in the old one where your imports were loaded previously. You would need to start with the new default STV & load any imports again. Note: The List of available customizations includes a link to a plugin that can batch process your list of STV imports.

Unless you deleted your old properties file(s), all of the old setting should still be in place.

Remember: If you have applied customizations or are using a custom STV, please try the default setup if you run into a problem. This will help determine whether the problem is in a customization or in the default configuration.

...

- Andy

How do I get to a clean SageTV7.xml? You seem to indicate that V7 does like V6 where each add-in would increment the STV number (SageTV7-1.xml, SageTV7-2.xml ...) leaving the original SageTV7.xml intact.

Quote:

Originally Posted by briands (Post 448903)

Does it give that impression? I didn't think it did, though there are probably more v7 edits I could do to the first post.

In v7, the plugin system doesn't overwrite the STV or save it as a new version; it just applies the STV plugins when you run SageTV. To stop using a plugin, disable or uninstall it.

- Andy

Quote:

Originally Posted by Opus4 (Post 448920)

Re-reading it, I see my mistake... It would be nice if there was a "remove all"

Quote:

Originally Posted by briands (Post 448978)

Re-reading it, I see my mistake... It would be nice if there was a "remove all"

Please check each beta's release notes for changes:

Quote:

Originally Posted by Narflex (Post 446540)

SageTV V7.0.16 Beta 9/2/2010

STV Updates

12. Plugin list: When viewing installed plugins, added slide-out option to uninstall all plugins, with double confirmation.

- Andy

I need to re-install Sagetv & have this folder structure (Windows 7):
1. SageTV
2.Common
3.Legacy, remoteCodes
2.SageTV
3.channelLogos, clients, etc.
I don't quite understand your comment above about making a backup copy of the SageTV directory but "not the SageTV directory that contains many, many files". I have backed up the wiz.bin, .properties and the tuner settings files (.frq). Which of the above directories do I really need to backup for a reinstall?

Will just replacing the Sage Jar files allow sagetv to find the new plugins repository since Google Code is shutting down or do I need to replace the exe files to when running Windows 10 64 bit OS?