CAPRI32/NT is installed as a standard LAN interface NDIS driver. CAPRI32/NT communicates with the ISDN card using the Common ISDN API 2.0-DLL specification (a standard defined by German ISDN card manufacturers and the German Telekom). Because of this, CAPRI32/NT is completely hardware independent and has successfully been tested with many active or passive ISDN cards. CAPRI32/NT can be installed and used in parallel to NT RAS.
CAPRI32/NT supports one or two B-channels. A connection can use both B-channels for load sharing or PPP multilink operation. Load sharing/Multilink can be configured as static or dynamic (bandwidth on demand) or with manual setup. Multilink, as specified in RFC 1990, is used in case of PPP, Load sharing is implemented for all other protocols.
CAPRI32/NT supports IP-Masquerading (Network IP Address Translation
+ Port Mapping ), a technique which allows multiple hosts on
a private LAN to share a single IP address.
Private LAN addresses must be mapped to registered IP addresses supplied
by your Internet Service Provider. This is known as Network Address Translation.
CAPRI32/NT supports NAT (Network IP Address Translation) as described
in RFC 1631.
Port Mapping works by keeping track of source port numbers used
by TCP and UDP applications, and mapping each port number to a new number
prior to transmission of the packet onto the Internet. A packet received
from the Internet will have a destination port number equal to the mapped
source port number, and so the original port number and IP addressee can
be restored after a table lookup.
CAPRI32/NT supports DNS Interception for local name lookups. DNS address queries from all LAN clients can be intercepted and answered from a local name table. Optionally DNS queries to pre configured DNS server addresses can be redirected on the fly to dynamic assigned name server addresses.
CAPRI32/NT comes with a DHCP/BOOTP Server for automatic Client configuration. To simplify the configuration of LAN Clients for Internet access CAPRI32/NT is delivered with a combined DHCP/BOOTP server for configuring IP address, Nameserver-address and gateway IP address of the clients.
As long as you have NOT registered CAPRI32/NT you may test the software for 30 days without a registration code. In this case CAPRI32/NT will stop forwarding data 15 min after startup.
It is provided as shareware with the following limitations:
This program is copyrighted and it is not in the public domain. It
may not be distributed for profit or included in any CD-ROM or diskette
software collection without permission. This applies in particular to commercial
PD libraries. The program is not to be resold or distributed for sale with
other programs which are for sale without my express written permission.
You may not bundle or otherwise distribute this software with any other
software without my express written permission (i.e., on the same diskettes
as part of a commercial package, compressed along with other software,
etc.).
There is no warranty or claim of fitness or reliability. The program
is distributed AS IS, and as such the author shall NOT be held liable for
any loss of data, down time, loss of revenue or any other direct or indirect
damage or claims caused by this program.
ISDN-LAN IP Routing with one official IP address:
Router-PC with CAPRI32/NT, Ethernet interface:
IP address: 192.168.1.1
Net mask: 255.255.255.0
Nameserver: 192.168.2.2 with redirection in CAPRI32/NT enabled or as
specified by your provider
Host 1, Ethernet interface:
IP address: 192.168.1.2
Net mask: 255.255.255.0
Gateway: 192.168.1.1
Nameserver: 192.168.2.2 with redirection in CAPRI32/NT enabled or as
specified by your provider
Host 2, Ethernet interface:
IP address: 192.168.1.3
Net mask: 255.255.255.0
Gateway: 192.168.1.1
Nameserver: 192.168.2.2 with redirection in CAPRI32/NT enabled or as
specified by your provider
.....
To control and monitor ISDN connections the program offers the following menus:File
dialog box for defining the local ISDN numbers.Network Setup
Modification in the advanced ISDN setup are usually not required.
CIP-mask: defines the services for incoming ISDN calls.
Enable both channels: enables CAPRI32 to use both B-channels.
Nameserver-IP: determined automatically from the Windows configuration. Change these addresses only if required.
DNS redirect: enables redirection of DNS request to a dynamically assigned name server.
Timer:
Call-Setup: maximum Call Setup time.
Pause: pause between call setups and successful connections.
Callback: delay until a callback is executed.
dyn. Timeout: In Shorthold mode a connection is released a few seconds before a unit ends. This
value defines how many seconds before the end of a unit it will occur.
dyn. Multilink Loadlevel: defines the load level for dynamic Multilink operation. A second connection will be established if the load exceeds this level for the defined amount of time..You have to restart the program for modifications to take effect.
dialog box for defining ISP specific parameters. You have to restart the program for modifications to take effect.Exit terminates the program
Phone number: PBX's sometimes require a special key code for dialing out. If this prefix is not displayed on incoming calls, Dial back and CLI will normally fail. To solve this problem an outgoing call prefix supported, which is not checked on incoming calls. The prefix can be specified in front of each ISDN number separated by a comma. Digits, which should not be used in an outgoing call, but have to be present for CLI can be marked by a decimal point from the common part of the number.
Examples:
089.345678 will dial 345678 and will match incoming calls from 089345678
0,30.123456 will dial 0123456 and will match incoming calls from 30123456
00,123456789 will dial 00123456789 and will match incoming calls from 123456789.
Mode: Defines the mode of operation.
In/Out: incoming and outgoing calls allowed.
Incoming: only incoming calls are enabled.
Out: only outgoing calls are allowed
Req.Callback (ring): Request callback. To avoid costs the connection set up is dropped immediately after the connect request.
Req.Callback (connect): Request callback. The connection setup is terminated on the connect confirmation. If the peer does not reject the call, the call will be charged.
Req.PPP-Callback: The PPP callback option is transmitted during PPP handshaking to request a callback.
Callback: Rejects an incoming call and calls back.
PVC: Permanent virtual connection (because it is manufacturer specific, implemented only for ISDN cards from EICON/Diehl)
Protocol: Defines the framing protocol of the packets.
CIP-Value: defines the ISDN service for outgoing calls. The default value of 2 selects "ISDN data transmission".Timer Options:
Unit Adaptive Disconnect with Shorthold of: Adaptive disconnect requires the definition and selection of units through unit emulation or support of unit messages during the connection.
On expiration of the short hold idle timer, CAPRI32/NT calculates the remaining time of the current unit. If no further activity occurs the connection will close down a few seconds before the end of the unit was estimated.
Disconnect, if idle for: Defines the idle time-out for this connection. The value is used for incoming calls and in if a unit depended time-out is not defined.
Idle Timer ignores Received Packets:
If a peer sends packets on a regular basis to test the line, a idle time-out would never occur. The options will force CAPRI32/NT not to reset the idle timer on incoming packets.
Idle Timer ignores Bcasts & Netbios requests: Broadcast messages and NetBIOS name lookup messages will not reset the idle timer and not open a new connection. They are only transmitted, if a connection is already established.
MultiLink/Loadsharing: Three kinds of PPP-Multilink or Loadsharing using both B-channels are available: Static (set the timer value to 0), manual (don't enter a timer value) or dynamic (exceeding the configured load level for the defined time interval opens a second connection).
Peer IP: PPP can assign an IP address to the peer. This IP address can be defined here.
TCP-header compression: PPP will match TCP-header compression with the configuration of the peer. For all other protocols be sure to use the same setting of this option as the peer.
Units options:
Emulate Units messages: Allows CAPRI32/NT to emulate unit messages based on a setup entry.
An entry consists of up to 5 pairs of
Starting-hour,length-of-unit-in-seconds
Separate entries for week days and weekend/holidays can be created.
ATTENTION: A length of 0 disables outgoing calls to the peer during the specified hours.
Ignore real Units messages: With this option real unit messages will be ignored.NAT: Network address translation is used to translate between private and official IP addresses.
NAT with dynamic IP assignment should be used if your provider uses PPP with dynamic IP addresses
NAT with static IP has to be used for providers that use fixed official addresses.
Nat can be disabled in case of a fixed official IP address. In this case the official IP address must be configured in the TCP/IP set up of Windows.
View
Status selects the full status page for display.
Brief status selects the short status page for display.
Configuration displays the active configuration.
Log displays a connection and optionally trace log.
Mapping displays the active mapping entries.
Trace
CAPI Messages logs all messages exchanged with the CAPI software
(except data transfer)
PPP Setup allows to trace the setup of a PPP connection. PPP data packets are not logged.
Application Interface
logs information related to the upper layer interface and additionally DNS queries.TCP/IP
logs relevant TCP/IP information of all packets. Source-IP, Destination-IP and Protocol are logged for all protocols. Further values depend on the protocol, e.g. Source and Destination Ports are logged for TCP and UDP.Control
Attention: Use the trace option only for debugging NOT during normal operation.
manually connects to an IP destination. In case of PPP with authentication the program prompts for authentication information. The initial setting of the repeated dial request option depends on the Preferences configuration.Disconnect disconnects all active ISDN connections or terminates a repeated dial request.
Reset Statistics resets all counters.
Auto Dial enable or disables the auto dial feature.
Preferences
defines the initial program settings. Selectable are the language of menus and the initial setting of the repeated dial option.Port Mapping
Play Sound:The program beeps on connect and disconnect. If the this option is checked, the program will play the .WAV files assigned to "ISDNup" on connect and "ISDNdown" on disconnect.
Execute on connect/disconnect: A program executed after connection set up can be defined, %i inserts the assigned IP address, %n %s inserts assigned primary and secondary name server addresses.
Another program can be executed after disconnect.
Save Log: With this option the log pages are automatically saved on program exit. If a log file exists the new entries are appended.
The dialog box allows you to add or modify IP addresses of servers in your local area network and static port mapping entries for LAN clients. The static port mapping table must be scanned for every IP-packets, therefore you should avoid long tables and make use of port number ranges as far as possible.Name ResolutionIf you don't have a WWW, ftp or some other server in your LAN, leave the IP address table empty. There is NO need to enter the IP addresses of clients in your LAN in the address table.
The dialog box configures DNS interception. Set the check mark to enable local name resolution through the name table. Add the IP addresses and the full Internet Domain Name of those hosts you want to resolve locally.Help
prompts for the license key and your name, company. To activate a license key you have to restart the program. After restart check the Info menu to find out if the license information was accepted.Info displays program version information.
The state of an ISDN connection is displayed on its status page and in place of an icons title by the following codes:
_ = free,
D = D-channel up,
C = B-channel requested,
B = B-channel up,
A = active, ISDN connection up,
additional information for PPP:
L = LCP configuration up,
I = PAP/CHAP configuration up, IPCP configuration started,
P = PPP connection up
additional information for SLIP:
S = SLIP configuration upOn ISDN connection set up and termination the CAPI 2.0 error and status codes are displayed.
CAPRI32.EXE can be started with the following optional command line arguments:
(You can enter arguments for a Windows program via the Properties entry of Aliases.)CAPRI32 [Flags] [ConfigFile]
Flags
ConfigFile specifies the name of the CAPRI32/NT configuration file. If the name is not given, it defaults to "CAPRI32.INI". The configuration file is a readable text file.
- -iconic starts CAPRI32/NT iconified
- -unload unload running copy of CAPRI32/NT. Prompt user if a connection is active.
- -terminate disconnect and unload a running copy of CAPRI32/NT.
Therefore if you have more than one provider:
Repeat the steps to set up further configurations for other providers.
- set up a configuration for the first provider
- rename CAPRI32.INI to a provider related name e.g. tonline.ini
- create a CAPRI32 alias pointing to the renamed configuration file, e.g.
C:\CAPRI32\CAPRI32 tonline.ini.
To run CAPRI32/NT as a service the following files have to be in the same directory:
CAPRISRV.EXE, CAPRI32.EXE, CAPRID32.DLL, CAPRI32.INI
caprisrv -install
will install CAPRI32/NT as a service under Windows NT.The service "CAPRI ISDN Service" can than be started and stopped via the control panel.
caprisrv -remove
will remove CAPRI32/NT as a service from the system.The latest version of CAPRI32/NT is available on www.heha.cjb.net. Please mail comments, questions, problems to heha@heha.cjb.net. I can not guarantee any level of technical support, or for any length of time. In general, I will give priority to registered users. Support
There is absolutely NO WARRANTY, expressed or implied with this software. If you choose to use this software, you assume all risk. Warranty