| Install Method 2 – Infor Enterprise Server Extensions Installer |  |
| This chapter describes the following topics: To install Web UI through the Infor Enterprise Server Extensions Installer. How to start and stop the Tomcat web server on Windows. How to start and stop the Tomcat web server on Unix/Linux. To update a Web UI installation. To uninstall Web UI. To install Web UI through the Infor Enterprise Server Extensions Installer The Infor Enterprise Server Extensions installer includes the installation of an Open Source Java servlet container, Tomcat, and the installation of the Report Viewer. This installer is useful if you plan to use Tomcat as the servlet container, or if you want to be up and running quickly. The Infor Enterprise Server Extensions installer takes care of Web UI configuration. Note You can also use the installer to install Infor ERP LN Connector for Web Services Using the installer, only one Web UI version can be active on the web server. When installing a different version, the installer always detects the previously installed version and overwrites that one. For details on how to install Web UI on a clean system, refer to the Infor Enterprise Server Extensions 8.x - Installation Guide (U9484 US). The Infor Enterprise Server Extensions installer can also be used to install a different version over an already existing installation. For details, refer to To update a Web UI installation. Note You can reuse the settings of the previous Web UI version in the new environment. To do this, copy the settings that you saved during the uninstallation to the <new installation-directory>\webtop\config directory. For information on how to save Web UI settings, refer to To uninstall Web UI. Further in this chapter, the To uninstall Web UI section describes how to uninstall Web UI. Please refer to Appendix A for the system requirements for the web server and Desktop. How to start and stop the Tomcat web server on Windows To start the Tomcat web server, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Startup Tomcat. To stop the Tomcat web server, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Shutdown Tomcat. Alternatively, complete the following steps: To start the Tomcat web server, browse to the <installation-directory>\apache-tomcat-6.0.29\bin directory and run startupTomcat.bat. To stop the Tomcat web server, browse to the <installation-directory>\apache-tomcat-6.0.29\bin directory and run shutdownTomcat.bat. Note Do not use the batch files that are part of the standard Tomcat distribution, startup.bat and shutdown.bat; these do not set the environment variables JAVA_HOME and JRE_HOME to the required values. Install Tomcat as a service If you want Web UI to run when the machine is booting, you can install Tomcat as a service. During the installation you are presented with the option to do so. If you did not choose that option and wish to register Tomcat as a service afterwards, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Install Service. Alternatively, enter the following command on the command line: `<installation-directory>\apache-tomcat-6.0.29\bin\installTomcatService.bat` To change the service Once you have installed Tomcat as a service, you can change the startup type to "automatic". Change the properties of the " Infor Enterprise Server Extensions " service by using the "Services" management console. To start and stop the service To manually start the Tomcat service, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Start Service. Alternatively, enter the following command on the command line: `net start InforEServerExtensions` To stop the Tomcat service, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Stop Service. Alternatively, enter the following command on the command line: `net stop InforEServerExtensions` To uninstall the service To Uninstall the " Infor Enterprise Server Extensions " service, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Uninstall Service. Alternatively, enter the following command on the command line: `<installation-directory>\apache-tomcat-6.0.29\bin\uninstallTomcatService.bat` How to start and stop the Tomcat web server on Unix/Linux Open a console and go to the installation directory to start the Tomcat web server. Change directories to the apache-tomcat-6.0.29/bin subdirectory. To start the web server, run ./starttomcat.sh. To stop the web server, run ./stoptomcat.sh. Note Do not use the shell scripts that are part of the standard Tomcat distribution, startup.sh and shutdown.sh, because these do not set the environment variables JAVA_HOME and JRE_HOME to the required values. Install Tomcat as a service To have Web UI start automatically when the machine is booting, create an initialization script that will run when switching run levels. Please refer to the documentation of your Unix/Linux distributor for further details. For a machine with a SysV style initialization, create a script in /etc/init.d and links in the /etc/rc n.d directories. To update a Web UI installation If Web UI is already installed, you can run the Infor Enterprise Server Extensions installer again to update the current Web UI installation. Points of attention Existing user contexts, web server, Web UI configurations, and log files are not affected by an update. The update overwrites only files that are directly related to the Web UI application. The following files are preserved with an update: User contexts Any user contexts created by an administrator or an end user are preserved. User contexts are located in the <installation-directory>\Webtop\config\usercontexts directory. Web server configuration Configuration of the web server is not affected by an update. Tomcat configuration is stored in the <installation-directory>\apache-tomcat-6.0.29\conf directory. Web UI configuration Configuration of the Web UI application is not affected by an update. Web UI configuration is stored in the <installation-directory>\Webtop\config directory. This includes company settings, smart links, Infor ERP environments, and the Infor ERP LN Web Help configuration. Log files Log files that were previously created are not removed with an update. The installation log of the update is appended to the current installationlog.txt file located in the installation root directory. Company logo and background image During an update the company logo and background image are not overwritten. If you customized the company logo or the background image, this customization is not affected by an update. The following files are modified or removed during an update: Web UI files All files located in the <installation-directory>\Webtop\web directory that were installed by the previous Web UI version are overwritten with the files contained by the update. Note You cannot update an old Web UI installation installed with a previous version of the Web UI Installer delivered with Web UI 8.4 and older. In this case you must uninstall the old Web UI, and then perform a "new installation" with the new installer. When you uninstall the old Web UI, ensure that you save your Web UI settings, so that you can reuse them for the new Web UI version. To save the settings, create a new directory in a location that will not be overwritten by the new installation. Then, copy the contents of the <current installation-directory>\webtop\config directory to the new directory. For details, refer to To uninstall Web UI and To install Web UI through the Infor Enterprise Server Extensions Installer. Procedure Note: For details on the installer pages used in the procedure, refer to the installer's online Help. To update a Web UI installation, complete these steps: Stop the web server. Ensure the Tomcat web server is not running. In Windows, complete one of these steps: If Tomcat is installed as a service, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Stop Service. Alternatively, enter the following command on the command line: `net stop InforEServerExtensions` If Tomcat is not installed as a service, click Start -> All Programs -> Infor ERP LN-> apache-tomcat-6.0.29 -> Shutdown Tomcat. Alternatively, press CTRL+C in the Tomcat window that was opened when starting the Web UI server. In Unix/Linux, run stoptomcat.sh in the apache-tomcat-6.0.29/bin subdirectory of the Web UI installation. Ensure the contents of the Infor Enterprise Server Extensions media are copied to a local directory. Go to this directory and copy a different webtop.war file over the old webtop.war file in the InstallableUnits\Webtop subdirectory. Note: To install a new version of the Report Viewer, copy a different reportviewer.war file over the old reportviewer.war file in the InstallableUnits\ReportViewer subdirectory. Read the installationinstructions.txt file in the Staging Area main directory. This file explains how you can start the installer for various platforms. Start the appropriate installer for your platform. In the Introduction screen, click Next. The Select install set page appears. Select Custom and then click Next. The Select Install Folder page appears. Accept the default folder and click Next. The Select features page appears. Select the Web UI for ERP LN <version number> check box. Clear the remaining check boxes and then click Next. The Select Java virtual machine page appears. Click Next. The Update page appears. Read the information and then click Next. The Administrator Password page appears. Optionally, change the password and then click Next. The ERP Backend page appears. Optionally, change the settings of the ERP backend and then click Next. The Summary page appears. Check the installation summary and then click Install. The installation starts. When the installation successfully finishes, the Install Complete page appears. All actions performed during this installation are logged into files in the Log folder in the installation root directory. If you have encountered problems during the installation, you can read these files to identify the problem or send the files to Infor Customer Support. Note: If you run the installation on Unix/Linux, the same information is also written to the console. Click Next. The Final actions page appears. The installer prompts you to indicate whether you want to start the Tomcat Manager and/or to view the Readme file. Select the desired actions and then click Done. If you selected the View Readme check box, the Readme page appears. View the Readme information: Read the instructions for the Web Help server. Note that the instructions written in this dialog are not applicable for BaanIV. For information on how to install the help content for BaanIV, refer to "Install help content for Infor ERP BaanIV " in Chapter 6. It is mandatory to manually define the Infor ERP LN Web Help server after installation. After the installation, you can re-read instructions on how to do this by opening the postInstallMessage.htm file; this file is located on the installation media or in the <installation-directory>\webtop directory after the installation. Read the recommendation on generating forms. After the installation, you can re-read the message by opening the postInstallMessage_genForms.htm file; this file is located on the installation media or in the <installation-directory>\webtop directory after the installation. To finish the installation, click Done. Important! Web UI 8.7 requires Tomcat 5.5 or higher. If your old Web UI installation was deployed to an older Tomcat version such as Tomcat 4.1, you must install Tomcat 5.5 or higher and deploy the new Web UI installation to the new Tomcat version. For an instructional example of deploying Web UI to Tomcat, refer to Appendix B. To uninstall Web UI Note: When you uninstall the old Web UI, ensure that you save your Web UI settings, so you can reuse them for the new Web UI version. To save the settings, create a new directory in a location that will not be overwritten by the new installation. Then, copy the contents of the <current installation-directory>\webtop\config directory to the new directory. To uninstall Web UI or another Enterprise Server extension, you can use the uninstaller that is created during the installation process. The uninstaller is available for the Windows platform as well as for the Unix/Linux platform. Note: For details on the uninstaller pages used in the procedure, refer to the uninstaller's online Help. To run the uninstaller: Start the uninstaller. On Windows Use the Add/Remove Programs option from the Control Panel . Select Infor_Enterprise_Server_Extensions and then click Change/Remove. On Unix/Linux Open an xterm prompt and start <installation-directory>/_uninst/uninstaller.bin. The Uninstall Infor Enterprise Server Extensions screen appears. Read the information in the screen and click Next. The Uninstall Options page appears. Select Uninstall Specific Features and click Next. The Select features page appears. Select the features you want to uninstall and click Next. The installer prompts you to indicate what to do with files created since the installation, such as user settings and log files. Select Keep all files or Delete all files. Then click Uninstall. The uninstallation starts. Note: If you failed to stop the web server, you will see a warning screen telling you that the application server is still running. Stop the server (as detailed in step 1) and then click Uninstall. When the uninstallation is finished, the Uninstall Complete page is displayed. To close the uninstaller, click Done. Related topics Install ERP LN Report Viewer The Infor ERP LN Web UI Administration Console Set up Web UI to Connect to an Infor ERP LN Server System Requirements Instructional Deployment Examples Prerequisites for the Infor ERP LN Server Prerequisites for using Infor Single Sign On |