Upgrading from SAP Web tools 6 Service Pack 2 to zed eCommerce 7.4 requires knowledge of the Web tools product and should be completed by a person that performed the implementation or is familiar with it.

Customizations made to the Web tools distributed source code files will need to be reapplied to the zed eCommerce files, therefore some programming knowledge will also be necessary if this was done.

This document only serves as a guide and may not address every issue that could be encountered.  Please proceed with caution. 

Overview of steps:

• 1. Download and upgrade to SAP Web tools Service Pack 2(if necessary)
• 2. Uninstall SAP Web tools Service Pack 2 Installer and Synch manager
• 3. Install zed eCommerce Installer
• 4. Copy instances.xml file to zed eCommerce Installer directory
• 5. Open zed eCommerce Installer and upgrade instance
• 6. Launch zed eCommerce website and complete license key request, install received key
• 7. Install zed eCommerce Synch manager
• 8. Copy NPSynchConfig.xml file to zed eCommerce Synch manager directory
• 9. Launch zed eCommerce Synch manager
• 10. Complete synchronization as normal

 

Prerequisites:

Must be on SAP Business One eCommerce and WebCRM Service Pack 2 or later

This information is available on the about.aspx page of a web tools website  (ie. http://localhost/about.aspx)

NetPoint   2009.2.655.0

NetPoint.API   2009.2.655.0

NetPoint.CreditCards   2009.2.655.0

NetPoint.WebControls   2009.2.655.0

Web Tools Database   655

Make sure to create a test environment that is an exact copy of the live site, with B1 database and Web  tools database, and with copies of the customized files(if any)

Download Service Pack 2 for Web tools:

• 1. Go to http://service.sap.com/support -S number login required
• 2. Choose "Downloads" , "SAP Support Packages" , "Support Packages and Patches - Entry by Application Group" , "SAP Business One" , "SAP Business One 2007" , "SAP BUSINESS ONE WEB TOOLS 6" , "SAP BUSINESS ONE WEB TOOLS 6" , "Win32"
• 3. Choose the link in the "Download Object" column with the title "SAP Business One Web tools 6 SP02"

 

After downloading the zip file, extract the contents to the desktop of the web server and run setup.exe

 Upgrading the Web tools Installer to Service Pack 2

A message will display asking if you wish to upgrade - click yes

 

 

The upgrade will continue, stopping and starting the messaging service

After the upgrade is complete, open the Installer and upgrade the desired instance, by selecting it and clicking the Upgrade button.

 

 

The installer will create a backup of the database and web files, upgrade the database and replace all files with the latest versions 

Click Upgrade to begin this process, when it is complete the home screen will display

Uninstall the Web tools Installer

Uninstall SAP Business One Web tools Installer, via Add/Remove Programs in the control panel or the Start Menu - All Programs - SAP Business One eCommerce and WebCRM - Uninstall

Some of the files will remain in the Program Files\SAP\...\Installer directory and the website will continue to function 

Upgrade to zed eCommerce 7.4

Go to /softwaredownload.aspx

Username and Password is available upon request from your zedIT partner

After downloading the zip file, extract the contents to the desktop of the web server and run setup.exe

Install the zed eCommerce and WebCRM Installer

If a message asking if you would like to upgrade appears, click no and ensure that neither the Installer or Synch Manager are installed

If no message appears continue with the installation of the Installer using the setup program. 

You can install the installer on the web server and the synch manager on the B1 server, just as you would a normal installation of SAP Web tools.

Continue the installation...

After the setup program is finished you should see the icons for the programs you chose to install on the desktop.

 

Next copy the instances.xml file from C:\Program Files\SAP\SAP Business One Web tools\Installer to C:\Program Files\zedIT Solutions\zed Ecommerce and WebCRM\Installer. This file contains all the configuration data for the instance, including web files location, database connection info, and private key. We do this so that the zed eCommerce Installer knows where the locations of these assets are, so it can upgrade them.

 

 

Upgrade the old Web tools Instance

Open the Installer and upgrade the desired instance, by selecting it and clicking the Upgrade button.

The installer will create a backup of the database and web files, upgrade the database and replace all files with the latest versions.

Note: If you have customized aspx or ascx files that are distributed with the product(default system files), they will be replaced with default system files that are included with the latest version.

Place copies of these files in /assets/common/themes/"themeid". The upgrade process will not overwrite any files in this directory.  When finished upgrading, either use a Friendly URL for the item and category(see SEO Functions in 7.4) or use the Page Redirect plug-in within a theme slot(included with the 7.4 installation in the plugins folder)

The default system files you customized will be within the archive created in the Installer program files directory(C:\Program Files\zedIT\...\Installer). Check the release notes for a list of the default system files that have changed, and if you have changed one of those files, merge your changes into the new file. Otherwise, simply place your customized default system files back in the correct directory and overwrite the new default system files.

Click Upgrade to begin this process, when it is complete the home screen of the zed eCommerce Installer will display.

License new zed eCommerce Website

It is possible to have SAP Web tools and zed eCommerce on the same physical server, provided the licenses for both are in the BIN directory for each website.

Launch the website(default is http://localhost/zedsuite) and the license request form page should display

Complete the license request and email the license request key to support@zedit.com

Support will validate the request key and return a response key - please configure any spam filtering or blocking software to allow emails from support@zedit.com or this email may never arrive or will be delayed.

Return to website and enter response key and the site should now display.

Note: Upon entering the license response key you may get a .Net error. If this happens follow the steps below

• 1) Perform a search on the system drive (c:\) for any file with a .lic extension, making sure you include hidden files in the search.
• 2) The old SAP Web tools license file will be in a folder deep within the user profile directory called "Isolated Storage". Move(do not copy) this file to the BIN directory of the web tools website. By default this is Inetpub\wwwroot\B1Webtools\BIN. The Web tools website should still work.
• 3) Try to enter the license for zed eCommerce again. If this fails, save the license file itself in the BIN directory of the zed eCommerce website. (Inetpub\wwwroot\zedsuite\BIN)

 

