Installing the GoLive Preconfigured Servers on Windows 2000

Adobe GoLive 6 now includes visual authoring tools for PHP, JSP, and ASP. The GoLive Preconfigured Servers package includes a web server for PHP and JSP and sample sites all preconfigured to install and run. You can use these servers for dynamic sites developed in GoLive that utilize PHP and JSP. You can also use the servers as examples of how to configure Apache and Tomcat to run PHP and JSP compatible GoLive sites.

Before we get started, it's important to note you must follow these installation steps exactly for everything to work properly. These instructions do not cover anything not already included in the documentation but we think copious screenshots and a few extra tips will help you through this process.

Step 1: What's in the GoLive Preconfigured Servers package?
The package includes all components needed and tries not to use or disturb other software on your server machine.

The following components are included in the GoLive Preconfigured Servers installation:

• Apache Web server version "1.3.20"
• Tomcat JSP web server engine version "jakarta-tomcat-3.2.2"
• PHP plug-in for Apache version "4.1.0"
• Java(TM) runtime environment versino "Java(TM) 2 SDK, Standard Edition, v 1.3.1"
• Zend(TM) Debugger for PHP

What do you need installed to use each of the server languages (PHP, JSP, ASP) supported by GoLive? Here's a brief summary and more details are available on page 434 in the printed GoLive 6 manual.

Step 2: Insert the Workgroup CD
The GoLive Preconfigured Servers are included on the Web Workgroup Installer CD which can be found in the back of the Adobe Web Workgroup Server User Guide included in the GoLive 6 box. Find that CD, insert it into your computer, and you should see the autoplay screen like in Figure 6.1.

Step 3: Launch the Dynamic Content Web Server Installer
Click the Dynamic Content Web Server button to launch the installer. If the Autoplay screen doesn't display just find and launch the installer located at Dynamic Content/Setup.exe on the Web Workgroup Installer CD. When the installer launches you will see the InstallShield Wizard and ReadMe as seen below in Figures 6.2 and 6.3. Click Next after reading each screen.

Step 4: Accept the License Agreements
Read and accept the four license agreements for Apache, PHP, Zend, and Tomcat as seen in Figures 6.4-6.7.

Step 5: Select Server Installation Location
After you accept the four software license agreements you need to select the installation location. Keep things simple and accept the default location as seen below in Figure 6.8 or click the Browse... button to customize the location.

Step 6: Enter Server Information
After you choose the installation location you'll see a dialog box that asks you for the server name, port number, and administrator email address as seen in Figure 6.9.

The server host name is the machine name of the current machine. To find the machine name right-click on the My Computer icon on the desktop, choose Properties, and look at the Network Identification tab as seen in Figure 6.10. Use the machine name as listed in the Full compUter name field without the trailing period. The Server Port of 82 should be fine unless there is another program on your machine using this port number. The Server Administrator Email address appears in some error messages the server may display but no email is sent to this address by the server. Enter your email address and click Next.

Step 7: Enter JSP Ports
The default values for the JSP ports in the next dialog should be fine unless you have previously installed other servers. These two port numbers are needed for the Apache and Tomcat components of the web server to communicate. These port numbers are only used internally but you need to supply values that are not in use by some other program. If you have problems, reinstall using different port numbers. These port numbers are not used by GoLive or the browser when accessing the server. Click Next when ready.

Step 8: Review Server Installation Settings
The next dialog shows a summary of the settings you have selected. If everything looks good proceed by clicking Next. If you need to change a setting click Back and make the necessary changes. Your dialog box should look like the one in Figure 6.12 except your Server Host Name and Server Administrator Email should be unique to you and your computer.

Step 9: Watch the Server Installer Progress Bar
After you click Next the files will be copied to your computer's hard drive from the installation CD and you'll see a progress bar like the one shown below in Figure 6.13.

Step 10: Not Done Yet!
When the installer is done you'll see a dialog like the one shown below in Figure 6.14 that explains that there are actually more required steps in the installation process. Most users of Adobe software are accustomed to extremely simple software installations. However, due to various technical and third-party licensing restrictions this installation requires a few more steps to complete. It's not difficult, but you need to follow the rest of the instructions exactly or the servers probably will not work. Click Finish as seen in Figure 6.14 to proceed to the next phase of the installation.

Step 11: Locate and Lanch the MySQL Installer
Locate and launch the MySQL Installer at Extras/MySQL DataBase/SETUP.exe on the Web Workgroup Installer CD and you will see the welcome screen as seen below in Figure 6.15. Click Next to proceed.

Step 12: Review MySQL Installer Notes
Review the installation information as seen in Figure 6.16 and click Next to proceed.

Step 13: Select MySQL Installation Location
We strongly recommend you accept the default installation location and click Next as seen below in Figure 6.17. If you must change the installation location you can click the Browse... button but you will be required to create a custom configuration file which is not covered in this tutorial.

Step 14: Select MySQL Installation Type
We recommend you select the Typical installation option and click Next as seen below in Figure 6.18.

Step 15: Watch the MySQL Installer Progress Bar
After you click Next the files will be copied to your computer's hard drive from the installation CD and you'll see a progress bar like the one shown below in Figure 6.19. The MySQL installer should quit when finished.

Step 16: Install the MySQL JDBC driver for JSP
If you wish to use JSP with MySQL, you will need to install a JDBC driver that supports MySQL. One is available in the Extras/MySQL JDBC Driver folder on the Web Workgroup Installer CD.

Copy the mmmysql.jar file from the Extras/MySQL JDBC Driver folder to the DC_Web_Server/jsp/tomcat/lib folder as seen in Figure 6.20. You can copy the file by either dragging the mmmysql.jar file to the new location, or you can select the file, choose Edit>Copy (Control-C), then move to the new location and select Edit>Paste (Control-V). This makes the driver available to all web sites hosted on the preconfigured server.

Note: To install the driver in a specific JSP site, copy the mmmysql.jar file to the WEB-INF/lib folder of the site. This makes the driver available to that specific site. This should be done when the driver is not installed on the server itself. The Apache web server will need to be restarted after the library is uploaded to the server.

Step 17: Start the MySQL Database
Now that everything has been installed you need to start MySQL in order to use it to serve databases by selecting Programs>Adobe>Dynamic Content Server>Start MySQL Database from the Windows Start menu as seen below in Figure 6.21.

When you start MySQL you should see a DOS prompt like the one in Figure 6.22. Press any key, such as the space bar, to proceed to the next step.

Next you should see a dialog box like the one in Figure 6.23 which asks for a username and password. Type the username and password for the current Windows user and click OK to start the MySQL Database. You do not have to restart MySQL each time you restart the machine. When you restart Windows, MySQL should restart itself.

Step 18: Start the Web Server
The last step in the installation process is to start the Apache Web server by selecting Programs>Adobe>Dynamic Content Server>Start Web Server from the Windows Start menu as seen in Figure 6.24.

When you select this script you should see two DOS prompts similar to those in Figures 6.25 and 6.26 when successfully completed. Every time you restart the machine you need to start the Web servers with the Start Web Server script and leave these two windows open. It's safe to minimize these windows to avoid screen clutter but do not close them or the servers will stop.

Conclusion
Congratulations! If you made it this far then the worst part is over. You should only have to go through this installation process once to get everything set up properly and from now on you'll spend a lot more time in GoLive! For more free tutorials, tips, and tricks visit the Tips page.