Location: PHPKode > projects > easydialup > easydialup/ReadMe.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head profile="http://gmpg.org/xfn/11"><title>Easy DialUp » Docs.</title>
	
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<meta name="generator" content="1.5.2">
	<link rel="Stylesheet" href="ReadMe_files/style.css" type="text/css">
	<link rel="alternate" type="application/rss+xml" title="RSS 2.0" href="http://easydialup.sourceforge.net/?feed=rss2">
	<link rel="alternate" type="text/xml" title="RSS .92" href="http://easydialup.sourceforge.net/?feed=rss">
	<link rel="alternate" type="application/atom+xml" title="Atom 0.3" href="http://easydialup.sourceforge.net/?feed=atom">
	<link rel="pingback" href="http://easydialup.sourceforge.net/xmlrpc.php">
		<link rel="archives" title="December 2005" href="http://easydialup.sourceforge.net/?m=200512">
	<link rel="archives" title="November 2005" href="http://easydialup.sourceforge.net/?m=200511"></head>


<body>

<div id="heading">
	<div id="header">
	<h1><a href="http://easydialup.sourceforge.net/">Easy DialUp</a></h1>
	<h2>the linux dialup client for someone who doesn’t want to know what a linux dialup client is</h2>
	</div>
</div>

<div id="content">

<div id="navigation">
<ul id="minitabs">
<li class="page_item"><a href="http://easydialup.sourceforge.net/">Home</a></li>
	






<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=3" title="About">About</a></li>
<li class="page_item current_page_item"><a href="http://easydialup.sourceforge.net/?page_id=14" title="Docs.">Docs.</a></li>
<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=16" title="Download">Download</a></li>
<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=4" title="FAQ">FAQ</a></li>
<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=18" title="Features">Features</a></li>
<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=17" title="Get Involed">Get Involed</a></li>
<li class="page_item"><a href="http://easydialup.sourceforge.net/?page_id=6" title="Roadmap">Roadmap</a></li>
</ul>
</div>

<div id="main">

				
<div class="entry">

<h3 id="post-14"><a href="http://easydialup.sourceforge.net/?page_id=14" rel="bookmark" title="Permanent Link to Docs.">Docs.</a></h3>

		<p><strong>Requirements:</strong></p>
	<p>Apache<br>
PHP</p>
	<p>The
requirements to get Easy DialUp running on your PC is that you have a
Webserver running with PHP installed. The preferred Webserver is Apache.</p>
	<p><strong>Installing Easy DialUp:</strong></p>
	<p>* Download Easy DialUp from the Downloads page<br>
* Once you have the easydialup.yyyy.mm.dd.tar.gz file, create a folder called <em>easydialup</em>
in you webservers document root (normally /var/www/html, this depends
on which vesion of Linux your running) and extract the downloaded file
to that directory.<br>
* Installation is now done - proceed to Configuring Easy DialUp </p>
	<p><strong>Configuring Easy Dialup:</strong></p>
	<p><strong>1.</strong> To configure Easy Dialup you’ll need to know the following information<br>
* what dialer (pon,wvidal,..) you want to use to connect to the Internet<br>
* what the dialer profile you want to use -ifs you have already got the
Internet working using pon or wvdial you should already know this, if
not continue reading<br>
* what disconnect command you want to execute(poff,etc..)</p>
	<p>Once
you have the info specified above open the config.php file thats in the
config folder using a text editor and edit the file.<br>
ie. where ‘$profile = my_isp” edit this to your specification. </p>
	<p>** The annoying bit of configuring Easy DialUp<br>
<strong>2.</strong> Once the config/config.php file has been edited the
user that runs Apache has to be added to the User Group that can access
the modem(normally DIP and DIALOUT)<br>
* NOTE: This may be a security risk, but as Easy DialUp not intended to
be used at NASA its not the end of the world if you do this.</p>
	<p>*
