readme

项目描述: g-page is a client/server application designed to send text messages to pagers and PCS phone

email address when the page has been received. Do not confuse your default 
email address with the email address you setup for a pager. The default email
address is the one entered under the Config option from the main toolbar. 
This will typically be your email address however if you wish to have the 
confirmation sent to a pager you can enter that address into the software.
Selecting 2 way allows you to poll for a response from the receiver you have
sent a message to. You will need to check for a reply under the 2 way response
dialog which can be found under Maintenance on the main menu.

Autosplit long messages: You can choose to autosplit longer messages into
consecutive pages by selecting Yes. This means if the paging company only 
allows 120 characters per page and you send a page with 200 characters is will
be split into two and send out as two consecutive pages. The first page will 
have an arrow --> at the end of it to indicate it was split and the rest
of the message is coming shortly.

Next you will need to click on the name of the service this receiver uses by 
highlighting it in the Select Service list box. Click Save and you are done!!

The receiver you just entered should now be in the Select Receiver list box
on the main screen. You are now ready to configure the server.


                         RUNNING THE SERVER

	You can optionally  create a configuration file for the server
to read the following data from. The format of the file, named gpage.conf is:

server_domain=localhost
port=1299   
connect_timeout=60
read_timeout=180

and must be placed into the /etc directory on the computer where the
server will be running. If this file does not exist the server will 
use the values above as the default values and will work with no problems
as long as the client is talking on port 1299. You can also define 
the port number for the server to listen to with the -p switch upon
startup. I have included a little perl script to do it, or you can 
create one manually.

The server domain is the name of the server. Localhost will work 
or the name of the server. The port= line must have the same port
number defined as the client or you will get a "connection refused"
error. Feel free to use any port you wish as long as it's over 1024, I picked 
1299 randomly. Note - there are many reserved port numbers so you will have to 
make sure you are not using one of them. 1299 will work fine for most 
people. The read_timeout is the length of time the client will wait for 
a response from a remote snpp, WCTP or email server. Basically this will stop the 
server from waiting forever if the remote server dies in some funky fashion after
you have established a connection with it.
 
The connect_timeout is the length of time the server will wait to establish a 
connection with a remote server. The connect function call will normally
timeout in a few minutes but you can set this lower if you wish.

Note - You must end each line with a newline (press enter) in the file
or it will not work properly. 

If you want to use the perl script you will need to make it
executable by doing:

chmod +x config.pl

then run it by typing ./config.pl

The script will create the config file in your /etc directory so you will need
the proper permissions to create a file there. You may have to run the script as 
root. It will ask you for the information and create the config file for you.

The paging server can be run with several different options, it will run as 
a daemon if you don't enter any options and simply start it with a ./gserver
command. If you wish to run it in a terminal then you will need to start it 
with a -t option. If you wish to run it in debug mode then you can use the 
-d switch. Running in debug mode will cause the server to generate a log file
in the ~/.gpage directory of the user who starts the process of all the 
transactions between g-page and any email or snpp server. If the server is run as 
a daemon you will need to look in /var/log/syslog for any error messages. 

To summarize:

gserver     Will run the server as a daemon

gserver -t  Runs the server in a terminal

gserver -d  Runs in debug mode, logging transaction data to ~.gpage/g-page-trans.log

gserver -s  Disable scheduled paging. If you don't need to send a scheduled
	    page then run in this mode as it's more efficient.

gserver -p  ####   This will  override any port number defined in the config file 
            and force the server to listen on that port number. You can 
            also use this to run multiple servers at the same time by assigning
            each server a different port number. If you run multiple servers
            on one machine you should start all but one with the -s switch 
            to disable schedule paging. In other words, only enable schedule
            paging for one server or else you may run into problems.

example: To start the server using port number 1900:  gserver -p 1900 


gserver -f  <filename> Allows you to define clients to ban by including a list
            of their their ip numbers or hostnames in a file. You must include 
	    the full path of the file. You may delete the file after the server
	    starts up if you wish as the server only reads the numbers once and 
	    stores them in memory.

example: To start the server with a list of banned ip's or hostnames in a file called
banned.txt in your home directory: gserver -f /home/qwerty/banned.txt

