Upgrading from SAP Web tools 6 Service Pack 2 to zed E-Commerce 7.1.2 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 E-Commerce 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 E-Commerce Installer
• 4. Copy instances.xml file to zed E-Commerce Installer directory
• 5. Open zed E-Commerce Installer and upgrade instance
• 6. Launch zed E-Commerce website and complete license key request, install received key
• 7. Install zed E-Commerce Synch manager
• 8. Copy NPSynchConfig.xml file to zed E-Commerce Synch manager directory
• 9. Launch zed E-Commerce Synch manager
• 10. Complete synchronization as normal

 

Prerequisites:

Must be on SAP Business One E-Commerce 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 E-Commerce 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 E-Commerce 7.1.2

Go to /softwaredownload.aspx

Username and Password is available upon request

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

 

 

Install the zed E-Commerce 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 E-Commerce 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.
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 E-Commerce Installer will display.

 

License new zed E-commerce 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)

 

Merge Customizations

Merge any changes from the old website files into the new website files. An archive of the webfiles from before the upgrade is within C:\Program Files\zedIT\zed E-Commerce and WebCRM\Installer

A list of changed files is published with each release of zed E-Commerce. If you have customized a file that has been changed in a patch, merge your changes into the new file. If you have customized a file that has not been changed in a patch, you may overwrite this file.

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 E-Commerce new functionality was introduced that synchronizes item remarks in Business One with a new field in zed E-Commerce 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 E-Commerce and WebCRM - Uninstall

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

Run setup.exe and install the zed E-Commerce Synch Manager

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

 

Launch zed E-Commerce Synch Manager

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

 

Open the zed E-Commerce Synch Manager and complete a normal synchronization, do not initialize synch. You might see some upgrade scripts executed and after it says "Finished Synchall" in the log the upgrade is complete.

You are now on the latest version of zed E-Commerce and WebCRM!