There are a number of ways to do this depending on which version of
Linux your running. In this page we’ll examine the Linux version
independent way<br>
The linux version independent way of doing this is to edit the /etc/group file</p>
	<p><strong>3.</strong> Backup the current /etc/group file<br>
** execute the following command from the commandling <em>cp /etc/group ~</em><br>
*** this command copies the existing /etc/group file to your home directory</p>
	<p><strong>4.</strong> Next as root open the /etc/group file<br>
** In Ubuntu the easiest way to do this is from the commandline <em>sudo gedit /etc/group</em><br>
** or if you know what your doing <em>sudo vi /etc/group</em></p>
	<p><strong>5.</strong>
once you have the file open as root and edit the modem usergroups(this
is dip or modem and dialout depending on your distro) to include the
Apache user</p>
	<p>In Ubuntu<br>
<em>dip:x:justin<br>
dialout:x:justin</em><br>
change this line to<br>
<em>dip:x:justin,www-data<br>
dialout:x:justin,www-data</em><br>
Note: www-data is the Ubuntu user that runs Apache</p>
	<p>In Suse<br>
<em>dialout:x:16:guest,justin<br>
modem:x:43:</em><br>
change to<br>
<em>dialout:x:16:guest,justin,wwwrun<br>
modem:x:43:wwwrun</em><br>
Note: wwwrun is the Suse user that runs Apache</p>
	<p>Note:
Im not a guru on User Groups, you may have to play around with the
/etc/group file or your graphical User/Groups tool(if your distro
includes one).</p>
	<p>Once the User Groups are done thats the finish of configuring Easy DialUp, now for Using Easy DialUp</p>
	<p><strong>Using Easy DialUp</strong></p>
	<p>Open up for web browser and go to the following page <em>http://localhost/easydialup/index.php</em></p>
	<p>Assuming
you dont already have the Internet conencted, the page will display a
message saying that the Internet is currently OFF, to connect to the
Internet just click the ‘Internet ON’ button</p>
	<p>Easy DialUp will now connect to the Internet, too easy !! <img src="ReadMe_files/icon_smile.gif" alt=":)" class="wp-smiley"> </p>
	<p>If you encoutner any errors pleaes refer to the FAQ page</p>
	<p><strong>Program Logic:</strong></p>
	<p>* config/config.php<br>
This file contains the variable that are used in the index.php page<br>
$profile - this is the profile that the dialer will call<br>
$dialer - this is were you specify your ppp dialer (pon or wvdial)<br>
$disconnection - this is were you specify your ppp disconnection command (poff or whatever the wvdial version is)<br>
$theme - this is where you specify what theme you want Easy DialUp to use, at the moment only the Green theme works properly</p>
	<p>* index.php</p>
	<p>– if no GET info available<br>
—- check if /var/run/ppp0-up exits<br>
—— if exitst then show ‘Internet is ON’ page<br>
—— if not exist show ‘Internet is OFF page’</p>
	<p>– if GET info is ‘Internet ON’<br>
—- execute /usr/bin/$dialer $profile<br>
—- goes to ‘Connecting to the Internet now page’<br>
—- after 5 seconds refresh and goes to ‘Connecting to the Internet now page with image’<br>
—— refreashes every 5 seconds and checks for the existence of /var/run/ppp0-up<br>
——– if exitst then show ‘Internet is ON’ page<br>
——– if not exist show ‘Connecting to the Internet now page’ - THIS PAGE NEEDS WORK<br>
———- NEED A TIMEOUT PAGE HERE</p>
	<p>– if GET info is ‘Internet OFF’<br>
—- execute /usr/bin/$disconnection<br>
—- THIS PAGE NEEDS WORK</p>
	<p>– if GET info is ’stats’<br>
—- show ppp0 stats - THIS PAGE NEEDS WORK - ideally this info should
show up on the right of the main screen next to the Internet is On/Off
section</p>
	<p>– if GET info is ‘conf’<br>
