Installing SAP xMII: Upgrading from an ISAPI Version

Note: If you are upgrading from an AS version, see Installing SAP xMII: Upgrading from an AS Version. If you are installing SAP xMII for the first time, see Installing SAP xMII.

Note:  If an error occurs during installation, review the install logs for more information.

1. Make sure you are logged on to the server machine using an Administrator account.

2. If you are running Windows NT, stop the Web server and IIS via the Control Panel Services applet.
   OR
   If you are running Windows 2000 or Windows 2003, stop the Web server and IIS via Start -> Programs -> Administrative Tools -> Services by stopping the IIS Admin Service.
   
   This process automatically stops dependent services such as the World Wide Web Publishing service, FTP service, and SMTP service.

3. If you have CD media, insert the SAP xMII CD into your CD-ROM drive.
   Auto-run opens the SAP xMII Installation page in your default browser.
   OR
   If you downloaded the software from the SAP Service Marketplace, extract the downloaded archive to a local directory and then open the xMIIInstall.htm page in the chosen directory.

Note: If you are using a CD and auto-run fails, you can open the xMIIInstall.htm page from the CD root. A link to the Sun Java 2 SDK installation is also available on this page. Once the JSDK is installed, you can run SETUP.EXE directly from the installation folder.

4. If you already installed the Sun JSDK 1.4.2_07 on the server, continue to step 5.
   If a prior version of the Sun JDK or JRE is installed, uninstall the JDK/JRE and all references to Sun Java products including the following:

   • Java 2 Runtime Environment (JRE)

   • Java 2 Software Development Kit (SDK)

   • Residual folders and files under the root directory (i.e., C:\jdk1.3.1_01) or under \Program Files\Java

   • Registry entries (via Start | Run, enter Regedit in the Open field, select HKEY_LOCAL_MACHINE\SOFTWARE, and delete the JavaSoft folder and all its sub-directories)

   Then install the Sun JSDK 1.4.2_07.
   
   If the Sun JSDK 1.4.2_07 is not installed, download the JSDK from http://java.sun.com/products/archive/j2se/1.4.2_07/index.html. Click Download J2SDK, save the file to disk, and run the setup from the local disk.

5. Select the SAP xMII 11.5 installation link.
   The InstallShield Wizard for SAP xMII screen appears.

1. If you did not stop the IIS services, a dialog appears. Click Yes to stop the service.
   Another dialog appears.

2. Click OK to acknowledge that the IIS services were stopped successfully.

6. The Welcome screen for the InstallShield Wizard appears. Click Next.

Note: You may click Cancel at any time to stop the installation.

7. The License Agreement window appears. Read the license agreement carefully.
   Click Yes to accept the agreement and continue the installation.
   OR
   If you do not accept the license agreement, click No. The setup stops and InstallShield Wizard closes.
   If you are upgrading from 11.0.x ISAPI, continue to step 12.

8. If you are upgrading from 10.1.x or prior, the Lighthammer Directory screen appears.

1. Choose the destination folder where you want to install the SAP xMII application. The default destination folder is acceptable, although it is recommended that you install the Lighthammer directory to the same drive on which you installed IIS. The Lighthammer directory should be installed on the root of the drive you choose. You should not install it in locations such as Program Files. Click Next.
   

2. The Confirm New Folder dialog appears. Click Yes to create the new folder.

9. The Choose Destination Location screen appears. The default location of C:\Inetpub\wwwroot is acceptable; however, if you moved your default Web root, enter the correct directory. Click Next.
   

10. A Question dialog appears to verify that a version prior to 11.0 was found on your system. Click Yes to continue the installation.

11. The Choose Destination Location screen appears. Enter the root directory of your current installation.
    

12. The ServletExec ISAPI filter must be uninstalled in order to continue with this installation. To correctly uninstall the ISAPI filter, the installation must first reinstall the ISAPI filter. Click OK after reading the informational dialog.

13. The ServletExec ISAPI Setup screen appears.

1. Click Next in all ISAPI setup screens to accept all defaults.

Note: Ignore any errors that may occur.

2. Clear the Display the README file check box. You do not need to read the file.

3. Click Finish.

4. Close the ServletExec 5.0 ISAPI screen that appears.

14. Once the ISAPI install completes, you must uninstall it.

1. A dialog appears. Click OK to uninstall the ISAPI filter.
   
    

2. Click Yes to uninstall ServletExec ISAPI
   
    

3. Click Yes to stop the IIS Admin service.

4. Click Yes to delete the ServletExec ISAPI install directory.
   
    

5. A dialog appears that states the uninstall is complete. Click OK.

After the ISAPI uninstall is complete, the installation continues.

15. The Choose Destination Location screen appears. Click Next to set the destination folder as the default and initiate the ServletExec AS installation.
    It may take several minutes. You may see one or more windows open and close during this process.

1. Wait for the ServletExec AS install to complete.

2. Click Yes to stop the IIS Admin Service.

16. The Get ServletExec Admin Username and Password screen appears. Enter the username and password.
    
     

17. The Setup Type screen appears. Select the appropriate option button for the amount of RAM you want to designate to SAP xMII via ServletExec AS. It is suggested that a minimum of 512 MB be selected. If it is a dedicated SAP xMII server, we suggest one-half of the server's RAM as a guideline.
    
    
    Note: Once the installation is complete and SAP xMII is operating properly on ServletExec Application Server, it is no longer necessary to restart IIS in order to restart SAP xMII. Go to the Services console, and restart the ServletExec-<InstanceName> (default name is ServletExec-LHCMS) service. This process reloads SAP xMII.

18. Enter the fully qualified machine name (for example, MACHINE_NAME.Domain.com) of the machine on which you are installing SAP xMII. The fully qualified machine name is required to identify the location of the security server in a multiple domain and/or third-party single sign-on scenario. If you are not implementing across domains or using third-party single sign-on, the machine name (without the domain name) is sufficient.

Note:  If SAP xMII is run on a port other than port 80, you must add the port number to the machine name in the SAP Install window.

The installation begins copying files and installing. If an error occurs, the InstallShield stops and the setup does not continue. This process may take several minutes.

19. A Question dialog appears. Click Yes to run the version 11.5 migration tool. The migration tool upgrades your system configurations from your previous version to the current version. If you click No, you can run the migration from the Start menu after the installation.
    

20. The SAP xMII 11.5 Migration screen appears.

1. Click OK to run the system migration.
   

2. When the migration is complete, click Cancel.

If you are upgrading from 11.0.x, continue to step 22.

21. If you are upgrading from 10.1.x or prior, a Question dialog appears. Click Yes to run the Security migration tool.
    
     

22. Click OK to the two informational SAP Install dialogs.
    
    
    
     

23. Click Finish. The installation is complete.

24. See the SAP xMII Installation Guide for additional installation options.