Documente Academic
Documente Profesional
Documente Cultură
Following are the broad steps in brief for Access nodes (CACU and LAGU) Software
Installations and configuration at the C-DOT BSNL exchanges/sites.
a) The “IP ADDRESS DETAILS” sheet for the site is available with the CACU and
LAGU wise IP addresses allocated (as available in the MAX-NG Rollout Project
Management web portal). Refer Appendix-A.
b) Prepare the Thin Client machine and configure the minicom settings. Refer
Appendix-I (steps 1 to 6).
c) If the MAC address for the MLS cards (MLS1 & MLS2) are mentioned in the “IP
ADDRESS DETAILS”, against the parameter “MLS Card1/2 Management IP
(Gateway-1/2)” then only these need to be allocated to the CACU MLS cards
during IP configuration using minicom. Paste the stickers for the MAC address
allocated on the MLS cards face plate. Refer Appendix-B(Step A)
d) Configure the parameters on the BSNL MPLS routers to enable CACU Link
Redundancy. Refer Appendix J(Step A)
e) Do the MLS cards IP, VLAN and WAN-IP configurations as mentioned in detail in
a separate document named MLS CONFIGURATION MANUAL for MLS card
Configuration. Refer Appendix-D for broad steps.
f) Configure the IP of the Thin Client machine and setting up of TFTP server and
Access software loading as mentioned in the Appendix-I (step 7 onwards).
h) Ensure that the MAC addresses for the cards are allocated and the stickers for the
same are present/ pasted over the card face plates.
j) Allocate the CARD-IP addresses to the cards for all the CACU cards using the
minicom cable. Refer to the CACU Installation procedure steps in Appendix-G
(PREREQUISITES: step 7).
k) Allocate the CARD-IP addresses to all the cards for all the LAGU NGTJ cards
using the minicom cable. Refer to the CACU Installation procedure steps in
Appendix-H (step 5).
l) Verify the Uplink connectivity for the CACU and LAGU cards connected and IP
addresses are configured as per IP ADDRESS DETAILS sheet. After that, test the
reachability of the LAGU and CACU cards from the core network.
m) Ensure that the LAGU, CACU and MISC software release/patch deliverables are
loaded over the thin client machine. The details of the deliverables are given in
Appendix-F.
n) Do the automated Installation and configurations for the CACU release software
over the CACU cards (SLM, NGTJ and EBM) which have already been configured
the IPs and are accessible from the thin client machine (having the CACU
deliverables) connected with MLS-1 card. Refer Appendix-G.
o) Kindly refer the guidelines regarding PCM cable (E1) connectivity between the
RSU-LAGU and the CACU-EBM for cable related information in Appendix-K.
p) Connect the LAGU system with the CACU MLS card over the MLS card ethernet
port and do the automated LAGU release software installation and configurations
from the thin client machine with the loaded LAGU release tarball. Refer
Appendix-H.
NOTE: Kindly ensure that the NGTJ Card which is made ACTIVE after
patch/release installation should have the latest/updated CdotLagDbConf.bin present
in /mmc/etc/ directory.
q) The procedure to load mmc RFS to recover a corrupted /mmc partition on the
NGTJ or while loading the mmc rfs for the first time is mentioned in Appendix – L.
IP ADDRESS DETAILS
SDCA Nimbahera
Starting IP Address 10.188.168.0
Total Used
64 Using IP Range 10.188.168.0 - 10.188.168.63 Network IP 10.188.168.0
IP
CIDR 10.188.168.4
Subnet Mask 255.255.255.192 /26 Gateway(s) Broadcast 10.188.168.63
Prefix 10.188.168.7
WAN IP Details IP TAX WAN SSTP WAN CDOT WAN SPARE WAN
Uplink 1 10.189.73.64/30 10:189:73:68/30 10:189:73:72/30 10:189:73:76/30
Uplink 2 10:189:73:80/30 10:189:73:84/30 10:189:73:88/30 10:189:73:92/30
1) Login to MLS through ‘admin’ login from the thin client machine with the MLS
Application software CEServices3_65-MLSSD1_SW002.dat loaded.
3) From Maintenance-> Software -> Upload page, Firmware of the card can be updated.
Browse the PC location for the firmware in CEServices3_65-MLSSD1_SW002.dat format.
Click ‘upload’ button. After the software image is uploaded, a page announces that the firmware
update is initiated. After about a minute, the firmware is updated and the switch restarts.
Warning: While the firmware is being updated, Web access appears to be defunct. The front LED
flashes Green/Off with a frequency of 10Hz while the firmware update is in progress. Do not restart
or power off the device at this time or the switch may fail to function afterwards.
Once the IP of the MLS is set, it can be accessed through internet browser and rest of
the configuration can be done through GUI interface of the MLS, as follows:
1) Create interfaces for other VLANs (IPTAX, SSTP and CDOT-VOIP) for uplink from
MLS-1 and MLS-2 cards.
2) After the interfaces are added, create IP routes. Create a default route with network
0.0.0.0 with mask length 0, the default gateway for this default route will be the interface
IP of IPTAX VLAN. This indicates that any network IP other than the specified network
will be routed towards IPTAX VLAN as it may be the address belonging to media IP of
IPTAX.
3) In the face plate of MLS card two optical ports 21 and 22 are available which are used
for uplink connectivity. An SFP of 1310 or 1550 nm wavelength can be used in these
ports depending upon the SFP type available at BSNL end. An optical patch cord is used
for the connectivity of MLS and PE router. The “Mode” of the port 21 or 22 which is
being used for uplink is to be set as Trunk port.
4) On selecting the required port as Trunk all the VLANs 1-4095 will be allowed and Egress
port setting will be by default set as Untag Port VLAN.
5) From the left pane select Spanning tree Bridge setting and do the STP bridge
configuration with Protocol as RSTP with configuration values as mentioned in
Appendix-J ( Step B, Point no.3 )
6) After all the configurations is done, in the left pane select Configuration Save startup
config to save the configuration.
7) After the configuration is done, one should be able to ping the core network from MLS
and behind MLS i.e. from LAGU, thin client etc.
The new DTB file (NGTJ.dtb.VER53) takes care of the issue of an unhandled interrupt crashing
kernel as soon as NAND flash was accessed through net file.
5. uboot53.scr 798
6. dtb53.scr 959
NOTE: The revised scripts uboot53.scr and dtb53.scr are provided to avoid the Uboot corruption
issues, in case
If there is issue with network and no file is transferred from server to NGTJ card.
If file kept in /tftpboot folder is not correct. That means the file correspond to "ubootfile" or
"dtbfile" in uboot must be available in /tftpboot folder.
In above cases, the UBOOT will go for RESET. The earlier UBOOT or DTB file will be intact in the
NGTJ card and issue of card corruption is avoided.
The following NGTJ cards need to be MANDATORILY LOADED with the mentioned revised
UBOOT/DTB V53 files:
a) CACU NGTJ SE3 card has to be loaded with the revised DTB V53 (NGTJ.dtb.VER53) file only
to take care of NAND flash related issue.
b) The RSU LAGU NGTJ AE3 cards connected over E1 (PCM links) to the CACU-EBM cards
has to be loaded with revised UBOOT V53 (NGTJ.u-boot.bin.VER53) file (to take care of the
looping issues).
OPTIONALLY, the LAGU NGTJ AE3 cards being used as collocated LAGU and RSU LAGU
connected over Ethernet, may be loaded with both UBOOT and DTB V53 files. So that in case of
any card faults/corruptions, one card out of the duplex LAGU cards may also be used as temporary
replacement for CACU NGTJ SE3 card or RSU LAGU NGTJ AE3 cards connected over E1(PCM
links).
# cat /etc/issue command gives output as: MAXNG NGTK Console Rel 1.52
(Which specifies the RFS version mainly)
2) Connect the minicom cable to one of the RS-232 ports for the respective NGTJ card on the
backplane of Chassis.
3) Connect an ethernet cable from the ThinClient/PC to the ethernet ports of LAGU/CACU chassis
with NGTJ card.
[NOTE: Ensure the Ethernet connectivity from NGTJ to thin-client by pinging NGTJ card
from thin-client or vice versa]
4) Ensure that the Appendix-I (I (step-10: c & d) for the Thin Client is followed already for the
TFTP server configuration and following files are copied/transferred at path /var/lib/tftpboot/ of
thinClient :
[As also mentioned at the end for ready reference (***)]
a) NGTJ.u-boot.bin.VER53
b) NGTJ.dtb.VER53
c) uboot53.scr
d) dtb53.scr
NOTE: Verify whether tftp is running on thinclient by executing the following command on
terminal of Thin-Client:
# ps -ef | grep tftp
# cksum /var/lib/tftpboot/NGTJ*VER53
6) On the ThinClient/PC, open the minicom application using the command 'minicom -s' to access
the serial port interface and set baud rate to 115200, no flow control as serial port parameters.
After applying the above settings, save them as default and exit to go to the minicom application.
7) Now, jack-in the NGTJ card in that slot to which minicom has been connected in step-2 and press
the reset button in the bottom part of the face plate of NGTJ card.
8) In the minicom terminal window, see if the print ''Autoboot in 6 seconds. Hit 'a' to stop from
Autoboot'' appears, then press the 'a' key to stop the booting so that NGTJ card comes in the uboot
prompt. The uboot prompt as => should appear. If the uboot prompt could not be stopped, press
the reset button on the NGTJ card and try again.
Note: The IP address settings to be done as per the “IP ADDRESS DETAILS” sheet for the site
Note: “edit” command can also be used instead of “setenv” command in the below
mentioned steps. Usage of edit command:-
=> edit serverip
*existing value stored in the variable “serverip” will be displayed to which is to be edited*
Change it to the desired value and press “Enter” to save it
a) Ensure the IP address of the PC mentioned above is set as the serverip in u-boot command
prompt. To set it use the command:
=> setenv serverip <serverip/IP-address-of-tftp-server-ThinClient/PC>
e.g. => setenv serverip 10.188.168.25
b) Set the IP address of the NGTJ with IP address that is reachable from the ThinClient/PC,
using the command:
=> setenv ipaddr <NGTJ-card-IP>
e.g. => setenv ipaddr 10.188.168.13
c) Set the netmask of the NGTJ card in the uboot as per the “IP ADDRESS DETAILS” sheet
for the site, using the command:
=> setenv netmask <site-netmask>
e.g. => setenv netmask 255.255.255.192
d) Set the gateway IP address of the NGTJ cards as that MLS Card1 for the site.
The command is:
=>setenv gatewayip <MLS1-GW>
e.g. => setenv gatewayip 10.188.168.4
f) Verify the variables which were set above using below mentioned commands(with exact IP
addresses in place of those mentioned in the example IPs below)
=> pri serverip
serverip=10.188.168.25
=> pri ipaddr
ipaddr=10.188.168.13
=> pri netmask
netmask=255.255.255.192
=> pri gatewayip
gatewayip=10.188.168.4
NOTE:- In case of any difference in variable’s value, use the appropriate command
from a) to d) to set that variable with correct value. After that, save the entry using saveenv
command.
NOTE: In case of any error in this step, check the physical ethernet connectivity b/w NGTJ and Thin-
Client. Also, verify that the ipaddr, gatewayip, netmask and serverip are set correctly.
[ Note: In case of any error in this step, check the presence of the file dtb53.scr in the /var/lib/tftpboot
directory of thin-client ]
9....8....7....6....5....4....3....2....1....9....8....7....6....5....4....3....2....1.
...done
Protected 1 sectors
Setting UPDATED
First Change dtbfile with appropriate name by using setenv or edit command
Copy the dtbfile to /tftpboot folder of serverip
Make sure the serverip is pinging. Dont proceed if server is not pinging
Then Type run FUSE_DTB and press Enter
j) => setenv dtbfile NGTJ.dtb.VER53
k) => saveenv
FUSING DTB
TFTP DTB File
Using UEC0 device
TFTP from server 10.188.168.25; our IP address is 10.188.168.13
Filename 'NGTJ.dtb.VER53'.
Load address: 0x7000000
Loading: #
….
done
Bytes transferred = 10067 (2753 hex)
ERASING DTB
.... done
Erased 4 sectors
COPING DTB to NOR
Copy to Flash... 9....8....7....6....5....4....3....2....1....done
Saving Environment to Flash...
Un-Protected 1 sectors
Erasing Flash...
. done
Erased 1 sectors
Writing to Flash...
9....8....7....6....5....4....3....2....1....9....8....7....6....5....4....3....2....1.
...done
Protected 1 sectors
***********************************************************
[ Note: In case of any error in this step, check the presence of the file NGTJ.dtb.VER53 in the
/var/lib/tftpboot directory of thin-client]
n) In the minicom terminal window, see if the print ‘Autoboot in 6 seconds. Hit 'a' to stop from
Autoboot'' appears, then press the 'a' key to stop the booting so that NGTJ card comes in the
uboot prompt. The uboot prompt as => should appear. If the uboot prompt could not be
stopped, press the reset button on the NGTJ card and try again
[ Note: In case of error of “file not found”, ensure the presence of the file uboot53.scr in the
/var/lib/tftpboot directory of thin-client]
Make sure the serverip is pinging. Dont proceed if server is not pinging
Then Type run FUSE_UBOOT and press Enter
r) => saveenv
9....8....7....6....5....4....3....2....1....9....8....7....6....5....4....3....2....1.
...done
Protected 1 sectors
FUSING UBOOT SUCCESS
*******************************************************************************
[ Note: In case of the error of “file not found”, ensure the presence of the file NGTJ.u-
boot.bin.VER53 in the /var/lib/tftpboot directory of thin-client.
...
Load address : 0x7000000
Loading: T T T T ...
Then it means that that there is some network issue and in this case operator may
press “CTRL-C” to interrupt above messages and the card will reset on its own
thereafter. One may also physically reset the card by pressing “reset” button on the
NGTJ card front plate in such a case.
In case set “ubootfile” or “dtbfile” is absent in tftp-server, then the card will reset
automatically after displaying “Tftp error:file not found” message.
t) => reset
NOTE:-
operator must check that after executing "=>reset" command that "U-boot 5.3..." is
appearing on screen. If instead "U-boot 5.2 ...." is printed then it means one has missed some
step somewhere and will have to repeat the "U-boot loading" procedure.
***FOR REFERENCE: Appendix-I Step- 10 (c & d) for Thin Client regarding TFTP
configuration & UBOOT/DTB V53 files copying
c. Following steps need to be followed for installation of the tftp server over thin client and
copy the relevant drivers at the /var/lib/tftpboot/ path:
(Please enter the Ubuntu user password when prompted)
a. cd <path-where-UBOOT_DTB-V53.tar is present>
b. tar –xvf UBOOT_DTB-V53.tar
c. sudo dpkg -i MXNG-1.0-tftpd-THIN-CLIENT.deb
d. sudo cp tftp /etc/xinetd.d/
NOTE: Verify whether tftp is successfully installed or not, check the presence
of the directory /var/lib/tftpboot/ by using following command.
# ls –lrt /var/lib/tftpboot
Output of this command should NOT show that “No such file or directory”
d. Now, copy the UBOOT-V53, DTB-V53 and other script files to /var/lib/tftpboot
Details of product wise Release and Patches contained in the above zip file:
Details of product wise Release and Patches contained in the above zip files:
a) XEYEPL1_1_2.12_1.zip:
1. XEYEPL1_1_2.12_1-Deliverables.txt (908 bytes)
2. V5AG Patch: PATCH9-Over-AGL1_1_3.4_1-AI-DEL-MOD.tar (113592320 bytes)
3. NGTJ card EMS Agent tar file: gwyagentl3_1_1.5_1-NGTJCardAgent.tar (8990720
bytes)
4. PRIAG EMS Agent tar file: PATCH1-Over-GWYAGENTL3_1_1.5_1-
PriAgentNGTJ.tar (686080 bytes)
5. TMG EMS Agent tar file: PATCH2-Over-GWYAGENTL3_1_1.5_1-
TmgAgentNGTJ.tar (460800 bytes)
b) TEMP-OVER-XEYEPL2.12.zip:
1. TEMP-OVER-XEYEPL2.12-Deliverables.txt (579 bytes)
2. CDOT Trunk Media Release TAR for CACU Solution: PATCH1-Over-
CDTMGL1_1_1.9_1-NGTJ-CACU.tar (5396480 bytes)
3. CACU EBM EMS Agent : ebml1_1_1.7_1-EBMCardAgent.tar ( 8970240 bytes)
4. EBM Release TAR : eebrel_1.7.tar (81920 bytes)
5. Patch Deliverables CACU EBML1_1_1.7_1: PATCH1-Over-EBML1_1_1.7_1-
DISPL-INVALID-PORT-NUM.tar (20480 bytes)
6. PRI Gateway Release: PRIGATEWAYL1_1_1.2_1.tar (73062400 bytes)
7. Patch Deliverables SGL1_3_1.9_1: PATCH1-Over-SGL1_3_1.9_1-INIT-CACU-
ONLY.tar (3225600 bytes)
c) NGTJ_DRIVERS-REL5.zip :
1. NGTJ_DRIVERS-REL5-Deliverables.txt (314 bytes)
2. CACU Drivers TAR : NGTJ_DRIVER_CACU-REL5.tar (4485120 bytes)
3. PSG Utilities TAR: PSG_NGTJ_UTILS_REL1.tar (778240 bytes)
4. Installation Script : install_ngtj_drivers.sh (2684 bytes)
Details of product wise Release and Patches contained in the above zip file:
a) MLS :
1) CEServices3_65-MLSSD1_SW002.dat (5,466,769 bytes)
b) NGTJ Card Drivers and loading scripts :
1) UBOOT_DTB-V53.tar (1556480 bytes)
c) THIN CLIENT Deliverables :
1) MXNG-1.0-NFS-SRVR-FOR-THIN-CLIENT.tar (4,085,760 bytes)
2) thin_client_nfs_installer.sh (2377 bytes)
3) MXNG-1.0-tftpd-THIN-CLIENT.deb (44,938 bytes)
4) tftp (384 bytes)
5) java.policy (4958 bytes)
6) thinclient_ipconf_gw.sh (14971 bytes)
d) BULK_RETROFIT Deliverables :
1) PATCH10-Over-MXMIGRL1_1_1.2_1-LAG_BULK_FROM_ITPC_VER2.tar(143660 bytes)
2) lagbulk_README.docx
3) anbulk.sh (4486 bytes)
4) anbulk_README
e) PSG_Deliverables
PREREQUISITES:
1) The application release CEServices3_65-MLSSD1_SW002.dat should be loaded on both
the MLS cards of the CACU.
2) The dtb file for the NGTJ card should be loaded on the SE3 or AE3 NGTJ card to be used
in the CACU.
3) The CACU deliverables described in the Appendix-F, part 2 should be copied to a
directory on the thin-client/PC from where application release installation has to be done
on the CACU cards.
4) A detailed list of IP addresses to be allocated to the cards of CAU should be present as
described in the Appendix - A.
5) The thin-client should have been configured and readied according to the Appendix-I.
6) Connect an RS-232/minicom cable to the thin-client at one end and with the minicom
serial port behind each card slot one by one to assign IP addresses to the cards.
7) Log-in to the cards via the minicom using the username “root” and password “root”. The
process to assign IP addresses to the every type of CACU cards is described as follows:
For MLS card IP settings; set the VLAN1 (native default VLAN) IP address. See
Appendix-B for reference.
Once the above is ensured, proceed with the actual installation of the application software
release as given below.
1) Switch to the root user on the thin-client/PC (to be used for further installation process), if
not already using the command ‘su - root’.
2) Now connect the thin-client with any free Ethernet port (RJ-45) available on the MLS-1
card at the 7th slot of the CACU chassis.
3) Assign an IP address to the thin-client (or PC) using the IP address available at the site as
detailed in the Appendix I (steps 7 onwards).
4) Copy the CACU deliverable zip file named MXNG-CACU1.0.zip (mentioned in Appendix – F)
in the thin-client at a directory (such as /home/ubuntu/) and extract it using the command:
#unzip MXNG-CACU1.0.zip
Note that the operator can copy the deliverable zip file MXNG-CACU1.0.zip to any other
path such as /home/ubuntu/Desktop, but there should be NO blank space in the path name.
#cd /home/ubuntu/MXNG-CACU1.0
6) Now, give the script named install_cacu_cards-v1.1.sh executable permission using the
command
#chmod +x *sh
7) Execute the script using the command:
#./install_cacu_cards-v1.1.sh
8) When the script is run for the first time on a particular thin-client/PC, the script will initiate the
unzipping of the release/patch files locally to arrange them in a structure as required during the
installation on the cards.
9) Once the unzipping is complete, the script asks for the Type of CACU system. For MAX-NG, it
must be entered as 1. Output is similar to
10) After this, the script will ask for input for various parameters such as the IP addresses for the
CACU, IP address of the NGEMS, NGSM, NTP server etc. The sample output is:
Note: The above IP address, ports, system name etc are just an
indicative example and the actual entries must be entered according
to the field data.
In this case, the user should enter the IP address of the GR NTP server.
11) Now the user is displayed the values that have been entered so far and is asked whether these
values have to be changed (eg in case of some discrepancy). Note that these are the example
values which have been entered above and should be entered according to the site.
To change any value, enter the number corresponding to it, such as to change the
NGEMS Region Name, enter 9 or to change the broadcast IP address, enter 5.
To proceed (without changing these entries or after changing particular entry), enter 0.
12) After this the script asks whether the IP addresses on the CACU cards have been updated, this
should be confirmed by entering ‘Y’ if the steps in the prerequisites have been completed, else,
the script should be exited and the IP addresses should be first assigned to the cards.
********
The physical card IPs for CACU chassis are:
MLS1 = 10.187.212.4
MLS2 = 10.187.212.7
SLM1 = 10.187.212.9
SLM2 = 10.187.212.10
EBM1 = 10.187.212.11
EBM2 = 10.187.212.12
NGTJ1 = 10.187.212.13
NGTJ2 = 10.187.212.19
********
13) Once done that is ‘Y’ has been entered to confirm and proceed, the script will ask the following
option:
14) After this step, the script prompts for the card on which the installation has to be done, through a
following menu:
Select Card Type:
[1] For SLM
[2] For NGTJ
[3] For EBM
[4] Go Back to Previous menu
[0] To Exit
15) After any card type is selected, the user will be prompted for the IP address of the card to be
confirmed and then some other input parameters for the cards. For SLM card, the script will also
ask if the setup is in a simplex or duplex SLM configuration. Example, duplex SLM here.
In the above example, 10.187.212.9 is the IP address of the SLM card on which installation is
being done and c9:66:1f:4e:6e:b9:c9:c3:cc:46:4c:44:1b:56:ad:1e is the ssh RSA key for that
particular CACU card (SLM/EBM or NGTJ). These two values will be different for every card
depending upon the site.
18) This will display an output as the following and ask for the password for the root user of CACU
card (SLM/EBM/NGTJ) on which the installation option has been selected :
Warning: Permanently added '10.187.212.9' (RSA) to the list of
known hosts.
root@10.187.212.9's password: (Default is root)
Now try logging into the machine, with "ssh 'root@10.187.212.9'",
and check in:
.ssh/authorized_keys
NOTE: This “warning” is not actually an error or a warning and should be ignored.
Similar prints and entry for the password of the root used of the other SLM card (duplex case)
will be asked and should be entered.
19) After this, the user will be asked if the backup of the configuration has to be taken
Enter Y/y for taking and restoring backup Or N/n to skip backup
n
For the first time installation, the backup option should be selected as n.
20) During the installation of the SLM cards, some prints would be shown related to file transfer and
file creation. One input will be asked related to the secure connection between the active and
stand-by SLM cards, which will be something similar to the following:
******************************************************
******************************************************
Here, the user will be have to press the Enter key thrice for the secure key creation.
NOTE: This temporary failure is not an error or a failure, but is shown because the entry of
that particular SLM card was not yet present in the DNS. This should be ignored.
22) Now the user will again presented the main menu of the script and the user should select the
application release installation for other CACU card, say NGTJ card.
23) Again the IP address of the NGTJ card will be asked and output similar to steps 15 and 16 will be
presented. Such warnings are to be ignored The output will be similar to as follows:
.ssh/authorized_keys
to make sure we haven't added extra keys that you weren't
expecting.
Here, the IP address 10.187.212.13 is just an example IP address for the CACU NGTJ card.
24) Now the operator is presented with some information regarding the NGTJ card OS release version
and the FPGA version. When asked to continue with the installation, the operator should enter ‘y’.
25) After this, the user will be asked to take the backup of the configuration files.
Enter Y/y for taking and restoring backup Or N/n to skip backup
n
For the first time installation, the backup option should be selected as n.
The backup should be taken if the users and other data has already been created before.
26) Once the initial I2C driver related installation is done on the NGTJ card, a welcome message is
displayed to the operator, that looks similar to:
@@@@@@@@@@ @@@@@
@@@@@@@@@@ @@@@@
@@@@@@@@@@ @@@@@
@@@@@
@@@@@ @@@@@
@@@@@ @@@@@
@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@
C-DOT
At the end of this text it asks whether the operator wants to continue with the installation and
to modify the ‘default input’ file. The operator should continue (y) with the installation and
should not modify the ‘default input’ file. The screen output is:
27) Upon continuing with the installation of the CACU NGTJ card, some other inputs will also be
taken from the user. These include the C5 server IP address, C4 server IP address, whether to
enable a particular gateway on the NGJT card and likewise. The output is shown as follows:
Here the operator should select ‘y’ installing a particular gateway on the NGTJ card and for
enabling particular gateway according to the site (as shown in the example above).
29) Alternatively, if the operator does not want to configure the DR feature, the C5 IP address is
asked as well and the entries related to the domain name are not asked. The output shown is as
follows, when the DR feature is not configured:
In the example above, the DR feature was not enabled selecting ‘n’,'10.187.0.15' is the
C5 server IP address and 10.187.0.12 is the C4 server IP address.
For points related to the PRI gateway configuration parameters, following (y,y,n) be entered.
MAX-NG Access SW Inst & Config[v01] 29.May.2018 Page 32
Do you want to use country code in PRI GATEWAY ? [ y/n ]: y
Do you want to enable CDR at PRI GATEWAY ? [ y/n ]: y
Do you want to run PRI GATEWAY in CPE(PBX) mode? [ y/n ]: n
30) After these values are provided by the operator, the values are confirmed and the operator is asked
whether to proceed with the installation. ‘y’ should be entered to proceed/re-confirm proceeding
with the installation.
31) In case the operator opts to not proceed with the installation, the options presented by the script
are
32) When the installation option is selected (Point 29), a list of the files to be installed on the NGTJ
card is shown and the file transfer to the NGTJ card starts, where you will be prompted to enter
‘y’ in intervals.
33) Once the installation step reaches the SG installation, it also asks for some inputs, related to the
SG server and PR-GR configuration.
The output is similar to the following and the user should enter the values asked:
34) The installation for SGL2 starts after this and when the SGL2 installation is finished, a following
message is displayed:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
!!!! 10.187.212.21 :sgl2 installed sucessfully!!!!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
35) When the installation of release is completed on the NGTJ card, the NGEMS agent installation on
the NGTJ card, per gateway is asked, and the user should enter ‘y’ according to the access
gateways installed on the CACU NGTJ card. An example output is:
In the above example, the NGTJ card Agent has been selected for installation and the user has
selected y.
Similarly for other Agents, such as PRI EMS GatewayAgent , V5 EMS Gateway Agent and
SG EMS Gateway Agent, whichever is applicable, y should be entered to installed otherwise,
only Enter should be pressed to skip a particular gateway agent installation.
36) Finally when the installation is complete on the NGTJ card the NGTJ card must be given a
command to reboot:
37) Once the installation is completed on the NGTJ card , the script returns to the main menu as the
follows and the installation for EBM card should be selected after this
PREREQUISITES:
a) Ensure that the IP addresses are available with the user as described in Appendix –A.
b) The thin-client has been prepared/configured according to the Appendix-I.
c) For complete release and patches installations, MXNG-LAGU1.0.zip as mentioned in
the Appendix-F is present in the thin client folder, say “/home/Ubuntu/LAGU-
SOURCE/”.
d) The NGTJ cards have to be loaded with the provided VER53 uboot and dtb files.
Refer the Appendix-E.
2) Connect the minicom cable to the RS-232 port of one of the NGTJ cards of the LAGU
chassis and log-in using the username “root” and password “root”.
3) Before proceeding for LAGU installations, do the following steps to shutdown the
LAG applications :
# /cdot/bin/mount_mmc_ext3
# chroot /mmc /etc/lag_shutdown.sh 2
4) Connect the LAGU with the CACU for uplink either using the Ethernet ports to the
CACU MLS card or via the E1/PCM links on the LAGU to the EBM cards of the
CACU.
It should be noted that both the Ethernet and E1 links for a same LAGU should not be
used, otherwise it may cause network looping.
5) Configure the site IP for the LAGU NGTJ cards through the minicom terminal using
the following four (4) commands to be typed on the terminal window of the NGTJ
card in the sequence given(replace values inside angular brackets < >) :
# /sbin/ifconfig eth0 down
# unzip –o MXNG-LAGU1.0.zip
# cd MXNG-LAGU1.0
# ./run_install_lagu.sh
11) Currently for field migrations, option [2] will be invoked in case the base release
CLAGL2_4_1.2_1 is already installed over the LAGU cards and only the patches
need to be loaded.
12) The option [3] is executed in case the base release CLAGL2_4_1.2_1 and the latest
patches need to be installed over the LAGU cards.
13) Backend Release as well as patches will be installed as well, when the user will select
either option [2] or option [3].
14) In case we select the option [3], then following output/prompt is given to user:
15) The user is asked for an option to perform an installation on a simplex or duplex
LAGU system
16) For a simplex installation, the user is shown the following output:
MAX-NG Access SW Inst & Config[v01] 29.May.2018 Page 37
Option of Simplex Installation selected
Enter the COPY-ID(0/1) of LAGU's NGTJ Card
17) If the user selects the option for a duplex installation, the output shown is as:
Upon entering the IP address of the first NGTJ card, the user is prompted for the IP address of
the second NGTJ card:
The user is not prompted for a copy id in case the duplex option is selected.
18) The user is then asked whether a backup of existing configuration files on the LAGU
cards has to be taken or not, the output shown is:
It is recommended that for the first time field migration installation, this option
must not be done. Output shown is:
19) After the above entries are taken, the following configuration values will be asked
from the user:
21) If a no is input by the user for DNS based routing, the user prompts for input would be as
the followings:
(Note: These values are just examples, and must be replaced with actual values
at the site.)
22) After these entries have been done, the user is then displayed the inputs received so
far and an option to change them.
The user may change any entry corresponding to its number if needed., eg, to change
the value of NTP Server IP Address, 6 should be entered.
[ 0 ] To Proceed
Do you want to change any value? [yes/no]
no
User selected to proceed with the given configuration
23) In the next prompt, the script creates an ssh/scp connection between the PC/Thin-
client and the NGTJ cards. The user is asked to ensure the authenticity of the ssh host
(NGTJ cards) followed by the password of the NGTJ card, which should be entered as
root. The following output should be displayed:
In the above example, 10.187.1.5 is the IP address of the NGTJ card on which
installation is being done and c9:66:1f:4e:6e:b9:c9:c3:cc:46:4c:44:1b:56:ad:1e is the
ssh RSA key for that particular NGTJ card. These two values will be different
24) After this step, the password for the root user of the NGTJ card is asked, with an
output similar to:
Warning: Permanently added '10.187.1.5' (RSA) to the list of
known hosts.
root@10.187.1.5's password:
Here, enter the password of the root user. The password as you type will not be
visible.
Note that the Warning shown here is not any error or warning, so should be
ignored.
25) Now, the installation proceeds and takes around half an hour for each NGTJ card, thus
around an hour for each LAGU. There would be continuous prints on the screen while
the installation progresses.
26) First the release is installed and the prints are shown as follows:
27) After this, the backend for remote software installation and backup and restoration
modules are installed with LAGU and LAGAGENT patches when the option to install
patch installation was also selected in point 9. There is no need to manually install
them. The prints are shown as follows:
PATCH16-Over-CLAGL2_4_1.2_1-lagagent-KillingOnCliDataUpdation.tar
100% 10MB 2.5MB/s 00:04
Untarring PATCH16-Over-CLAGL2_4_1.2_1-lagagent-
KillingOnCliDataUpdation file...
Editing install_run_lag.sh on 10.187.1.5
Executing install_run_lag.sh...
Killed: lag_backup.exe
in RAMDISK Verify by command: ps | grep lag_backup.exe
mkdir: cannot create directory '/mmc/BKRS_RELEASE': File exists
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
BACKUP & RESTORATION INSTALLATION FOR LAG STARTED
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
================================================================
Installation of BACKUP-RESTORATION completed ...
Now configure /etc/backup.conf file with the required information
To start backup process usage : /usr/bin/lagbkrs_start
To stop the backup process usage : /usr/bin/lagbkrs_stop
================================================================
28) During the installation of PATCH17, script will ask for IP address/Domain name of
Rater Server. Enter the IP address/Domain name accordingly.
PATCH17-Over-CLAGL2_4_1.2_1-DTMF_CDR_DSP_LAGU.tar
100% 7100KB 2.0MB/s 00:03
Enter the IP adddress/Domain Name of Rater
192.168.103.108
Do You Want to Configure IP adddress/Domain Name of Rater
Enter [y/n]
n
NOTE:- Enter ‘n’ only. ‘y’ should not be entered.
Wait for the cron utility to start
The patch PATCH17-Over-CLAGL2_4_1.2_1-DTMF_CDR_DSP_LAGU has been
installed successfully...
1) Connect the Thin-Client machine/box with the keyboard, monitor and mouse, power
source, and boot the thin client.
2) Log-in to the thin-client with the default user named Ubuntu (in case not directly
logged in).
3) Open the terminal window.
4) Set the password for the ‘root’ user at the thin client machine as mentioned in
procedure below:
a. In the terminal window opened in step 3, type the command:
sudo passwd root
b. This command firstly asks the operator to enter the password of the ubuntu user,
which is cdot123.
c. After this enter the password for the root user, as root123. The password will be
once input and then confirmed. Thus the password has to be entered twice. This
will update the password for the root user.
5) Now, connect the thin client with the CACU MLS-1 card at any free FE port (RJ-45)
with an Ethernet cable.
6) Connect the USB interface of the minicom device with any free USB port of the thin-
client. After this, configure the minicom settings using the following steps:
a. su – root
b. #ls -lrt /dev/*tty*
Note the last entry, it should be similar to something such as:
crw-rw---- 1 root dialout <some no.>, 0 <date> <time> /dev/ttyUSB0
c. Note the last entry that may be /dev/ttyUSB0 or /dev/ttyUSB1 etc. depending
upon the USB port used.
d. #minicom - s
e. It will ask Change Which Setting and present a menu list.
f. Go to the option ‘Serial Port Setup’ and press Enter.
g. In the input menu, press ‘A’ to edit the Serial Device to a value noted in the point
b/c above and press Enter to save it.
h. Set the option E, Bps/Par/Bits to 115200 8N1 if not set already.
i. Set option F, Hardware Flow Control to No.
j. Set the option G, Software Flow Control to No.
k. Press Enter to go back to the previous menu.
l. In this menu, go to the option Save Setup as dfl and press Enter. This will save
the settings made in the steps g through j. A message Configuration Saved will
be displayed.
m. Go to the Second Last option, Exit and press Enter. This exits from the Menu and
launches the minicom.
n. Note: In case the USB port is changed for the minicom, steps b to g must be
repeated.
o. root user should be exited if not using minicom.
8) Ensure that the MLS cards have been configured for the Native VLAN IPs, gateways
and the WAN IPs/routes configurations have been completed for uplink as detailed in
Appendix–D.
9) Configure the thin client machine IP address settings as per the IP address available
in the IP ADDRESS DETAILS mentioned as “Terminal (Thin Client) IP” (in
Appendix – A) either using the script “thinclient_ipconf_gw.sh” provided for thin-
client mentioned below in part-a) OR the manual procedure mentioned in part-b) :
After that, confirm the IP set above using the command ‘/sbin/ifconfig’ on the
terminal window.
auto lo
iface lo inet loopback
auto eth0
iface eth0 inet static
address <IP address of the thin client>
netmask <Netmask of the thin client>
network <Network address of the thin client>
broadcast <Broadcast IP address for the thin client>
gateway <Management IP Address of the MLS-1 card>
Press the ‘Esc’ key to exit out of the insert mode of the editor and type ‘:wq’. After
this, press the Enter key.
Now bring the network interface up using the command:
#ifconfig eth0 up
Confirm the settings done above using the command ‘/sbin/ifconfig’ on the terminal
window and after that, ping the gateway IP address, that is the IP address of the MLS
card-0, using the command ‘ping <IP address of the MLS-1 card>’ in the terminal
window.
10) Now test the core nodes reachability as mentioned in the steps below:
a. Ping the Core Server using its domain name. The command to be used is:
#ping <Domain Name of the Core server>
In case the pinging results in a packet loss, ensure the IP connectivity is made.
c. Following steps need to be followed for installation of the tftp server over thin
client and copy the relevant drivers at the /var/lib/tftpboot/ path:
NOTE: Verify whether tftp is successfully installed or not, check the presence
of the directory /var/lib/tftpboot/ by using following command.
# ls –lrt /var/lib/tftpboot
Output of this command should NOT show that “No such file or directory”
d. Now, copy the UBOOT-V53, DTB-V53 and other script files to /var/lib/tftpboot
e. Following steps need to be followed for quicker response of EMS GUI in Thin
Client.
-Xms128m –Xms1024m
g. Following steps need to be followed for installation of the NFS server over thin
client:
Copy following deliverables to any directory on the thin-client
i. thin_client_nfs_installer.sh
ii. MXNG-1.0-NFS-SRVR-FOR-THIN-CLIENT.tar
Go to the directory, where the above mentioned tarball and script are
copied
# cd <path-where-NFS-tarball-and-script-are-present>
NOTE: In case of a storage space issue over the Thin Client machine; check with the
following command for presence of large size files (say more than 100 MB)
# find / -size +100M
NOTE: Once the installation and configuration of the thin-client and the
CACU cards is over, connect the Ethernet cable from the thin-client to the
port 5B_01 or 5B_02 or 6B_01 or 6B_02 on the CACU backplane. It must
be connected to a port in which a card is jacked in.
1. Latest patches are required in both CACU and LAGU (already taken care of in the
appendices ‘G’ and ‘H’)
Hello Time 1
Forward Delay 4
Max Age 6
Maximum Hop Count 6
Transmit Hold Count 2
For Additional setting required for NTP, Trap and MLS Link Alarm configurations,
do the configurations as mentioned in detail in a separate document for MLS card
Configuration. Broad steps for these points are as follows:-
o For NTP related configurations , Go to Configuration -> System -> NTP
Mode should be Enabled and enter SBC FVIP of PR Site in Server 1 option
and in Server 2 option, enter SBC FVIP (GR Site) IP address.
o For trap configuration settings, go to Configuration -> System -> Security ->
SNMP -> Trap. Mode should be Enabled. Add three Entries of PR NGEMS
Server and one entry of GR NGEMS Server.
o For MLS Link removal Alarm related configurations, create static routing for
NGEMS server IP addresses in MLS-1 as well as MLS-2. MLS-1 should have
MLS-2 IP address as its gateway for uplink alarm purposes and vice versa.
3) For termination at CACU EBM, existing CM end connections CANNOT be used. The existing
MAX CM E1-cable connector should be removed & its wiring should be connected at the DDF
provided in CACU (to which the supplied 16/32 E1 cable extended from EBM is terminated on
the other side).
4) We can connect four nos. of E1 (two nos. per NGTJ copy) from the RSU LAGU. The 1st pair of
E1 connected between one copy of LAGU-NGTJ card to 1st EBM of exchange CACU and the
2nd pair of E1 is connected between other NGTJ card copy to 2nd EBM of exchange CACU.
Only one pair of E1 (i.e. 2 E1s) is enabled at a time from one NGTJ card copy of the RSU LAGU
system; the other pair remains in disabled state. The disabled E1 pair is enabled only in case the
Active E1 pair goes down/ jacked out or the NGTJ card with current active E1 pair is removed.
Thus, we will have one pair of E1 (2 E1s) enabled at a time to carry the RSU calls traffic.
5) If multiple RSU LAGUs are connected over E1 to the CACU EBM cards, then from each NGTJ
card one E1 pair should terminate over EBM E1 pair of (1,2) or (3,4) or (5,6) .. (31,32) etc. And
Not like (2,3) or (4,5) etc.
The corruption of the /mmc partition can be checked using any of the following cases:
In case the /mmc partition of the NGTJ of becomes corrupt or it is for the first time that the mmc
partition is being created, the following steps are to be followed:
1. Try to go to the /mmc directory and transfer the database files to the thin-client or some PC if
possible. In case of extreme corruption cases, it would not be possible to read from the /mmc.
1) /mmc/etc/ CdotLagDbConf.bin OR
/mmc/etc/ CdotLagDbConf.bak1 OR
/mmc/etc/ CdotLagDbConf.bak2
1) /mmc/NGTJ*
2) /mmc/ngtj/run.sh
3) /mmc/sgstk/cdot_sgl2.conf
4) /mmc/etc/resolv.conf
5) /mmc/ag/CdotAgwDb.bin*
6) /mmc/etc/v5ag/extensions.conf
7) /mmc/etc/v5ag/v5ag.conf
8) /mmc/etc/priag/priag.conf
9) /mmc/etc/priag/extensions.conf
10) /mmc/opt/tmg/etc/cdot_tmg.cfg*
11) /mmc/AGENT/snmp/cardagent/snmpd.conf
12) /mmc/AGENT/snmp/cardagent/gatewayagentdev.conf
13) /mmc/AGENT/PRIAG/cagent/conf/agent.conf
14) /mmc/AGENT/PRIAG/cagent/conf/device.conf
15) /mmc/AGENT/PRIAG/cagent/conf/service.conf
16) /mmc/AGENT/PRIAG/cagent/conf/dev-conf-agent.conf
17) /mmc/AGENT/PRIAG/cagent/conf/ems-agent.conf
18) /mmc/AGENT/TMG/cagent/conf/agent.conf
19) /mmc/AGENT/TMG/cagent/conf/device.conf
20) /mmc/AGENT/TMG/cagent/conf/service.conf
21) /mmc/AGENT/TMG/cagent/conf/dev-conf-agent.conf
22) /mmc/AGENT/TMG/cagent/conf/ems-agent.conf
23) /mmc/AGENT/V5AG/cagent/conf/agent.conf
24) /mmc/AGENT/V5AG/cagent/conf/device.conf
MAX-NG Access SW Inst & Config[v01] 29.May.2018 Page 54
25) /mmc/AGENT/V5AG/cagent/conf/service.conf
26) /mmc/AGENT/V5AG/cagent/conf/dev-conf-agent.conf
27) /mmc/AGENT/V5AG/cagent/conf/ems-agent.conf
2. Unmount the partition /mmc on the NGTJ card using the commands:
#cd /
#umount –l /mmc
Now execute following command to format the /mmc partition on the respective NGTJ cards:
For LAGU NGTJ card:
# /sbin/mkfs.ext3 /dev/mmcblk0
3. Mount the /mmc partition on the NGTJ cards using following command
For LAGU NGTJ card:
# mount -t ext3 -o noatime,data=writeback, commit=200
/dev/mmcblk0 /mmc
NOTE:- The above mentioned command is to be executed from thin-client/PC, where MXNG-
NGTJ-LTIB-V05.tar is present.
# cd /mmc
# tar -xvf MXNG-NGTJ-LTIB-V05.tar
Untarring of RFS tarball will take around 15-20 minutes on LAGU NGTJ card and 5-10
minutes on the CACU NGTJ card.
# chroot /mmc
7. Now perform the installation of release and patch on the NGTJ cards as mentioned in the
above Appendices.