—- prints the config/config.php variables to screen - THIS PAGE IS READ
ONLY - ideally this info should show up on the right of the main screen
next to the Internet is On/Off section</p>

 <p class="postmetadata"> <a href="http://easydialup.sourceforge.net/wp-admin/post.php?action=edit&amp;post=14">Edit</a> <strong>|</strong>  </p> 
				
				<!--
				<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
	    xmlns:dc="http://purl.org/dc/elements/1.1/"
	    xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
		<rdf:Description rdf:about="http://easydialup.sourceforge.net/?page_id=14"
    dc:identifier="http://easydialup.sourceforge.net/?page_id=14"
    dc:title="Docs."
    trackback:ping="http://easydialup.sourceforge.net/wp-trackback.php?p=14" />
</rdf:RDF>				-->

</div>

<h3 id="comments">No Comments 
	<a href="#postcomment" title="Leave a comment">»</a>
</h3>

	<p>No comments yet.</p>

<p><a href="http://easydialup.sourceforge.net/?feed=rss2&amp;p=14"><abbr title="Really Simple Syndication">RSS</abbr> feed for comments on this post.</a> 
	<a href="http://easydialup.sourceforge.net/wp-trackback.php?p=14" rel="trackback">TrackBack <abbr title="Uniform Resource Identifier">URI</abbr></a>
</p>

<h3 id="postcomment">Leave a comment</h3>


<form action="http://easydialup.sourceforge.net/wp-comments-post.php" method="post" id="commentform">


<p>Logged in as <a href="http://easydialup.sourceforge.net/wp-admin/profile.php">Justin</a>. <a href="http://easydialup.sourceforge.net/wp-login.php?action=logout" title="Log out of this account">Logout »</a></p>


<!--<p><small><strong>XHTML:</strong> You can use these tags: &lt;a href=&quot;&quot; title=&quot;&quot;&gt; &lt;abbr title=&quot;&quot;&gt; &lt;acronym title=&quot;&quot;&gt; &lt;b&gt; &lt;blockquote cite=&quot;&quot;&gt; &lt;code&gt; &lt;em&gt; &lt;i&gt; &lt;strike&gt; &lt;strong&gt; </small></p>-->

<p><textarea name="comment" id="comment" cols="40" rows="10" tabindex="4"></textarea></p>

<p><input name="submit" id="submit" tabindex="5" value="Submit Comment" type="submit">
<input name="comment_post_ID" value="14" type="hidden">
</p>

</form>



		
		<div class="navigation">
			<div class="alignleft"></div>
			<div class="alignright"></div>
		</div>    
		<div class="navigation">
			<div class="alignleft"></div>
			<div class="alignright"></div>
		</div>

	
</div>

	<div id="sidebar">

<h3>Search</h3>
<div>
<form method="get" id="searchform" action="/index.php">
<div><input value="" name="s" id="s" type="text">
<input id="searchsubmit" value="Search" type="submit">
</div>
</form></div>

<h3>Archives</h3>

				<ul>
					<li><a href="http://easydialup.sourceforge.net/?m=200512" title="December 2005">December 2005</a></li>
	<li><a href="http://easydialup.sourceforge.net/?m=200511" title="November 2005">November 2005</a></li>
				</ul>    

<h3>Categories</h3>
	<ul>
	<li><a href="http://easydialup.sourceforge.net/?cat=1" title="View all posts filed under News">News</a> (1)
</li>
	<li><a href="http://easydialup.sourceforge.net/?cat=2" title="View all posts filed under Release/Change Log">Release/Change Log</a> (2)
</li>
 
	</ul>



</div>

<div id="footer">
<p>Powered by <a href="http://www.wordpress.org/">WordPress</a>. Golden Grey Theme by <a href="http://wpram.com/">William Pramana</a>.</p>
</div>

</div>
</body></html>
Return current item: easydialup