Developers
AvantGo Channel Developer Guide

TOC PREV NEXT INDEX


"This page is not available..." message on your test device

If you get this message on the device after you sync, it means that the AvantGo sync server, for some reason, has not downloaded the page for viewing on the mobile device. There are three common causes for this message.

  1. Check your channel's current settings.
    • Go to the channel properties screen for the channel.
    • Note the settings currently in effect for Maximum Channel Size, Link Depth, Include Images, and Follow Off-Site Links.
  2. Check the dowloaded size of your channel.
    • Log into avantgo.com
    • Click the My Account tab on the right hand side of the screen.

      This will display a list of all of your channels, along with the size of all the pages grabbed during your last sync.

    • Note the size indicated next to the channel you are testing.

      Fix: If the downloaded size of your channel is well below the Maximum Channel Size setting, most likely the page or pages that are not available on the device were too large.

    • Break these pages into two or more smaller pages.
    • Sync again and see if this clears up the problem.
  3. If the downloaded size of your channel is close to the Maximum Channel Size, determine what your channel's actual size is.
  4. The downloaded size recorded for a channel in the last sync is the size of all the pages that were grabbed, not all the pages that could have been grabbed within your Link Depth. This means that if your channel's size limit is 100KB, and your channel is actually 150KB, your channel size will be reported as something like 98KB. This is because the AvantGo sync server grabbed 98KB worth of data, then realized the next page it was going to grab would put it over the size limit, and therefore stopped grabbing pages.

    To find out what your channel's real size is:

    • Temporarily change your channel's Maximum Channel Size to something ridiculously large, like 500K.
    • Sync again and check the downloaded size that is listed for your channel.
    • Set your channel's Maximum Channel Size back to what it was. Even if it looks like you need to increase it, don't do it until you have done some more troubleshooting.

      Next steps:

    • If the actual size of your channel is not larger than your Maximum Channel Size:
      (1) Check Link Depth — is the page not available because it is on your channel site but beyond the specified Link Depth? For more information, see The Link Depth setting.
      (2) Check Follow Offsite Links — is the page not available because it is outside your channel site and you have Follow Offsit Links set to No? For more information, see The Follow Off-Site Links setting.
      (3) Check server speed — if the actual size of your channel is not larger than your Maximum Channel Size and the page(s) are not missing because of your channel's Link Depth or Follow Offsite Links settings, then the problem is most likely caused by a slow web server on your channel site. The AvantGo sync server times out if its page request is not processed fairly quickly; for more information, see Server timeouts encountered.
    • If the actual size of your channel is larger than your Maximum Channel Size, the first thing you need to do is figure out why. Continue with the following steps in this section.
  5. If Follow Off-Site Links is set to Yes, look for "leaks" to other sites.
  6. Leaks are links to pages that you don't really want downloaded with your channel. Leaks probably account for probably two-thirds of the channel size problems we see.The fixes below may apply if your channel has Follow Off-Site Links set to Yes.

    Fix 1: If you really don't want to download pages from other sites with your channel pages, then every off-site is a leak!

    • Set Follow Off-Site Links to No.
    • Sync again and see if that clears up the problem.

      Fix 2: If you do need certain off-site pages to be available with your channel pages:

    • Carefully scan all your channel pages looking for off-site links that you do not want downloaded.
    • Remove them from your site entirely, or move them to pages that are outside the Link Depth you have set.
    • Sync again. and see if that clears up the problem.
  7. Look for "leaks" within your site.
  8. Leaks within your site are links to pages that you don't really want downloaded with your channel, even though they are part of your site. Again, leaks probably account for probably two-thirds of the channel size problems we see.The fixes below may apply if your channel has Follow Off-Site Links set to No, or if it is set to Yes and you have already eliminated links to other sites.

    Fix: Work your way through the links within your channel site and eliminate links to unwanted pages:

    • Make a list of any pages within your site that are not available after a sync. (At the same time that you are looking for leaks within your site, you can determine whether any of the missing pages are beyond your channel's Link Depth setting.)
    • Start with links from your home page.
    • Then proceed to links from pages that are linked from your home page, working your way down the links until you have reached your channel's Link Depth. For a detailed description of Link Depth, see The Link Depth setting.
    • Check off any of the missing pages that you come to while you are following links — you are confirming that these pages are within your channel's Link Depth.
    • Look for links to pages that you do not want downloaded with your channel.
    • Remove them from your site entirely, or move them to pages that are outside the Link Depth you have set.
    • Sync again. and see if that clears up the problem.
  9. If any missing pages are beyond your channel's Link Depth setting, bring them within it.
  10. The AvantGo sync server will never download any page on your channel site that is more links away from your home page than the number specified for your channel's Link Depth. For a detailed discussion of link depth, see The Link Depth setting.

    If you just checked for leaks within your site, you have already determined whether any of the missing pages are beyond your Link Depth setting. If you skipped that step:

    • Make a list of any pages within your site that are not available after a sync.
    • Start from your home page and count the number of links it takes to reach each missing page (by the shortest route).
    • Note any pages for which this link count is more than your Link Depth setting.

      If any of the missing pages are beyond your channel's Link Depth, there are two possible solutions.

      Fix 1: If increasing your channel's Link Depth would add a lot of pages that you don't want to download in a sync:

    • Add at least one link to each missing page from a page that is "close enough" to the home page — that is, you can get to it with a count of links equal to the channel Link Depth minus one.
    • If it really doesn't make sense to link a missing page from any page other than one that is already at your channel's Link Depth, you can add an invisible link to it from your home page. See Downloading a page beyond channel's Link Depth.

      Fix 2: If increasing your channel's Link Depth would not add a lot of pages that you don't want to download in a sync:

    • Go to the Channel Properties screen for the channel.
    • Increase the Link Depth setting to a value that will include the missing pages.
    • Sync again and see if this clears up the problem.
  11. Make your Maximum Channel Size fit your channel content.
  12. If none of the troubleshooting steps above has eliminated your missing page(s) problem, your channel content is probably just too large for the Maximum Channel Size you have set.

    Fix 1: If your current Maximum Channel Size setting is really small:

    • Go to the Channel Properties screen for the channel.
    • Increase the Maximum Channel Size setting to a value that will be large enough to hold the missing pages.

      For more information on setting Maximum Channel Size, see The Maximum Channel Size setting.

    • Sync again and see if this clears up the problem.

      Fix 1: If your current Maximum Channel Size setting is as large as you are willing to make it:

    • Redesign your site, eliminating some pages or putting them beyond the channel's Link Depth.
    • Consider setting Follow Off-Site Links and Include Images to No.
    • Sync again and see if this clears up the problem.


TOC PREV NEXT INDEX