Cloudpath Administrative Console  |     Logout

The following instructions will assist you with installing, configuring, and troubleshooting an Apache web server to host Cloudpath. The instructions are based on Windows 2003 Server. The configuration settings should apply to Apache on any OS.
Apache+PHP Installation, Configuration & Troubleshooting
Apache & PHP Installation (Windows 2003 Server)
The following steps describe the process of installing the Apache web server on a Windows 2003 Server with support for PHP.
Step 1:Download Apache 2.2.4.
Go to http://httpd.apache.org/download.cgi.
Under the 2.2.4 heading, download the Win32 Binary (MSI Installer) file.
Save the file to the desktop.
Step 2:Install Apache 2.2.4.
Double-click on the Apache file on the desktop.
On the Welcome page, click Next.
On the License Agreement page, review the EULA and if acceptable, select I accept the terms in the License Agreement and Next.
On the Read This First page, click Next.
On the Server Information page:
Populate the Network Domain, Server Name, and Administrator Email fields.
Select the For all users, on port 80, as a service option.
Click Next.
On the Setup Type page, select Typical and click Next.
On the Install Location page, specify the install location and click Next.
On the Ready To Install page, click Install.
Apache will install as a service and will startup automatically.
Step 3:Download PHP 5.
Go to http://www.php.net/downloads.php.
Under the Windows Binaries heading, download the PHP 5.2.3 installer file.
Save the file to the desktop.
Step 4:Install PHP 5.
Double-click on the PHP file on the desktop.
On the Welcome page, click Next.
On the License Agreement page, review the EULA and if acceptable, select I accept the terms in the License Agreement and Next.
On the Destination Folder page, specify the install location and click Next.
On the Web Server Setup page, select Apache 2.2.x Module and click Next.
On the Apache Configuration Directory page, locate the conf directory of the Apache install. By default, this is C:\Program Files\Apache Software Foundation\Apache2.2\conf. Once specified, click Next.
On the Choose Items To Install page, ensure Program and Web Server Setup are selected and click Install.
On the Ready To Install page, click Install.
PHP will install and register itself with Apache. Note: PHP will not work until the Apache service is restarted in a later step.
Apache Configuration
The following steps describe the process of configuring the Apache web server to host Cloudpath.
Step 1:Register Java and iPhone MIME Types.
Open the Apache conf directory. The default location on Windows is C:\Program Files\Apache Software Foundation\Apache2.2\conf. In Redhat-based Linux distros, the default location is /etc/httpd/conf.
Open the httpd.conf file with a text editor like Notepad or VI.
Within the file, locate the comment with AddType in it. After this comment, add the following lines:
AddType application/x-java-jnlp-file .jnlp
AddType application/x-apple-aspen-config .mobileconfig
AddType image/x-icns .icns
AddType cloudpathnetworks/xpressconnect .netconfig
AddType application/vnd.android.package-archive .apk
AddType application/x-x509-ca-cert .cer
AddType application/x-pkcs7-certificates .p7b
AddType application/x-onc .onc
Save and close the file.
Step 2:Restart Apache Service.
For modifications to take effect, the Apache service must be restarted.
Deploying To Apache+PHP
The following steps describe the process of deploying Cloudpath to the Apache web server with PHP support.
Step 1:Using a browser on the web server, navigate to the Cloudpath Administrative Console.
Step 2:Select the Deploy tab.
Under the Web Server label, click PHP.
Save the downloaded file to the desktop.
Step 3:Unzip the downloaded file.
Using WinZip or another zip utility, unzip the files into the htdocs directory. By default, this is C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\.
Step 4:Cloudpath is ready to use.
Apache+PHP Verification
The following steps describe the process of verifying the proper operation of the Apache web server. The URL examples assume that Cloudpath is located at http://127.0.0.1/. The page names specified (page1.html, page4_download.html) are files included in the Cloudpath package.
Step 1:Test the server using the Server Verifier applet. Using a computer with Java installed, open the browser to the web server and query info/test.html. For example, this may be http://127.0.0.1/info/test.html
Once initialized, the applet will run a series of tests against the server to verify common misconfigurations or package corruptions.
If the applet reports that the tests executed successfully, the server should be correct. On new servers, we recommend running the manual tests below as well.
If the applet reports failures, selected the Errors and Warnings tab to review the issues.
Apache+PHP Troubleshooting
The following describes the steps helpful when troubleshooting an Apache web server. The URL examples assume that Cloudpath is located at http://127.0.0.1/. The page names specified (page1.html, page4_download.html) are files included in the Cloudpath package.
Step 1:Test the ability to load a basic web page. To do so, query page1.html using a URL similar to http://127.0.0.1/page1.html.
If the Firefox states 'Unable to connect' or IE states 'IE cannot display the page.', verify the Web Site settings related to IP address and port. If using a DNS name in the URL, try loading the page using the IP address rather than DNS name.
If the page loads properly, the basic HTML functionality is correct.
Step 2:Test the default page functionality. To do so, query without specifyling a page, using a URL similar to http://127.0.0.1.
If the page loads, the default page functionality is correct.
Step 3:Test the ability to execute a PHP page. To do so, query the PHP test page using a URL similar to http://127.0.0.1/test.php.
If the page shows your IP address, PHP pages are loading properly.
If the page does not display an IP address or has additional text, verify that PHP is correctly registered with Apache.
Step 4:Test the ability to download an executable. To do so, query the manual download page using a URL similar to http://127.0.0.1/page4_download.html. Click the Cloudpath link to manually download the executable.
If the download is successful, the manual download process functions properly.
Step 5:Test the ability to load dependencies from the web server. To do so, execute the executable download in the previous step. If prompted, insert a URL similar to http://127.0.0.1/ and click Continue.
If Cloudpath displays, the dependencies were properly loaded.
Step 6:Test the ability to load the Java Applet from the web server. Using a Windows XP or greater computer with Java installed, load the manual download page using a URL similar to http://127.0.0.1/page4_download.html. At the bottom of the page, click the 'Applet' link.
If Cloudpath displays, the Java Applet was loaded properly.
Step 7:Test the ability to load the ActiveX control from the web server. Using Windows XP or greater and Internet Explorer with ActiveX enabled, load the manual download page using a URL similar to http://127.0.0.1/page4_download.html. At the bottom of the page, click the 'ActiveX' link.
If Cloudpath displays, the ActiveX control was loaded properly.
Step 8:Test the ability to load the Mac OS X version from the web server. Using Mac OS X 10.4 (Tiger) or greater with Java enabled, load the JNLP page using a URL similar to http://127.0.0.1/page4_webstart.php.
If Cloudpath displays, the JNLP was loaded properly.
Step 9:Done. This concludes the scripted testing for Apache with PHP support. If problems persist, contact support.
    


Copyright 2006-2017 Ruckus Wireless Inc.
Use of this website signifies your agreement to the Terms & Conditions