Beruflich Dokumente
Kultur Dokumente
W-CDMA
Alcatel-Lucent 9353 Management System
OAM Parameters Network Reconfiguration
Procedure
NN-20500-196 01.05 / EN Preliminary September 2008
Wireless Service Provider Solutions
W-CDMA
Alcatel-Lucent 9353 Management System
OAM Parameters Network Reconfiguration Procedure
Document number: NN-20500-196
Document issue: 01.05 / EN
Document status: Preliminary
Product release: UA06.0
Date: September 2008
PUBLICATION HISTORY
SYSTEM RELEASE: UA06.0
September 2008
Issue 01.05/EN Preliminary
Update after internal review.
August 2008
Issue 01.04/EN Draft
UA06.0 Update for DR4
The procedures Deactivate the OS Hardening Tool and Create a New ROC Configuration
File to Change the Network Parameters were updated.
Audience
This document is for all persons involved in the modification of the network parameters of the OAM
servers. This person must have knowledge of the system administration and the OAM administration
and configuration.
CAUTION
In order to plan the network reconfiguration, the operator must
entirely read this document and asks the local support for all the
information needed before executing this procedure.
CAUTION
It is mandatory that, prior to start the network reconfiguration, a
backup of the server is available.
CAUTION
It is STRONGLY RECOMMENDED that, at the end of the network
reconfiguration, a full system and data backup of the servers is
performed.
Related Documents
• [R1] IM 30-0234 UMTS UA06.0 DHCP Activation in a service UTRAN
• [R2] NN-10300-036 Alcatel-Lucent 9353 Management System - Workstation Client / Application
Installation
• [R3] NN-20500-073 Alcatel-Lucent 9353 Management System - OAM Upgrade Procedure
• [R4] NN-10300-035 Alcatel-Lucent 9353 Management System - Backup and Restore
• [R5] Sun StorEdge™ Disk Array Installation, Operation and Service Manual
For a collection roadmap, see UMTS Access Document Collection - Overview and update summary
(NN-20500-050).
3 What is New
•
Issue 01.05/EN Preliminary
Update after internal review.
•
Issue 01.04/EN Draft
UA06.0 Update for DR4
The procedures Deactivate the OS Hardening Tool and Create a New ROC Configuration File to
Change the Network Parameters were updated.
•
Issue 01.03/EN Preliminary
UA06.0 Pre DR4
•
Issue 01.02/EN Draft
Update following internal review
•
Issue 01.01 / EN Draft
Update for UA06.0 / OAM06.0
4 Requirements
Resources
• A UNIX Systems and Network engineer.
• A system console on each OAM Server must be available (system console can be a station
connected to a Xyplex/Annex).
5.1 Prerequisites
• Operator performing this procedure must have root access on all OAM servers.
• Detailed description of Old and New ROC topologies must be available.
• The OAM server must be installed with standard procedures.
• Packages NNWINSC, NNWINST, NNWCOMC, NNWCOMT and NNNETUPD must be installed
on all OAM servers.
CAUTION
Before proceeding the network change, the operator MUST Backup
all the OAM servers of the ROC (See the [R4] document).
If the network reconfiguration includes the disks arrays (on SF4800/4900), the operator must ensure
that the state of disks arrays are correct.
Note: Disks arrays must be on the same sub-networks (OAM_OAM group) as the host.
If the network reconfiguration includes one or more Uninterruptible Power Supply (UPS), the operator
must ensure that the states of UPS are correct.
If the network reconfiguration includes the System Controller of a Sun Fire 4800/4900 or a Netra 240,
the operator must be prepared to change manually the network parameters of this System Controller.
Applications
All OAM applications are stopped on all OAM servers of the ROC during the network reconfiguration.
Routing
The IP address of the router(s) of the local network is not stored in the ROC configuration file. So
before launching the network reconfiguration and according the network reconfiguration, the operator
has to:
• Define the IP address(es) of the new router(s).
These IP addresses are stored in a file ("/etc/defaultrouter-new") on each OAM server of the ROC.
This file has the same format as the "/etc/defaultrouter" file.
During the network reconfiguration, a message is displayed on the console to inform the operator to
change the network hardware. At this time, the operator has to unplug all the Ethernet wires and
perform the hardware changes. The network reconfiguration resumes when at least one network
interface is up again (i.e. one Ethernet cable is connected to the network).
5.3 Description
The chosen solution is based on a manager/agent pattern. The operator has to launch the ROC
network update on the system console of the PMS, which activates network update managers on
each OAM servers.
Then the managers calls some network updater agents depending on the OAM products installed on
the machines.
Information Required
The network information of the ROC is stored in the ROC configuration file.
To apply the change, the process uses these files on each server of the ROC:
• The original ROC configuration file:
"/opt/nortel/config/iut_tools/roc/iut_rocconfig.cfg"
• The new ROC configuration file:
"/opt/nortel/config/iut_tools/roc/new_rocconfig.cfg"
• The new router information file (optional):
"/etc/defaultrouter-new"
Scheduling
The following table gives the sequence
Checks
OS phase before Wiring
"Wiring"
PRODUCT reconfiguration
Finalize reconfiguration
Clients reconfiguration operations
Backup/Restore reconfiguration operations (if applicable)
DHCP reconfiguration (if applicable)
Note: Time required by 'Wiring' phase depends on ROC size and amount of changes that must
be done.
Result
After the whole process,
• The original ROC configuration file is now:
"/opt/nortel/config/iut_tools/roc/old_rocconfig.xml"
• The new ROC configuration file is now the current ROC configuration file:
"/opt/nortel/config/iut_tools/roc/iut_rocconfig.xml"
If a new router configuration file exists:
• The original router configuration file is now:
"/etc/defaultrouter-old"
• The new router configuration file is now the current configuration file:
"/etc/defaultrouter"
5.4 Troubleshooting
User Configuration
The process does not change the user configuration automatically, so each user must correct his
personal configuration to take account of the network changes. In particular, the SSH configuration
file of each user depends of the hostname and the IP addresses and has to be changed manually.
Fallback
No fallbacks are available. If the network update was not performed successfully, the server can be
put back to the original network configuration.
To recover the original ROC configuration, the operator has to:
• Move faulty ROC server back in the old network.
• If applicable to this server, restore the network parameters of disks arrays (refer to documents
[R5]).
• Perform a full system restore, and data restore if necessary, on the server (refer to the document
[R4].
6 Sheets
The following provides the high level overview of steps necessary to successfully complete the
network reconfiguration:
• 1 Check Hosts before the Network Reconfiguration
Target host: PMS
• 2 Deactivate the IP Filter
Target host: All OAM servers
• 3 Deactivate the OS Hardening Tool
Target host: All OAM servers
• 4 Create a New Default Router Configuration File to Change the Network Parameters
Target host: All OAM servers
• 5 Create a New ROC Configuration File to Change the Network Parameters
Target host: PMS and SMS
• 6 Reconfiguration of the Spare System Controller of the Sun Fire 4800/4900
Target host: All SF4800/4900 servers
• 7 Launch the Network Reconfiguration Process
Target host: All OAM servers
• 8 Reconfigure the Network Hardware
Target host: All OAM servers
• 9 Special Operations for the Sun Fire 4800/4900
Target host: All SF4800/4900 servers
• 10 Special Operations for the Netra 240
Target host: All Netra 240 servers
• 11 Activate the IP Filter
Target host: All OAM servers
• 12 Activate the OS Hardening Tool
Target host: All OAM servers
• 13 Clients Reconfiguration Operations
Target host: PC/UNIX Clients
• 14 Backup/Restore Reconfiguration Operations
Target host:
Initial Status
For each host of the ROC, the machine is running and a root session is available.
Execution Time
It takes about 10 minutes to perform these steps on each host of the ROC.
Procedure
Step Action
1. From the Primary Main Server, launch the update network pre-checks.
Under a root session, enter the next command:
(root) # /opt/nortel/shell/iut_tools/network_updater/iut_launchrocchecknetworkupdate.sh
-Y
For example:
Note: To perform the update, the result of the previous command must be OK!
--End--
Troubleshooting
If these checks failed because a machine that is not belonging to the ROC is unreachable:
• Remove this machine from file /etc/hosts
• Perform the following command:
(root) # /opt/nortel/shell/iut_tools/network_updater/iut_launchrocchecknetworkupdate.sh –Y
–restart
For example:
Each error that appears during these checks has to be corrected one by one before the update.
These checks MUST be performed again after correction and procedure cannot be resumed unless
checks are passed without any errors.
Final Status
The network update can be launched.
Initial Status
The OAM server is running and a root session is available.
Execution Time
It takes about 1 minute to perform this step.
Procedure
Step Action
--End--
Final Status
The IP Filter is deactivated.
Initial Status
The machine is running and a root session is available.
The OS-Hardening feature must be activated.
Execution Time
It takes about 30 minutes to perform these steps.
Procedure
Step Action
where
• <Package Name> can be:
— NNoshmai if server (Primary or secondary)
— NNoshcli if client
• <Version> is the UMTS version
• <Server Type> can be: 'Main' on a Primary or Secondary Main Server
Following steps must be executed only if your system is HARDENED (i.e. the previous
command result is equal to "The system is hardened with configuration …")
{0} ok boot -s
When the server reboots in single user mode, under a root login, launch the following commands:
(root)#montall
(root)# /SECURITY/<Package Name>/bin/Solaris OsUnHarden -p <Package Name>
where
• <Package Name> can be:
— NNoshmai if server (Primary or secondary)
— NNoshcli if client
(root)#init 6
--End--
Final Status
The OS-Hardening feature is deactivated on each server of the ROC.
Initial Status
The OAM server is running and a root session is available.
Execution Time
It takes about 5 minutes to perform these steps.
Procedure
Step Action
2. Modify the new default router configuration file, under a root session:
(root) # vi defaultrouter-new
For example:
Note: Be Careful: Do not edit the current default router configuration file.
Tips: As this file can contain several IP addresses, the operator can keep the old gateway entries
--End--
Final Status
The new default router configuration file is created.
Initial Status
The OAM servers are running and a root session is available.
Execution Time
It takes about 10 minutes to perform these steps.
Requirements
IPMP groups (OAM_OAM, OAM_BKP and OAM_NE) require 3 IP addresses (2 IP test addresses +
1 IP data address) for each of them.
All IP addresses, which are part of a same group, must belong to the same subnet, so in case of a
subnet change on one IPMP group, ask 3 IP addresses for the IPMP group on the new subnet.
In case of subnet change on OAM_OAM group with a SF4800, ask 1 IP address for each T3 on the
new OAM_OAM group subnet. (T3 must be in the OAM_OAM group subnet).
In case of subnet change on OAM_OAM group with a SF4900-SE6120, ask 1 IP address for SE6120
disks arrays on the new OAM_OAM group subnet. (The SE6120 must be in the OAM_OAM group
subnet).
In case of subnet change on OAM_OAM group with a SF4900-ST6140, ask 2 IP address for ST6140
disks arrays on the new OAM_OAM group subnet. (The ST6140 must be in the OAM_OAM group
subnet).
Procedure
Step Action
1. Copy the original ROC configuration to the new ROC configuration file.
Under a root session:
(root) # cd /opt/nortel/config/iut_tools/roc
(root) # cp iut_rocconfig.cfg new_rocconfig.cfg
For example
5. Check the network parameters change between the new and the old ROC configuration files.
Under a root session, enter the next command:
(root) # /opt/nortel/shell/iut_tools/network_updater/iut_checknetworkupdate.sh -roc -L
/opt/nortel/logs/iut_tools/iut_networkupdate.log
For example:
Note: Be Careful: To perform the update, the result of the previous command must be OK. In
case of error, check the new_rocconfig.cfg file content and perform again the step 4.
Note: Where Remote Server Name = name of the server where the file must be copied to.
--End--
Final Status
The new ROC configuration file is created.
Initial Status
A terminal session is available. All operations are managed from this terminal session.
Execution Time
It takes about 10 minutes to perform these steps.
Requirements
In the next sections, 'SSC_Hostname' (respectively 'SSC_IPAddress') stands for the current name
(respectively IP Address) of the Spare System Controller (SSC).
Procedure
Step Action
1. On a session, enter:
4. If the previous command does not display the 'SC Failover: enabled and active' message, you
can skip this step.
• Connect on the master System Controller: Under the monitor prompt, enter:
Note: If the previous command does not display the 'SC Failover: enabled and active'
message, please call your Alcatel-Lucent Regional Support Center.
--End--
Final Status
The network reconfiguration of the Spare System Controller is done.
Initial Status
The machine is running and a root session is available on the system console
Execution Time
It takes about 10 minutes to perform these steps.
Procedure
Step Action
• If a graphical environment is used (CDE for instance), you must skip it and switch to the
console mode. Under a terminal session, enter
# svcadm disable –t gdm2-login
For example:
2. On the system console of the OAM Server, check that this is really a system console:
The network reconfiguration process is finished when the following message is displayed:
Note: On the SF4800/4900 servers, the following error messages might appear on the
console if the network parameters are modified on the disk arrays. Those messages can safely
be ignored as there is no operational impact on the procedure.
Note: The operator must be connected on the system console. Otherwise the current terminal
is disconnected during the process and the user has to log on the system console to look at
the final result. The operator cannot use the graphic environment.
Note: The "init 5" command leads to an electric shutdown on the server machine, except on
SF4800/4900 platforms.
--End--
Troubleshooting
• If the reconfiguration process exits with the NOK status
To resume the reconfiguration process, perform the following steps on each failed server:
— Look for error message(s) in the log file to find the problem(s).
— Fix the problem (call your Alcatel-Lucent Regional Support Center if you cannot fix the
problem by yourself).
— Resume the reconfiguration process with the following command:
(root) # /opt/nortel/shell/iut_tools/common/iut_engine.sh -v -f
/opt/nortel/config/iut_tools/module/iut_networkupdatemanager.xml -L
/opt/nortel/logs/iut_tools/iut_networkupdate.log
For example:
• If you meet problems that you cannot resolve by yourself, call your Alcatel-Lucent Regional
Support Center.
Final Status
The network reconfiguration process is done.
The user can change the hardware with the next sheet.
Initial Status
The network reconfiguration process is done and a system console is available on every OAM
servers.
Execution Time
The duration of the hardware reconfiguration (for example 'Wiring') depends on the hardware.
The OAM applications reconfiguration takes about 120 minutes.
Procedure
Step Action
• If the IP addresses of the T3/SE6120 disks arrays are changed or if the disks arrays must be
moved, power them off.
• If the server is not a SF4800/4900, power it off and start wiring phase, for example:
— Unplug servers.
— Move machines (including UPS and T3/SE6120/ST6140).
— Change network hardware.
— Configure network hardware.
— Plug back servers.
• If the server is a SF4800/4900, you must apply the actions described in the sheet Special
Operations for the Sun Fire 4800/4900 before going to the next action.
• If the server is a Netra 240, you must apply the actions described in the sheet Special
Operations for the Netra 240 before going to the next action.
2. When the hardware reconfiguration is done, you must power on all OAM servers.
Note: Do not use the logical IP Address of the System Controller cards.
Note: This command may take several minutes (especially when there are some network
problems), do not proceed with the next steps if the previous command is not successful on all
the servers
4. On the Primary Main Server, under a root session, run the following command to synchronize the
ROC configuration across all the servers:
(root) # /opt/nortel/shell/iut_tools/common/iut_addmachineinroc.sh -export
-L /opt/nortel/logs/iut_tools/iut_networkupdate.log
For example:
Note: During the Network reconfiguration, several SAML and SMC error messages are
displayed on the console. Do not pay attention to those exception messages until the Network
reconfiguration is finished.
6. After PMS reboot, wait for the reconfiguration process completion before doing anything else on
other servers.
The following message can be found in the logs file on the PMS at the end of the configuration
process:
Then, on each other ROC server, under a root session, type the following command:
root) # /opt/nortel/shell/iut_tools/common/iut_engine.sh –v –f
/opt/nortel/config/iut_tools/module/iut_networkupdatemanager.xml –continue
For example:
This command will lead the server to reboot. At the end of the reconfiguration process, the same
messages as above can be found in the logs file on each server.
7. After the end of reconfiguration process, login on the Primary Main Server and launch the SMC
console.
Check the OAM platform hardware and software components.
(root) # /opt/SUNWsymon/sbin/es-start –c
For example
--End--
Troubleshooting
• Troubleshooting for action 2:
If the IP address of the T3/SE6120/ST6140 disks arrays is being changed, the following error
message may appear on the server's console when rebooting:
To resume normally the boot process, log on the server's console and type the following command:
/opt/nortel/config/iut_tools/module/iut_networkupdatemanager.xml -L
/opt/nortel/logs/iut_tools/iut_networkupdate.log -continue
For example:
If some processes on the secondary main server are not started (for example: fmbb, tumsbb, or hfb),
then connect to the Secondary Main Server.
Edit the following file and update the hostname of the SMS:
(root) # vi /opt/nortel/config/applications/security/isclient/is_auth.conf
For example:
Edit the following file and update the hostname of the SMS:
(root) # vi /opt/nortel/config/applications/security/isclient/is_client.env
For example:
Final Status
The network reconfiguration is done.
Initial Status
The system console displays now the Open Boot Prom (OBP) prompt.
Execution Time
It takes about 10 minutes to perform these steps.
Prerequisites
In the next sections, for the parameters of the Main System Controller (SC):
• 'SC_Hostname' stands for the current name
• 'SC_IPAddress' stands for the IP Address.
Procedure
Step Action
Note: Do not use the logical IP Address of the System Controller cards.
If the network reconfiguration does not include the System Controller, you can skip the next three
steps.
• <new_Secondary_DNS_Server>
• <new_SNTP_Server>
6. If the SF4800/4900 needs to be moved, apply the procedure for stopping the machine.
Here is a summary of the procedure:
Note: Do not use the logical IP Address of the System Controller cards
12. Enable the auto-boot PROM variable. On the system console with the OBP prompt, enter:
{ok} setenv auto-boot? true
For example:
--End--
Final Status
The network reconfiguration of the System Controller is done
Initial Status
The system console displays now the OBP prompt.
Execution Time
It takes about 10 minutes to perform these steps.
Prerequisites
In the next sections, for the parameters of the System Controller (SC):
• 'SC_Hostname' stands for the current name,
• 'SC_IPAddress' stands for the IP Address,
• 'SC_Netmask' stands for the Netmask,
• 'SC_Router' stands for Router IP Address.
If the network reconfiguration does not include the System Controller, you can go back to the sheet
Reconfigure the Network Hardware.
Procedure
Step Action
4. If the Netra 240 needs to be moved, you have to apply the procedure for stopping the machine.
Now, go back to the sheet Reconfigure the Network Hardware.
--End--
Final Status
The network reconfiguration of the System Controller is done.
Initial Status
The OAM server is running and a root session is available.
Execution Time
It takes about 1 minute to perform this step.
Procedure
Step Action
--End--
Final Status
The IP Filter is activated.
Initial Status
The machine is running and a root session is available.
The OS-Hardening feature needs to be re-activated.
Execution Time
It takes about 30 minutes to perform these steps.
Procedure
Step Action
where:
• <Version> is the UMTS version,
• <Level> is the installed patch level.
Following steps must be executed only if your system is not HARDENED (i.e. the previous
command result is equal to "The system is not hardened") and if this feature was
deactivated in a previous step.
When the server reboots in single user mode, under a root session, launch the following
command:
(root) # /SECURITY/*osh*/bin/Solaris_OsHarden –p NNosh<tag>
where:
• <tag> = mai if on PrimaryMainServer or SecondaryMainServer
• <tag> = srs if on SRSServer
• <tag> = cli if on Client
For example:
--End--
Final Status
The system is hardened.
Initial Status
The machine is running and, for UNIX clients a root session is available.
Execution Time
It takes about 10 minutes per client to perform these steps.
Procedure
Step Action
2. Reconfigure PC clients.
Refer to the document [R2] section PC installation
• Installing JRE and JNLP for NSP
• Configuring the SRI
--End--
Final Status
The PC/UNIX clients can connect to the OAM servers.
Initial Status
The machines are running and a root session is available.
The document [R4] is available.
Execution Time
It takes about 30 minutes to perform these steps.
Procedure
Step Action
4. Reconfigure the backup class for each OAM server on the B&R server.
Refer to the document [R4].
--End--
Final Status
The B&R server and clients reconfiguration is done.
Initial Status
The machines are running and a root session is available.
Document [R1] UMTS UA06.0 DHCP Activation in a service UTRAN Installation Method 30-0234 is
available.
Execution Time
It takes about 30 minutes to perform these steps.
Note: This procedure applies for each subnet address (from the list of subnet addresses of the
DHCP client).
Procedure
Step Action
2. DHCP Commissioning
1. On the Main Server, configure the DHCP tabs.
Type the following command, under a root login:
Example:
# /opt/nortel/shell/iut_tools/common/iut_dhcpconfiguration.sh –add –S<Subnet
DHCP Client> -N<Netmask DHCP Client> -R<IP@aggragation point > -I<Start
DHCPIP> -n<IP Address Number> -i<InterfaceNumberList>
2. Make sure that your DHCP Client machines are reachable by editing the /etc/defaultrouter file
and/or the S97 router one.
Type the following commands:
Example:
# route add net <Subnet DHCP Client> <Gateway Ip Address>
# echo "route add net <Subnet DHCP Client>< Gateway IpAddress>"
>>/etc/rc2.d/S97qferouter
There are two cases:
— Or there is a direct connection (HUB, switchether), then <Gateway IP@> is equal to
RNC-IN IP@>.
— Or there is no direct connection, then <GatewayIPAddress> is equal to the first router in
the path.
3. Check the DHCP parameters, type the following command:
Example:
# /usr/sbin/dhtadm –P
See Example of DHCP parameters below for more details.
4. Restart the DHCP, type the following commands:
Example:
# /etc/init.d/dhcp stop
# /etc/init.d/dhcp start
Figure 1 Example of DHCP parameters
Note: 1-NodeB Port = 18 157 means: nodeb port = 6301 (6301 converted to hexadecimal
=189D, 18 stay 18 and 9D is converted to decimal 9D = 157)
Note: 2-OAM Number = 01 means: 1 oam number (01)
Note: 3-OAM IP Address= 47.164.97.104 means oam IP address, it corresponds to the qfe2
or ce1 (depending the hardware configuration of the MAIN server)
Note: 4-OAM Port = 18 157 means: oam port = 6301 (6301 converted to hexadecimal =189D,
--End--
Final Status
The DHCP server reconfiguration is done.
Abbrevations
• 9353 WMS Alcatel-Lucent 9353 Management System
• OAM Operation, Administration and Maintenance
• ROC Regional Operational Center
• PMS Primary Main Server
• B&R Backup and Restore
• SRS Software Repository Server
• UPS Uninterruptible Power Supply
• NSP Network Services Platform
• CDROM Compact Disc Read Only Memory
• SSC Spare System Controller
• SMC Sun Management Center
• RTS Redundant Transfer Switch
• GUI Graphical User Interface
• DHCP Dynamic Host Configuration Protocol
• UMTS Universal Mobile Telecommunications System
• SF4800 SunTM FireTM 4800 Server
• SF4900 SunTM FireTM 4900 Server
• ST6140 SunTM StorageTekTM 6140 Array
• T3 SunTM T3 StorEdge
Definitions
Main Server
SUN server providing coresident CM, FM, PM real-time for Access, Circuit Core and Packet
Core Networks.
Fallback
It consists in getting back to your original configuration (before network update)
UNCONTROLLED COPY: The master of this document is stored on an electronic database and is "write protected"; it may be altered
only by authorized persons. While copies may be printed, it is not recommended. Viewing of the master electronically ensures access
to the current issue. Any hardcopies taken must be regarded as uncontrolled copies.
ALCATEL-LUCENT CONFIDENTIAL: The information contained in this document is the property of Alcatel-Lucent. Except as
expressly authorized in writing by Alcatel-Lucent, the holder shall keep all information contained herein confidential, shall disclose the
information only to its employees with a need to know, and shall protect the information from disclosure and dissemination to third
parties. Except as expressly authorized in writing by Alcatel-Lucent, the holder is granted no rights to use the information contained
herein. If you have received this document in error, please notify the sender and destroy it immediately.
Alcatel-Lucent, Alcatel, Lucent Technologies and their respective logos are trademarks and service marks of Alcatel-Lucent, Alcatel
and Lucent Technologies.