| |
For users or systems dialing up and logging in to asynchronous service providers, login scripts facilitate the process by defining a command/response dialog that takes place between a router and a remote server during the dial-up sequence. Login scripts can also be used to convey additional information, such as a request to connect to a specific destination.
This topic provides information about how you can create or customize login scripts to dial in to other types of networks. It contains the following sections:
The Novell® Internet Access Server 4.1 routing software provides a Windows-based utility that enables you to create a customized PPP login script. To create, edit, or install a PPP login script, start the WMDMMGR utility the same way you would start any Windows 3.1, Windows 95, or Windows NT utility. This utility can be run only at a Windows workstation and cannot be run from the DOS prompt.
WMDMMGR is located in the SYS:\SYSTEM\UTILS directory on your server. A sample PPP login script, called ISPLOGIN.LSC, is provided in the SYS:\SYSTEM directory of your router. This sample file can be modified to meet your requirements. Multiple scripts can be stored in one .LSC file. WMDMMGR lists all scripts in the selected .LSC file. The name defined in the utility is the script name used by the Novell Internet Access Server 4.1 routing software and has no relation to the filename.
All scripts from earlier releases of the Novell routing software are saved in SYS:\SYSTEM\BACKUP during installation. These old scripts can be converted to the new format using WMDMMGR. In some cases, warning messages might occur if the old script has syntax errors. After the errors are corrected, the script can be modified or used as is. The conversion process is described in the online help.
To create a new login script, select New from the File menu. To modify an existing login script, select Open from the File menu. After editing the login script as described in the online help, save your changes by selecting Save or Save As from the File menu. To edit existing files, copy the files to the SYS:\SYSTEM directory.
Your login script must contain at least one of the words contained in the login prompt received from your Internet Service Provider (ISP). For example, if the prompt from your ISP is Enter user name, then your login script must have at least one of these words in the expected input string from the remote system.
The remaining sections in this appendix provide the background information you need to understand the operation of PPP login scripts.
Login scripts define a command/response dialog that takes place between a router and a remote server at dial-up.
The syntax of the Novell Internet Access Server 4.1 login script allows you to define specific strings to be interpreted as output to be sent by the router (a command to the remote server) or as input to be listened for by the router (an expected response from the remote server). Delays can also be specified to ensure that commands complete successfully.
This design allows any string to be designated as a command from router to server and any other string to be designated as a response. It provides a flexibility that will enable you to create new login scripts or to modify existing ones to meet your site's specific needs. The customization you will need to do is determined by the specifications provided by the ISP.
Login scripts consist of a series of one-line entries that define the script name, certain script parameters, and the dialog of expected interaction between the router and the remote server.
WMDMMGR allows for multiple login scripts to be put in one .LSC file. The login script file must contain the name of the login script so that NIASCFG can list it as an available login script when you select Login Script Name at configuration. The maximum length of the script name is 39 characters. The script name can be multiple words separated by spaces (for example, SILICON VALLEY NET).
Each script contains a series of script prompts labeled Param[1] through Param[5]. These tags represent up to five placeholders to define arguments that can be embedded in output lines. For instance, a typical login script might use these parameters to define a user ID, a password, and a service to be selected. These three pieces of information can then be treated as three arguments in the login script that supply the rest of the information specific to the router/server dialog. With generic parameters such as these, one common login script can be used for all users and configured in the PPP WAN call destination.
When a login script is configured in the PPP WAN call destination, you are shown the prompts that are defined in the Param[1] through Param[5] fields in the script. You are then prompted to enter a value for each parameter. For example, if Param[1] is defined as username and Param[2] is defined as password, you are prompted to enter values for the username and password. The values are stored in the WAN call destination configuration and are substituted into the login script when the call is made and the script is executed. The maximum tag length is 25 characters.
The login script file consists of a series of script operations. These are the lines in a login script that specify the command/response exchanges to take place between the router and the remote server. The following are examples of operations used in a typical login script:
This operation signifies the beginning of an output string, a command sent by the router to the remote server.
STRING is a command string that the remote server recognizes. This command string can contain the following:
These are specified with entries of `A through `Z (the letters A through Z preceded by a back-quote character [` ]). Common control characters to embed in the output operations include `I or \0x9 (the Tab character), `M or \0xd (the Carriage Return character), and `J or \0xA (the Line Feed character).
Any of the parameters specified in the login script can be embedded in an output string. For instance, if [1] is specified as equal to the prompt for the username in the script, [1] can be entered as part of the output string. This entry instructs the router to substitute the value for the User Name entered during the configuration of the PPP call destination and sends it to the remote server. No more than five tags can be defined and used in the script. Any defined parameter, however, can be embedded more than once, if necessary.
This operation signifies the beginning of an expected input string, a response from the remote server that the router will listen for.
STRING is a remote server response that the router recognizes. It is an input line terminated by Enter (`M ).
This operation signifies a delay, or pause. The interval for the delay is specified as N tenths of a second.
This operation signifies a quiet period, an interval of no input. The interval for the quiet period is specified as N tenths of a second.
Quiet periods are generally the interval of time required for the current input to conclude.
| |