gserver -g  <filename> Allows you to define clients to accept by including a list
	    of their their ip numbers or hostnames in a file. All ip numbers or 
	    hostnames except those in listed in this file will be denied access 
	    to the gserver. You must include the full path of the file. You may 
	    delete the file after the server starts up if you wish as the server 
	    only reads the numbers once and stores them in memory. 

NOTE - You cannot use both the -f and -g switches at the same time.

gserver -c <script> Allows you to execute the script defined to dial an Internet 
	   connection if the gserver cannon find a live connection. The client 
	   must have the option activated in their user preferences also, so this
 	   can be set on a page by page basis. I would recommend using diald if you
           really need this functionality.

example: To execute a script called dial_internet.pl, located in your home directory,
that will dial your internet provider if you are not connected to the internet:
gserver -c /home/qwerty/dial_internet.pl


gserver -a  This will turn on the auditing function and log every page in your
            ~/.gpage directory in a file called server_log.dat. This log includes
            the IP address of the client workstation that sent the page as well as
            all the standard logging information.

gserver -v  (prints the version number and exits)

Of course you can mix any of the switches when you start the server up. If you 
don't start it with the -s switch a separate process will start for 
taking care of the scheduled pages. In order to shut down the server (both 
processes) you can simply type in  "killall gserver" (minus the quotes) from 
a shell command prompt. 

If you want to have the server run all the time on your server then you can 
simply start it as a daemon from one of the start-up scripts on your machine.



	                  DATABASE SERVER

	G-page comes with a database server utility which can be run from any computer 
with a g-page client. The database server, called db_server, listens on port
number 1301 unless started with the -p #### switch. The database server allows 
other clients to connect to and transfer your current local database to their machine.
This is an easy way to use one common database or to share data amongst many networked
machines. db_server supports the following switches: d, t, p, f, g, v. The switches perform
the same function for the database server as they do for the gserver as noted above.



                          CLIENT FEATURES

To backup or restore your current database files.

From the main menu:

Click on file->Backup DB to back up your files.
Click on file->Restore DB to restore them. When you restore a backup copy you will
destroy the current files you are using.


PRE-DEFINED MESSAGES:
	
	To use a pre-defined message you will need to click on Maintenance
on the menu-bar and select "Stored Msg" This should bring up the pre-defined
message box. To add a new message simply type the message into the text box and
click on the "add" button. The message should now appear in the list. IF you want
to send that message click on it in the list and click the "ok" button. The 
message should now be inserted into the message entry box. 

	If you want to edit a message you will need to select the message from 
the list and click "edit" The message will be removed from the list and inserted 
into the text box, you can now make any changes you wish then click the "add" 
button to once again save the message. To delete a message you must select  it 
from the list then click on the "delete" button

RE-SEND PREVIOUS MESSAGES:

	To re-send the last message sent move your mouse into the main message
entry box on the main screen and click the right mouse button. You should get a 
popup menu for inserting the last message. Click on that menu and the last 
message you sent will be inserted into the text box. To resend a message from the 
logs you right click on the message and then click on the popup menu for "resend 
message"


SETTING YOUR PREFERENCES:

DATABASE:


	Click on the "Pref" button on the main toolbar, this should pop up the 
dialog box for setting your preferences. The first option allows you to select a 
different location for your database files. If you select a local database g-page
will read the database files located in your ~/.gpage directory unless you select
a different location. If you select a different location which doesn't have any
database files g-page will create empty ones. 

If you want to read database files from a different computer you will need to 
select the network option and fill in the correct IP address or domain name of the 
workstation you wish to read from. Note that the database server must be running 
on that workstation. If you select any value other than zero for the database refresh 
settings g-page will automatically update your database every xxx minutes. Note that 
if you are sending a page g-page will not perform this update due to the possibility 
of data corruption. You can leave this value at zero and manually hit the refresh 
button when needed if you choose.

To convert a network database into a local database you will first need to select a 
network address to read from, click on the apply button to load the files, then 
click on the convert database button. Note - This will destroy your current local
database files, so it's a good idea to back them up first, if you will need them at 
some point in the future.


LOG:

	To automatically delete your log files after X number of days click 
on the log tab and select the "yes" option then select the number of days to keep
the files before deleting them

	If you set a polling interval g-page will look for logged pages to delete
every X hours. Leave this setting at zero to disable polling and only look for log
entries to delete when g-page is started.