Installing the GoLive Preconfigured Servers on Mac OS X 10.1-10.1.5
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 depends only on the Java(TM) runtime environment on Mac OSX. In fact, the package 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.22"
- Tomcat JSP web server engine version "jakarta-tomcat-3.2.2"
- PHP plug-in for Apache version "4.1.1"
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.
|
Language
|
Required |
| PHP |
GoLive Preconfigured Servers and MySQL |
| JSP |
GoLive Preconfigured Servers, MySQL, and MySQL JDBC Driver |
| ASP |
Windows IIS or Personal Web Server |
Step 2: Insert the Workgroup CD
The GoLive Preconfigured Servers are included on the Workgroup Server Installation CD which can be found in the back of the Workgroup Server manual included in the GoLive 6 box. Find that CD, insert it into your Mac running OS X 10.1 or newer and you should see a window that looks like Figure 1.1.
Figure 1.1
Step 3: Open the Dynamic Content folder
Open the Dynamic Content folder and you will see the GoLive Preconfigured Servers installer as seen below in Figure 1.2.
Figure 1.2
Step 4: Launch the GoLive Preconfigured Servers installer
Double-click the GoLive Preconfigured Servers icon to run the installer and you will be presented with a ReadMe file and three different license agreements you must read and agree to as seen in Figures 1.3-1.6.
Figure 1.3
Figure 1.4
Figure 1.5
Figure 1.6
Step 5: Enter Server Information
After you accept all three license agreements you'll see a dialog box that asks you for the server name, port number, and administrator email address as seen in Figure 1.7.
Figure 1.7
The server name is the machine name of the current machine and can be found in the Computer Name field of the Sharing panel of the OS X System Prefs as seen in Figure 1.8. The Server Port of 8200 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 Continue.
Figure 1.8
Step 6: 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 OK when ready.
Figure 1.9
Step 7: Review Installation Settings
The next dialog shows a summary of the settings you have selected. If everything looks good proceed by clicking OK. If you need to change a setting click Previous and make the necessary changes. Your dialog box should look like the one in Figure 1.10 except your Server Host Name and Server Administrator Email should be unique to you and your computer.
Figure 1.10
Step 8: Choose Installation Location
The next step is to select the location of the installation. We recommend you proceed with the default location which is in the OS X Applications folder as seen below in Figure 1.11. Server logs and temporary server files are placed in this area so it must be writable by the user under which the server runs. Click Install to begin the installation.
Figure 1.11
Step 9: Watch the Progress Bar
After you click Install 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 1.12.
Figure 1.12
Step 10: Not Done Yet!
When the installer is done you'll see a dialog like the one shown below in Figure 1.13 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 Quit as seen in Figure 1.14 to proceed to the next phase of the installation. You'll notice there are six new generic-looking file aliases on your Desktop. Even if the clutter annoys you do not delete them because they will be very important before we're done.
Figure 1.13
Figure 1.14
Step 11: Create New User
To run a MySQL database on Mac OS X you must create a user with the short name of mysql.
Make sure you are currently logged into an account on your Mac OS X system that has admin privileges. Open the "Users" System Preferences Pane and click New User... as seen in Figure 1.15 to create a new user account which is required for a MySQL database to run on OS X.
Figure 1.15
Step 12: Assign New Username
Create a new user with the name of MySQL User and the short name of mysql as seen below in Figure 1.16. Note that the Short Name must be lower case and match mysql exactly and the longer name does not have to match exactly.
Figure 1.16
Step 13: Assign a Password
Click the Password tab in the New User dialog and set the password to anything you want as seen below in Figure 1.17. Click Save to save the new user and you should see the new user account in the Users preference pane as seen below in Figure 1.18. Quit the System Preferences (Command-Q) and proceed to the next step.
Figure 1.17
Figure 1.18
Step 14: Locate and Copy the "Extras" installation files
Open the Adobe Web Workgroup Server installation CD and copy the Extras (Figure 1.19) folder to your Desktop as seen below in Figure 1.20.
Figure 1.19
Figure 1.20
Step 15: Locate MySQL Installation Files
Double-click to open the Extras folder you just copied to your Desktop and you should see a folder called MySQL Database as seen below in Figure 1.21. Double-click to open the MySQL Database folder and you should see the folder of MySQL installation files as seen below in Figure 1.22.
Figure 1.21
Figure 1.22
Step 16: Launch Terminal
Open the Terminal application which is located in the Applications/Utilities folder on your hard drive. The application icon looks like Figure 1.23.
Figure 1.23
When you have copied the Extras folder to your Desktop, type
cd ~/Desktop/Extras/MySQL\ Database
and press Return in the Terminal window to change your working directory to the folder containing the install.sh and the mysql-3.23.47-binary.tar.gz files. Note the backslash and space in front of the word "Database" is required. Your Terminal window should now look like Figure 1.24. The green highlight shows the text you need to type in the Terminal. You can also copy the red text above and paste it into the Terminal window.
Figure 1.24
Step 17: Run MySQL Install Script
To run the MySQL installer script type
sudo ./install.sh
and press Return in the Terminal window as seen in Figure 1.25. This will temporarily enter into SuperUser mode and install MySQL in the /usr/local/ directory on your system.
Figure 1.25
You will probably be asked to type the password for the account you are currently logged in under. Note that when you type the password, nothing will appear on the screen as seen in Figure 1.26.
Figure 1.26
Press Return to confirm your user password and when the installation is complete your Terminal window should look like Figure 1.27.
Figure 1.27
Step 18: Start MySQL
After installation, you need to start MySQL in order to use it to serve databases. Remember, you need to do this each and every time you restart your computer. Double-click the Start MySql (Figure 1.28) alias that was installed by the GoLive Preconfigued Servers installer on your Desktop to run the start_mysql.command in the preconfigured server install folder (usually /Applications/GoLive Preconfigured Servers). If you see an error dialog requesting an application to use for the selected file choose the Terminal application located in the /Applications/Utilities folder.
Figure 1.28
A Terminal window should open and look like Figure 1.29 when successfully completed.
Figure 1.29
Step 19: 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 you already copied to your Desktop or on the Workgroup Server CD in the Extras/MySQL JDBC Driver folder as seen in Figure 1.30.
Figure 1.30
Copy the mmmysql.jar file from the Extras/MySQL JDBC Driver folder to the Applications/GoLive_Preconfigured_Servers/jsp_server/tomcat/lib folder as seen in Figure 1.31. You can copy the file by either Option-Dragging the mmmysql.jar file to the new location, or you can select the file, choose Edit>Copy "mmmys.ql.jar" (Command-C), then move to the new location and select Edit>Paste item (Command-V). This makes the driver available to all web sites hosted on the preconfigured server.
Figure 1.31
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 20: Install the iconv library for PHP
If you wish to use PHP you need to install the iconv library. Copy the libiconv.2.0.4.dylib file from the Extras/iconv folder you already copied to your Desktop or from the Workgroup Server CD in the Extras/iconv folder to the Applications/GoLive_Preconfigured_Servers/php_server/lib folder as seen below in Figure 1.32. This makes the library available for use by PHP. When the libiconv.2.0.4.dylib file has copied successfully you can delete the Extras folder from your Desktop.
Figure 1.32
Step 21: Start the Web Server
Now that everything has been installed you must start the web server by double-clicking the Start Webserver alias installed on your Desktop as seen in Figure 1.33 to run the start_all.command in the preconfigured server install folder (usually /Applications/GoLive Preconfigured Servers). If you see an error dialog requesting an application to use for the selected file choose the Terminal application located in the /Applications/Utilities folder.
Figure 1.33
Double-click the Start Webserver alias on your Desktop to launch the Terminal application and when the server is started successfully your Terminal window should look like Figure 1.34. The text highlighted in green below indicates a successful installation and server start. When you have a successful server start you can Quit the Terminal application and dismiss any open Terminal windows.
Figure 1.34
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.
|
