Readme for NPort Batch Configurator under Linux
        (C) 2002 Moxa Technologies. All rights reserved.

The NPort Batch Configurator (npbc) program is a command line tool for 
configuring NPort serial device server under linux.
Major functions for NPort Batch Configurator is as follows.
1. Config IP address of NPort serial device server according to it's MAC 
   address.
2. Config the NPort serial device server according to the editable
   configuration file. The configuration file can be exported into an
   editable text file.
3. Import the configuration to one or multiple NPort serial device server
   at one time.
To run this program, you need to copy package file into host and build 
execution file.


1. System Requirement
   - Hardware platform: Intel x86 machine
   - Kernel version: 2.0.3x or 2.2.x or 2.4.x
   - gcc version 2.72 or later
   - Network interface card and TCP/IP protocol stack are configured 
     correctly.

2. Install NPort Batch configurator
    1. Copy package file from CD-ROM into Host
       # cd /       
       # mkdir moxa       
       # cd /moxa       
       # cp /mnt/cdrom/<directory>/npbc.tgz .       
       # tar xvfz npbc.tgz
       
    2. Compile source to generate execution file.
       # cd /moxa/npbc
       # make linux
       
    3. You are ready to use npbc to configure NPort.

3. Usage of NPort Batch Configurator

Usage: ./npbc [OPTION] [[IP address] FILENAME [PASSWORD]]...

 npbc version 1.2 .
 NPort Server configuration utility program.
 Use npbc to change IP addresses, set config, and export config.
 OPTION:

     -c, change  Changes IP addresses of selected NPort Servers.
      	  	 Takes one argument:
                 1.FILENAME is a text file that contains a list
                   of MAC addresses, IP addresses, and passwords.
                   
                 >>>>>Note!!<<<<<
                 To use this function, NPort and host must be 
                 connected to the same LAN.
                   
     -s, setting Imports the config from a file into selected  
       		 NPort Servers. It requires two arguments: 
                 1.IP_LIST_FILENAME is a text file that contains
                   a list of IP addresses of NPort Servers that 
                   the configuration is about to update.
                 2.CONFIG_FILENAME is a text file that contains
                   an NPort Server configuration. 
                   (NOTE: -e option can be used to create the file)

     -e, export  Exports the configuration of a specific NPort
     		 Server to the file CONFIG_FILENAME.
      	  	 Takes three arguments:
     		 1.IP_ADDRESS is the IP address(e.g.,192.168.1.2)
     		   of the NPort Server whose configuration is to
     		   be exported to a file.
     		 2.CONFIG_FILENAME is the file to which the
     		   config is exported.
     		 3.PASSWORD is the password of the NPort Server
     		   (omit this option if no password is set for the
     		   device).

     -h, help    Displays this help file, and then exits.


4. How to setup IP address of NPort serial devcie server by 
   MAC address?
   1. Install the NPort serial device server and connect to 
      Ethernet and serial device. Please record the MAC
      address before go to next step. You may find the MAC
      address at the buttom label of the NPort Server.
      For example, say the MAC address is 00:90:e8:21:10:03.
      You would like to config it as 192.168.127.3. 
   2. Under Linux, open ./moxa/npbc/changeip by vi.
   3. Add the MAC address and desired IP address in the file as
      follows. 
      Ex.
      [NPBC Change IP File]                             

      #[MAC address]		[IP address]	[Password]
       00:90:e8:21:10:01	192.168.127.1	 
       00:90:e8:21:10:02	192.168.127.2             
       00:90:e8:21:10:03        192.168.127.3   opensesame
   4. # ./moxa/npbc/npbc -c changeip
   5. The NPort Batch configurator will update the IP of the
      NPort serial device server to 191.168.127.3.

5. How to export configuration file from a NPort serial device
   server?
   You may have to export the configuration file from a
   NPort serial device server to a text file in order to setup
   other NPort serial device servers. 
   The configuration file contains network configuration,
   serial line configuration, operation mode along with
   all parameters.
   For example, say IP address of the NPort server is 
   192.168.127.3.
   1. Under Linux, run
      #./moxa/npbc/npbc -e 192.168.127.3 nportno1
   2. The configuration is saved into the file "nportno1". 
   3. For the format of each field in the configuration file,
      please refer to the remark in the file.

6. How to setup one or more NPort serial device server by 
   configuration file?
   You may use the configuration file mentioned above to copy
   the configration to one or more NPort serial device server.   
   However, the IP address for each of the NPort serial device
   server should be well configured in advance.
   Prior to proceed, you may change the configuration in
   configuration file as you wish manually. When all settings
   are ready, please go by following steps.
   1. Determine which NPort server to be configured
      You have to setup the IP address for each NPort server
      to be configured by way of setting an ip list in file
      "iplist".
   2. Run # vi ./moxa/npbc/npbc/iplist, and add desired IP
      addresses for the NPort server.
       [NPBC Import IP File]                             
       #Model Name                                       
       ModelName	211                               
       #[IP address]	[Password]                        
       192.168.127.3    sesame
       192.168.127.4
   3. Run #./npbc/npbc -s iplist nportno1
      The configuration for two NPort servers with IP 
      192.168.127.3, 192.168.127.4 will be updated.
      
7. Model Name
	NPort Express :
		DE-211	ModelName	211
		DE-311	ModelName	311
		DE-311M	ModelName	8311
	NPort Server Lite:
		DE-301  ModelName	301
		DE-302  ModelName	302
		DE-304  ModelName	304
		DE-331  ModelName	331
		DE-332  ModelName	332
		DE-334  ModelName	334
	NPort Server Pro:
		DE-308  ModelName	308
		DE-303  ModelName	303

[end]