Customized Source Files

If distributed source files were customized within SAP Web tools, they should have been copied to the aforementioned /assets/common/themes/themeid folder

For example, if the /catalog/partlist.aspx file had been modified to show more or less than the default number of records(20) then partlist.aspx should be placed in this folder. The upgrade will not overwrite the file if it is in this directory, but it will overwrite the /catalog/partlist.aspx file.

Use the Page Redirect plug-in within any theme slot to load the customized version of this file when the user navigates to /catalog/partlist.aspx. If not using a Friendly URL(eCommerce 7.4 only) on the category, you'll see the new full path( www.sample.com/assets/common/themes/themeid/partlist.aspx). If you are using Friendly URL you'll see the customized file, but with the shortened Friendly URL.

Load the website and test to make sure all customizations were correctly merged and that the website is functional.

Theme Slot Update

You may encounter an error when attempting to login to the new theme.  This is due to the addition of a new content placeholder in the commonlogin master page used to show the Express Checkout login field.  If the instance upgraded included a theme created in Web tools Service Pack 2 and was set as the default theme, or if you directed the browser to this theme you would see an error indicating the commonlogin master page does not contain this content placeholder.

To correct this issue, follow the steps below.

1) Open the theme details and go to the masters tab, and click on the link for commonlogin.master page

 

 

2)  The next window is the contents of the file, click the edit icon to edit

 

3)  By default, the main slot content contains the new user and login user slots highlighted below

  

4)  This should be updated with the new layout, copy the:

<asp:Content ContentPlaceHolderID="mainslot" ID="mainslotcontent" runat="server">
    <table width="100%" cellpadding="3" cellspacing="0" border="0">
   <tr>
    <td width="100%" valign="top" colspan="2">
   <asp:ContentPlaceHolder ID="messageslot" runat="server"></asp:ContentPlaceHolder>
    </td>
    </tr>
    <tr>
    <td width="50%" valign="top">
    <asp:ContentPlaceHolder ID="newuserslot" runat="server"></asp:ContentPlaceHolder>
    </td>
    <td width="50%" valign="top">
    <asp:ContentPlaceHolder ID="loginslot" runat="server"></asp:ContentPlaceHolder>
    </td>
    </tr>
    <tr>
    <td width="100%" valign="top" colspan="2">
   <asp:ContentPlaceHolder ID="expressslot" runat="server"></asp:ContentPlaceHolder>
    </td>
    </tr>
    </table>

</asp:Content>

5)  When finished click save and click the Home icon in the Administration Toolbar to view the theme

6) Logout from the theme and return to /common/accounts/login.aspx the page should load successfully.

 

Item Remarks Content Placeholder

In version 7.1.0 of zed eCommerce new functionality was introduced that synchronizes item remarks in Business One with a new field in zed eCommerce called "part remarks"

This new functionality included an update to the catalogpartdetail.master template and the content placeholder must be included in this template for the item detail screen to display in the  webstore.

Any theme created in a previous version must have this content placeholder within the catalogpartdetail.master

 

• 1) To edit the catalogpartdetail.master page, open the theme details and click the highlighted item below

 

 

• 2) Edit the master page by clicking on the edit icon

 

 

• 3) Enter this code in the master page in the desired location. For example between the partcrossell and the partnotes content placeholders

<asp:ContentPlaceHolder ID="partremarks" runat="server"></asp:ContentPlaceHolder>

• 4) Save

 

Uninstall Web tools Synch Manager

Ensure the Synchronization Service is stopped before continuing. If a synch is in progress, let it complete and then stop the service.

Uninstall the Web tools Synch Manager, via Add/Remove Programs  in the control panel or the Start Menu - All Programs - SAP Business One eCommerce and WebCRM - Uninstall

Some files will remain in C:\Program Files\SAP\...\Synch Manager directory

Run setup.exe and install the zed eCommerce Synch Manager

If you are prompted to upgrade, click no and ensure that the Synch Manager is fully uninstalled

Launch zed eCommerce Synch Manager

Copy NPSynchConfig.xml from C:\Program Files\SAP\...\Synch Manager to C:\Program Files\zedIT\Synch Manager

 

Open the zed eCommerce Synch Manager and complete a normal synchronization, do not initialize synch. You might see some upgrade scripts executed and a "Finished Synchall" in the log once the upgrade is complete.

The upgrade is complete