Nastar Command Reference(V600R010_07)(PDF)-En

NastarV600R010

Command Reference

Issue 07Date 2013-07-30

HUAWEI TECHNOLOGIES CO., LTD.

Copyright Huawei Technologies Co., Ltd. 2013. All rights reserved.No part of this document may be reproduced or transmitted in any form or by any means without prior writtenconsent of Huawei Technologies Co., Ltd. Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.All other trademarks and trade names mentioned in this document are the property of their respective holders. NoticeThe purchased products, services and features are stipulated by the contract made between Huawei and thecustomer. All or part of the products, services and features described in this document may not be within thepurchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information,and recommendations in this document are provided "AS IS" without warranties, guarantees or representationsof any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in thepreparation of this document to ensure accuracy of the contents, but all statements, information, andrecommendations in this document do not constitute a warranty of any kind, express or implied. Huawei Technologies Co., Ltd.Address: Huawei Industrial Base

Bantian, LonggangShenzhen 518129People's Republic of China

Website: http://www.huawei.comEmail: [email protected]

Issue 07 (2013-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.

i

About This Document

OverviewThis document describes commands that are used when you use Huawei devices to deploy andmaintain network.For advanced maintenance commands used to locate problems in some faulty scenarios wherethe regular maintenance methods cannot locate problem and commands that cannot be executedmanually by users, the device may contain errors or the service may be interrupted if these twokinds of commands are incorrectly used. If you need these two kinds of commands, apply toHuawei for required documents.

Product VersionThe following table lists the product versions related to this document.

Product Name Product VersionNastar V600R010

Intended AudienceThis document is intended for network management engineers.

Change HistoryIssue 07 (2013-07-30)

This is the seventh commercial release.

Issue 06 (2013-04-30)This is the sixth commercial release.

NastarCommand Reference About This Document


ii

Issue 05 (2013-03-12)This is the fifth commercial release.

Issue 04 (2013-02-05)This is the fourth commercial release.

Issue 03 (2012-10-12)This is the third commercial release.

Issue 02 (2012-07-20)This is the second commercial release.

Issue 01 (2012-05-15)This is the first commercial release.

Issue Draft C (2012-04-30)This is the third release for the beta test.

Issue Draft B (2012-03-31)This is the second release for the beta test.

Issue Draft A (2012-02-15)This is the first release for the beta test.

NastarCommand Reference About This Document


iii

Contents

About This Document.....................................................................................................................ii1 Nastar Command...........................................................................................................................11.1 start_svc..........................................................................................................................................................................41.2 stop_svc..........................................................................................................................................................................51.3 kill_svc............................................................................................................................................................................61.4 svc_adm -cmd status.......................................................................................................................................................71.5 svc_adm -cmd start.........................................................................................................................................................91.6 svc_adm -cmd stop.......................................................................................................................................................101.7 svc_adm -cmd restartsvc..............................................................................................................................................111.8 svc_adm -cmd startsvc..................................................................................................................................................121.9 svc_adm -cmd stopsvc..................................................................................................................................................131.10 start_daem...................................................................................................................................................................141.11 stop_daem...................................................................................................................................................................151.12 kill_daem....................................................................................................................................................................171.13 displayVersion............................................................................................................................................................181.14 svc_ps.........................................................................................................................................................................191.15 svc_profile.sh..............................................................................................................................................................191.16 delete_oracle_db.sh....................................................................................................................................................201.17 ChangeIP.sh................................................................................................................................................................211.18 send_messages_loghost_linux.sh...............................................................................................................................231.19 cmd_setupchs.sh.........................................................................................................................................................231.20 cmd_setupchs_offline.sh............................................................................................................................................241.21 cmd_setupeng.sh.........................................................................................................................................................251.22 cmd_setupeng_offline.sh............................................................................................................................................261.23 offline_mode.sh..........................................................................................................................................................271.24 setupchs.sh..................................................................................................................................................................281.25 setupchs_offline.sh.....................................................................................................................................................291.26 setupeng.sh.................................................................................................................................................................301.27 setupeng_offline.sh.....................................................................................................................................................311.28 silent_setupchs.sh.......................................................................................................................................................321.29 silent_setupchs_offline.sh...........................................................................................................................................331.30 silent_setupeng.sh.......................................................................................................................................................34

NastarCommand Reference Contents


iv

1.31 silent_setupeng_offline.sh..........................................................................................................................................351.32 uninstallchs.sh.............................................................................................................................................................361.33 uninstalleng.sh............................................................................................................................................................371.34 update_PCServer.sh....................................................................................................................................................381.35 update_ATAE.sh........................................................................................................................................................392 eSAU Commands.........................................................................................................................412.1 esau_start......................................................................................................................................................................422.2 esau_stop......................................................................................................................................................................422.3 esau_kill........................................................................................................................................................................432.4 esau_ps..........................................................................................................................................................................442.5 esau_version.................................................................................................................................................................442.6 svc_profile.sh................................................................................................................................................................453 LTE SAU Commands..................................................................................................................473.1 ran_start........................................................................................................................................................................483.2 ran_stop........................................................................................................................................................................483.3 ran_kill..........................................................................................................................................................................493.4 ran_ps............................................................................................................................................................................503.5 ran_version...................................................................................................................................................................503.6 svc_profile.sh................................................................................................................................................................514 Operating System Commands..................................................................................................534.1 Files and Directories.....................................................................................................................................................554.1.1 cd...............................................................................................................................................................................554.1.2 chgrp..........................................................................................................................................................................554.1.3 chmod........................................................................................................................................................................564.1.4 chown.........................................................................................................................................................................584.1.5 cp...............................................................................................................................................................................594.1.6 ls.................................................................................................................................................................................594.1.7 mkdir..........................................................................................................................................................................614.1.8 mv..............................................................................................................................................................................624.1.9 pwd............................................................................................................................................................................624.1.10 rm.............................................................................................................................................................................624.1.11 rmdir........................................................................................................................................................................634.2 Backup and Compression.............................................................................................................................................644.2.1 compress....................................................................................................................................................................644.2.2 gtar.............................................................................................................................................................................644.2.3 gzip............................................................................................................................................................................664.2.4 pack............................................................................................................................................................................664.2.5 tar...............................................................................................................................................................................674.2.6 uncompress................................................................................................................................................................694.2.7 unpack........................................................................................................................................................................69



v

4.3 File View and Modification..........................................................................................................................................704.3.1 cat...............................................................................................................................................................................704.3.2 clear...........................................................................................................................................................................704.3.3 diff.............................................................................................................................................................................714.3.4 echo............................................................................................................................................................................724.3.5 grep............................................................................................................................................................................734.3.6 head............................................................................................................................................................................744.3.7 less.............................................................................................................................................................................744.3.8 more...........................................................................................................................................................................754.3.9 tail..............................................................................................................................................................................764.3.10 vi..............................................................................................................................................................................774.4 Account Management...................................................................................................................................................794.4.1 groupadd....................................................................................................................................................................794.4.2 groupdel.....................................................................................................................................................................794.4.3 groupmod...................................................................................................................................................................794.4.4 passwd.......................................................................................................................................................................804.4.5 useradd.......................................................................................................................................................................804.4.6 userdel........................................................................................................................................................................824.4.7 usermod.....................................................................................................................................................................824.5 Find and Help...............................................................................................................................................................834.5.1 find.............................................................................................................................................................................834.5.2 man............................................................................................................................................................................854.5.3 whereis.......................................................................................................................................................................864.5.4 which.........................................................................................................................................................................874.6 System Information......................................................................................................................................................884.6.1 date.............................................................................................................................................................................884.6.2 df................................................................................................................................................................................894.6.3 du...............................................................................................................................................................................904.6.4 hostname....................................................................................................................................................................914.6.5 prtconf........................................................................................................................................................................924.6.6 uname.........................................................................................................................................................................954.6.7 who............................................................................................................................................................................964.7 Process-Related............................................................................................................................................................964.7.1 kill..............................................................................................................................................................................964.7.2 prstat..........................................................................................................................................................................984.7.3 ps................................................................................................................................................................................984.7.4 top..............................................................................................................................................................................994.8 Network Communications..........................................................................................................................................1004.8.1 finger........................................................................................................................................................................1004.8.2 ftp.............................................................................................................................................................................1014.8.3 ifconfig.....................................................................................................................................................................103



vi

4.8.4 netstat.......................................................................................................................................................................1054.8.5 ping..........................................................................................................................................................................1074.8.6 route.........................................................................................................................................................................1074.8.7 telnet........................................................................................................................................................................1114.9 Other Common Commands........................................................................................................................................1124.9.1 bc.............................................................................................................................................................................1124.9.2 script........................................................................................................................................................................1124.9.3 pkgadd.....................................................................................................................................................................1134.9.4 pkgrm.......................................................................................................................................................................114



vii

1 Nastar CommandAbout This Chapter

This section describes the functions and usage of common commands related to Nastar services.The Nastar system maintenance commands are saved in the server installation directory. Beforerunning Nastar commands, ensure that database services function normally and that the Nastarenvironment setting script svc_profile.sh is executed.

1.1 start_svcThis section describes the command for starting Nastar daemons and service processes.1.2 stop_svcThis section describes the command for stopping all Nastar service processes on the masterboard.1.3 kill_svcThis section describes the command for terminating all Nastar service processes.1.4 svc_adm -cmd statusThis section describes the command for viewing the running status of Nastar services.1.5 svc_adm -cmd startThis section describes the command for starting all Nastar services.1.6 svc_adm -cmd stopThis section describes the command for stopping all Nastar services.1.7 svc_adm -cmd restartsvcThis section describes the command for restarting a Nastar service.1.8 svc_adm -cmd startsvcThis section describes the command for starting a Nastar service.1.9 svc_adm -cmd stopsvcThis section describes the command for stopping a Nastar service.1.10 start_daemThis section describes the command for starting Nastar daemons.1.11 stop_daem

NastarCommand Reference 1 Nastar Command


1

This section describes the command for stopping all Nastar daemons on the master board.1.12 kill_daemThis section describes the command for terminating all Nastar processes.1.13 displayVersionThis section describes the command for viewing the version information of the current Nastarserver.1.14 svc_psThis section describes the svc_ps command for viewing the running status of Nastar serviceprocesses and the user authorized to run this command. It also provides an example to explainthe application scenario of this command.1.15 svc_profile.shThis section describes the function, save path, and method of executing the svc_profile.sh script.Before running commands on the Nastar server, you must execute the svc_profile.sh script toset the environment variables.1.16 delete_oracle_db.shThis section describes the function, save path, and method of executing thedelete_oracle_db.sh script. You must execute the delete_oracle_db.sh script to delete thedatabase.1.17 ChangeIP.shThis section describes the function, save path, and execution method of the ChangeIP.sh script.You must execute the ChangeIP.sh script to change the IP address of the server.1.18 send_messages_loghost_linux.shThis section describes the function, save path, and method of executing thesend_messages_loghost_linux.sh script. You must execute thesend_messages_loghost_linux.sh script to run the command for forwarding Nastar logs.1.19 cmd_setupchs.shThis script enables you to install the Nastar (Chinese version) in CLI mode.1.20 cmd_setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in CLI mode.1.21 cmd_setupeng.shThis script enables you to install the Nastar (English version) in CLI mode.1.22 cmd_setupeng_offline.shThis script enables you to install the Nastar (offline English version) in CLI mode.1.23 offline_mode.shThis script enables you to switch the Nastar from the online mode to the offline mode.1.24 setupchs.shThis script enables you to install the Nastar (Chinese version) in GUI mode.1.25 setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in GUI mode.1.26 setupeng.shThis script enables you to install the Nastar (English version) in GUI mode.1.27 setupeng_offline.sh



2

This script enables you to install the Nastar (offline English version) in GUI mode.1.28 silent_setupchs.shThis script enables you to install the Nastar (Chinese version) in static mode.1.29 silent_setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in static mode.1.30 silent_setupeng.shThis script enables you to install the Nastar (English version) in static mode.1.31 silent_setupeng_offline.shThis script enables you to install the Nastar (offline English version) in static mode.1.32 uninstallchs.shThis script enables you to uninstall the Nastar (Chinese version).1.33 uninstalleng.shThis script enables you to uninstall the Nastar (English version).1.34 update_PCServer.shThis script enables you to upgrade the Nastar deployed on the server.1.35 update_ATAE.shThis script enables you to upgrade the Nastar deployed on the Advanced TelecommunicationsApplication Environment (ATAE) cluster system.



3

1.1 start_svcThis section describes the command for starting Nastar daemons and service processes.

Syntaxstart_svc

DescriptionNone.

Function1. Application scenario

This command is used for routine maintenance and troubleshooting.2. Function

This command is used to start all the daemons and service processes of the Nastar. If thesystem is started, this command attempts to restart all the services and notifies you of therestart.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.l The operating system and database are running properly.l The TAO Naming Service and TAO Notification Service are configured correctly.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

Precautionsl In an SLS system, you must start services in sequence. Run the start_svc command on the

master board and then run the start_svc command on the slave board.l When you run the start_svc command to start Nastar services, the start_svc command

calls the testDB script to check whether the database is running. If the database is notrunning, the shell window displays a message indicating the database status.

l When you run the start_daem and svc_adm -cmd start commands to start Nastar services,the commands do not call the testDB script to check whether the database is running. If thedatabase is not running, no message is displayed and certain database-dependent servicescannot be started.

Related Commandsl start_svc.

This command is used to start Nastar service processes.



4

l stop_svc.This command is used to stop Nastar service processes.

l kill_svc.This command is used to terminate Nastar service process.

Example# start_svcA message similar to the following is displayed:============================ Starting Daem...============================ Finished starting the daemon.......LogService..........................runningMaintenanceService..................runningMediationService0101................running......------------cost: 1(sec)------------svc_adm : info : START finished !============================ Finished starting the system.

1.2 stop_svcThis section describes the command for stopping all Nastar service processes on the masterboard.

Syntaxstop_svc

DescriptionNone.



This command is used to stop all Nastar service processes on the master board. If theNastar system is not started, this command attempts to stop all Nastar service processesand displays error messages.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.l The operating system and database are running properly.l The TAO Naming Service and TAO Notification Service are configured correctly.



5

l In the Linux operating system, the svc_profile.sh script is executed and the environmentvariables are set.

Precautionsl In an SLS system, you must start services in sequence. Run the start_svc command on the

master board and then run the start_svc command on the slave board.l To stop all Nastar services, you must run the stop_daem command to stop all Nastar

daemons after running the stop_svc command to stop Nastar service processes. Otherwise,the imapsysd process automatically starts certain processes.


This command is used to start Nastar service processes.l stop_svc.

This command is used to stop Nastar service processes.l kill_svc.

This command is used to terminate Nastar service process.

Example# stop_svcA message similar to the following is displayed:============================ Stopping the service.........LogService..........................stoppedMaintenanceService..................stoppedMediationService0101................stopped......------------cost: 11(sec)------------svc_adm : info : STOP finished !============================ Finished stopping the service.

1.3 kill_svcThis section describes the command for terminating all Nastar service processes.

Syntaxkill_svc

DescriptionNone.




6

You are advised not to terminate Nastar service processes. Perform this operation onlywhen the processes are hung or abnormal.

2. FunctionThis command is used to terminate all Nastar service processes of the Nastar.

Prerequisitesl You have logged in to the server as user omcuser.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

Precautionsl Usually, you can run the stop_svc command to stop Nastar service processes.l Running this command might cause Nastar service data loss or abnormal services. Exercise

caution when running this command to stop Nastar service processes.


This command is used to start Nastar service processes.l stop_svc.

This command is used to stop Nastar service processes.l kill_svc.

This command is used to terminate Nastar service process.

ExampleRun the following command to terminate all Nastar service processes:# kill_svc

1.4 svc_adm -cmd statusThis section describes the command for viewing the running status of Nastar services.

SyntaxFollowing are five methods for viewing the running status of Nastar services:l Run the following command to view the status of all Nastar services:

svc_adm -cmd statusl Run the following command to view the status of one Nastar service in the configuration

file:svc_adm -cmd status -svcname svc_name

l Run the following command to view the status of all Nastar services under a system agentin the configuration file:



7

svc_adm -cmd status -sysagent sys_agent_namel Run the following command to view the status of one Nastar service under a system agent

in the configuration file:svc_adm -cmd status -svcagent svc_agent_name -sysagent sys_agent_name

l Run the following command to view the status of one Nastar service under a service agentin the configuration file:svc_adm -cmd status -svcagent svc_agent_name -svcname svc_name

DescriptionNone.


This command is used for routine maintenance.2. Function

This command is used to view the running status of all Nastar services.

Authorized UserThis command is run by user omcuser.

Prerequisitesl You have logged in to the server as user omcuser.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.l Table 1-1 lists the command parameters.

Table 1-1 Command parametersParameter Parameter Name Mandatory/Optional-svcagent svc_agent_name Optional-svcname svc_name Mandatory-sysagent sys_agent_name Optional

PrecautionsYou can query the parameters svc_agent_name, svc_name, and sys_agent_name from theconfiguration file saved in /opt/nastar/etc/conf.

Related CommandsNone.



8

Examplel Run the following command to view the status of all Nastar services:

# svc_adm -cmd statusThe status of Nastar services can be Running, or Not Running.

l Run the following command to view the status of one service under the Nastar systemmonitoring agent:# svc_adm -cmd status -svcagent svc_nameThe status of the service under the Nastar system monitoring agent can be Running, NoLicense, or Not Running.

l Run the following command to view the status of all data management services under theNastar system monitoring agent:# svc_adm -cmd status -svcname DataMgrServiceThe status of the data management services under the system monitoring agent can beRunning, No License, or Not Running.

1.5 svc_adm -cmd startThis section describes the command for starting all Nastar services.

Syntaxsvc_adm -cmd start

DescriptionNone.



This command is used to start all inactive Nastar services.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.l The TAO Naming Service and TAO Notification Service are running properly.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.



9

Precautionsl The sequence for starting services is determined by the dependency of each Nastar service.

After running this command, you can run the svc_adm -cmd status command to view therunning status of Nastar services.

l When you run the start_svc command to start Nastar services, the start_svc commandcalls the testDB script to check whether the database is running. If the database is notrunning, the shell window displays a message indicating the database status.



ExampleRun the following command to start all Nastar services:# svc_adm -cmd startAll Nastar services in the configuration file are started, and the status of the Nastar services isrunning.

1.6 svc_adm -cmd stopThis section describes the command for stopping all Nastar services.

Syntaxsvc_adm -cmd stop

DescriptionNone.



This command is used to stop all active Nastar services.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.



10

l The imapsysd process is started.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

PrecautionsThe sequence for stopping services is determined by the dependency of each Nastar service.


ExampleRun the following command to stop all Nastar services:# svc_adm -cmd stopAll Nastar services in the configuration file are stopped, and the status of the Nastar services isstopped.

1.7 svc_adm -cmd restartsvcThis section describes the command for restarting a Nastar service.

Syntaxsvc_adm -cmd restartsvc svc_name

NOTE

l svc_adm -cmd restartsvc is the command for restarting a service.l svc_name is the name of the service to be restarted.

DescriptionNone.



This command is used to restart a Nastar service based on the following procedure: stopthe Nastar service and the Nastar services which are dependent on it, restart the Nastarservice, and then restart the Nastar services which are dependent on it.

PrerequisitesThe prerequisites for running this command are as follows:



11

l You have logged in to the server as user omcuser.l The TAO Naming Service and TAO Notification Service are running properly.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

Precautions1. After running this command, you can run the svc_adm -cmd status command to check

whether the service is started.2. Before starting the service, confirm that the services on which it is dependent are started.

For details about the dependency of a service, refer to the dependency parameter in theconfiguration file for the service.


Examplel Run the following command to restart security services:

# svc_adm -cmd restartsvc SecurityServiceSecurity services are restarted, and the status of the security services is running.

l Run the following command to restart event services:# svc_adm -cmd restartsvc EventServiceEvent services are restarted, and the status of the event services is running.

1.8 svc_adm -cmd startsvcThis section describes the command for starting a Nastar service.

Syntaxsvc_adm -cmd startsvc svc_name

NOTE

l svc_adm -cmd startsvc is the command for starting a service.l svc_name is the name of the service to be started.

DescriptionNone.





12

This command is used to start a Nastar service and the Nastar services on which thisNastar service is dependent.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

Precautions1. After running this command, you can run the svc_adm -cmd status command to view the

running status of the service.2. Before starting the service, confirm that the services on which it is dependent are started.

For details about the dependency of a service, refer to the dependency parameter in theconfiguration file for the service.


Examplel Run the following command to start security services:

# svc_adm -cmd startsvc SecurityServiceSecurity services are started, and the status of the security services is running.

l Run the following command to start event services:# svc_adm -cmd startsvc EventServiceEvent services are started, and the status of the event services is running.

1.9 svc_adm -cmd stopsvcThis section describes the command for stopping a Nastar service.

Syntaxsvc_adm -cmd stopsvc svc_name

NOTE

l svc_adm -cmd stopsvc is the command for stopping a service.l svc_name is the name of the service to be stopped.

DescriptionNone.



13



This command is used to stop a Nastar service and the Nastar services which are dependenton it.


variables are set.

Precautionsl After running this command, you can run the svc_adm -cmd status command to view the

running status of the service.l After the service is stopped, the services which are dependent on it are also stopped. For

details about the dependency of a service, refer to the dependency parameter in theconfiguration file for the service.

l The DataMgrService service is stopped only after the backup is complete.


Examplel Run the following command to stop security services:

# svc_adm -cmd stopsvc SecurityServiceSecurity services are stopped, and the status of the security services is stopped.

l Run the following command to stop event services:# svc_adm -cmd stopsvc EventServiceEvent services are stopped, and the status of the event services is stopped.

1.10 start_daemThis section describes the command for starting Nastar daemons.

Syntaxstart_daem



14

DescriptionNone.



This command is used to start all Nastar daemons.


variables are set.l The operating system is running properly.l The TAO Naming Service and TAO Notification Service are configured correctly.l The Nastar services are running properly.

Precautionsl When you run the start_svc command to start Nastar services, the start_svc command

calls the testDB script to check whether the database is running. If the database is notrunning, the shell window displays a message indicating the database status.



Example# start_daemA message similar to the following is displayed:============================ Starting Daem...TAO Naming Service is running.TAO Notification Service is running.imapmrb is running!sysagent port is in use 31000, maybe imapsysd is running.============================ Finished Starting Daem

1.11 stop_daemThis section describes the command for stopping all Nastar daemons on the master board.



15

Syntaxstop_daem

DescriptionNone.



This command is used to stop all Nastar daemons on the master board.


variables are set.l The operating system is running properly.l The TAO Naming Service and TAO Notification Service are configured correctly.l The Nastar services are running properly.

PrecautionsBefore stopping all Nastar daemons, you must run the stop_svc or svc_adm -cmd stop commandto stop all service processes.


Example# stop_daemA message similar to the following is displayed:============================ Stopping Daem ...operation success!imapwatchdog stop success!

imapsysd : info : 10_70_148_36 stopped

stopping TAO Naming Service [OK ]stopping TAO Notification Service [OK ]============================ Finished Stopping Daem



16

1.12 kill_daemThis section describes the command for terminating all Nastar processes.

Syntaxkill_daem

DescriptionNone.


You are advised not to terminate Nastar processes. Perform this operation only when theprocesses are hung or abnormal.

2. FunctionThis command is used to terminate all Nastar processes of the Nastar.

Authorized UserThis command is run by user omcuser.


variables are set.

Precautionsl Usually, you can run the stop_svc command and then the stop_daem command to stop

Nastar processes.l Running this command might cause Nastar service data loss or abnormal services. Exercise

caution when running this command to stop Nastar processes.


ExampleRun the following command to terminate all Nastar processes:# kill_daem



17

1.13 displayVersionThis section describes the command for viewing the version information of the current Nastarserver.

SyntaxdisplayVersion

DescriptionNone.


This command is used to view the version information of the current Nastar server.2. Function

None.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user root.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

PrecautionsNone.


ExampleIf running this command succeeds, the system displays the version information of the currentNastar server, similar to the following:# displayVersion----------------Nastar Version------------Component Name: ********Version: V600R010Release Date: 10/22/09



18

1.14 svc_psThis section describes the svc_ps command for viewing the running status of Nastar serviceprocesses and the user authorized to run this command. It also provides an example to explainthe application scenario of this command.

Syntaxsvc_ps

DescriptionNone.


This command is used to view the running status of Nastar service processes.2. Function

None.

PrerequisitesThe prerequisites for running this command are as follows:l You have logged in to the server as user omcuser.l The TAO Naming Service and TAO Notification Service are running properly.l In the Linux operating system, the svc_profile.sh script is executed and the environment

variables are set.

PrecautionsNone.


Example# svc_psRun the command to view the running status of all active Nastar service processes.

1.15 svc_profile.shThis section describes the function, save path, and method of executing the svc_profile.sh script.Before running commands on the Nastar server, you must execute the svc_profile.sh script toset the environment variables.



19

SyntaxNone.

DescriptionNone.


Before running commands on the Nastar server, you must execute the svc_profile.sh script.This script sets the environment variables such as the command searching path and thedynamic library-searching path.

2. FunctionNone.

Save PathThe script is saved in /opt/nastar.

PrerequisitesYou have logged in to the server as user omcuser.

PrecautionsNone.


Example1. Log in to the server as user omcuser, and run the following command to access the save

path of the svc_profile.sh script.# cd /opt/nastar

2. Run the following commands to execute the script:# . ./svc_profile.sh

1.16 delete_oracle_db.shThis section describes the function, save path, and method of executing thedelete_oracle_db.sh script. You must execute the delete_oracle_db.sh script to delete thedatabase.



20

SyntaxNone.

DescriptionNone.


The delete_oracle_db.sh script is used to delete the database.2. Function

None.

Save PathThis script is saved in /home/operuser/Tools/linux.

PrerequisitesYou have logged in to the server as user root.

PrecautionsNone.


Example# . delete_oracle_db.sh

1.17 ChangeIP.shThis section describes the function, save path, and execution method of the ChangeIP.sh script.You must execute the ChangeIP.sh script to change the IP address of the server.

SyntaxNone.

DescriptionNone.



21


The ChangeIP.sh script is used to change the IP address of the server.2. Function

None.

Save PathThis script is saved in /opt/nastar/tools/tools_ip.

Prerequisitesl You have logged in to the server as user root.l You have checked that the IP address of the server is on eth0 or bond0 and that the remote

terminal has been connected.Following describes the steps for checking network interface cards (NICs):1. Run the ifconfig command to check the number of NICs and whether the NICs are

connected by using network cables.If the command output for an NIC contains RUNNING, the NIC is connected by usinga network cable. Status of an NIC that is not connected by using a network cable:

eth0UP BROADCAST MULTICAST MTU:1500 Metric:1 Status of an NIC that is connected by using a network cable:

eth0UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1

2. Run the ping command to check that the network is connected.For example, ping 10.144.199.1.If the network is not connected, check the network first to ensure that network isconnected before you change the IP address of the server.

PrecautionYou can change only the IP address on eth0 or bond0. For the IP address on any other NIC, youmust change it manually.


Example# . ChangeIP.sh



22

1.18 send_messages_loghost_linux.shThis section describes the function, save path, and method of executing thesend_messages_loghost_linux.sh script. You must execute thesend_messages_loghost_linux.sh script to run the command for forwarding Nastar logs.

SyntaxNone.

DescriptionNone.


The send_messages_loghost_linux.sh script is used to run the command for forwardingNastar logs.

2. FunctionNone.

Save PathThis script is saved in /bin.

PrerequisitesYou have logged in to the server as user root.

PrecautionsNone.


Example# . send_messages_loghost_linux.sh

1.19 cmd_setupchs.shThis script enables you to install the Nastar (Chinese version) in CLI mode.



23

SyntaxNone.

DescriptionNone.


To install the Nastar (Chinese version) in CLI mode, run this script.2. Function

None.

Save PathThe script is saved in the installation directory of the Nastar.

PrerequisitesThe current login user is root.

PrecautionsNone.


Example1. Use PuTTY to log in to the Server in SSH mode as user omcuser.2. Run the following command to switch to user root.

~> su - rootPassword:Password of root

3. Access the installation directory for the Nastar server.4. Run the following command to execute the script:

# ./cmd_setupchs.sh

1.20 cmd_setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in CLI mode.

SyntaxNone.



24

DescriptionNone.


To install the Nastar (offline Chinese version) in CLI mode, run this script.2. Function

None.



PrecautionsNone.





# ./cmd_setupchs_offline.sh

1.21 cmd_setupeng.shThis script enables you to install the Nastar (English version) in CLI mode.

SyntaxNone.

DescriptionNone.



25


To install the Nastar (English version) in CLI mode, run this script.2. Function

None.



PrecautionsNone.





# ./cmd_setupeng.sh

1.22 cmd_setupeng_offline.shThis script enables you to install the Nastar (offline English version) in CLI mode.

SyntaxNone.

DescriptionNone.



26


To install the Nastar (offline English version) in CLI mode, run this script.2. Function

None.



PrecautionsNone.





# ./cmd_setupeng_offline.sh

1.23 offline_mode.shThis script enables you to switch the Nastar from the online mode to the offline mode.

SyntaxNone.

DescriptionNone.



27


To switch the Nastar from the online mode to the offline mode, run this script.2. Function

None.



PrecautionsNone.





# ./offline_mode.sh

1.24 setupchs.shThis script enables you to install the Nastar (Chinese version) in GUI mode.

SyntaxNone.

DescriptionNone.



28


To install the Nastar (Chinese version) in GUI mode, run this script.2. Function

None.



PrecautionsNone.





# ./setupchs.sh

1.25 setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in GUI mode.

SyntaxNone.

DescriptionNone.



29


To install the Nastar (offline Chinese version) in GUI mode, run this script.2. Function

None.



PrecautionsNone.





# ./setupchs_offline.sh

1.26 setupeng.shThis script enables you to install the Nastar (English version) in GUI mode.

SyntaxNone.

DescriptionNone.



30


To install the Nastar (English version) in GUI mode, run this script.2. Function

None.



PrecautionsNone.





# ./setupeng.sh

1.27 setupeng_offline.shThis script enables you to install the Nastar (offline English version) in GUI mode.

SyntaxNone.

DescriptionNone.



31


To install the Nastar (offline English version) in GUI mode, run this script.2. Function

None.



PrecautionsNone.





# ./setupeng_offline.sh

1.28 silent_setupchs.shThis script enables you to install the Nastar (Chinese version) in static mode.

SyntaxNone.

DescriptionNone.



32


To install the Nastar (Chinese version) in static mode, run this script.2. Function

None.



PrecautionsNone.





# ./silent_setupchs.sh

1.29 silent_setupchs_offline.shThis script enables you to install the Nastar (offline Chinese version) in static mode.

SyntaxNone.

DescriptionNone.



33


To install the Nastar (offline Chinese version) in static mode, run this script.2. Function

None.



PrecautionsNone.





# ./silent_setupchs_offline.sh

1.30 silent_setupeng.shThis script enables you to install the Nastar (English version) in static mode.

SyntaxNone.

DescriptionNone.



34


To install the Nastar (English version) in static mode, run this script.2. Function

None.



PrecautionsNone.





# ./silent_setupeng.sh

1.31 silent_setupeng_offline.shThis script enables you to install the Nastar (offline English version) in static mode.

SyntaxNone.

DescriptionNone.



35


To install the Nastar (offline English version) in static mode, run this script.2. Function

None.



PrecautionsNone.





# ./silent_setupeng_offline.sh

1.32 uninstallchs.shThis script enables you to uninstall the Nastar (Chinese version).

SyntaxNone.

DescriptionNone.



36


To uninstall the Nastar (Chinese version), run this script.2. Function

None.


PrerequisitesThe current login user is omcuser.

PrecautionsNone.


Example1. Log in to the server as user omcuser.2. Access the installation directory for the Nastar server.3. Run the following command to execute the script:

# ./uninstallchs.sh

1.33 uninstalleng.shThis script enables you to uninstall the Nastar (English version).

SyntaxNone.

DescriptionNone.


To uninstall the Nastar (English version), run this script.2. Function



37

None.


PrerequisitesThe current login user is omcuser.

PrecautionsNone.


Example1. Log in to the server as user omcuser.2. Access the installation directory for the Nastar server.3. Run the following command to execute the script:

# ./uninstalleng.sh

1.34 update_PCServer.shThis script enables you to upgrade the Nastar deployed on the server.

SyntaxNone.

DescriptionNone.


To upgrade the Nastar deployed on the server, run this script.2. Function

None.

Save PathThe script is saved in the upgrade package directory of the Nastar.



38

Prerequisitesl The current login user is root.l The operating system (OS) and database are running properly.l Nastar processes have been stopped.

PrecautionsEnsure that the database is running properly and can be connected because the upgrade processinvolves database operations.

Related Commandsupdate_ATAE.sh: This script is used to upgrade the Nastar deployed on the AdvancedTelecommunications Application Environment (ATAE) cluster system.



3. Run the following command to execute the script:# ./update_PCServer.sh

1.35 update_ATAE.shThis script enables you to upgrade the Nastar deployed on the Advanced TelecommunicationsApplication Environment (ATAE) cluster system.

SyntaxNone.

DescriptionNone.


To upgrade the Nastar deployed on the ATAE cluster system, run this script.2. Function

None.

Save PathThe script is saved in the upgrade package directory of the Nastar.



39

Prerequisitesl The current login user is root.l The operating system (OS) and database are running properly.l Nastar processes have been stopped.

Precautionsl Use the operating system maintenance unit (OSMU) to stop primary and secondary services

of the Nastar before the upgrade.l Ensure that the database is running properly and can be connected because the upgrade

process involves database operations.

Related Commandsupdate_PCServer.sh: This script is used to upgrade the Nastar deployed on the server.



3. Run the following command to execute the script:# ./update_ATAE.sh



40

2 eSAU CommandsAbout This Chapter

This chapter provides the common commands related to eSAU services required for eSAUsystem operation. eSAU system maintenance commands are stored in the server installationdirectory.

2.1 esau_startThis section describes the command for starting eSAU service processes.2.2 esau_stopThis section describes the command for stopping eSAU service processes.2.3 esau_killThis section describes the command for forcibly stopping all eSAU service processes.2.4 esau_psThis section describes the command for checking the running status of eSAU services. Read thissection before you check the running status of eSAU services.2.5 esau_versionThis describes the command for viewing the version of the running eSAU software.2.6 svc_profile.shThis section describes the function, directory, and running method of the svc_profile.sh script.Before running eSAU commands, you must run the svc_profile.sh script to set the user operatingenvironment.

NastarCommand Reference 2 eSAU Commands


41

2.1 esau_startThis section describes the command for starting eSAU service processes.

Command Syntaxesau_start


This command is used for routine maintenance and troubleshooting.2. Example

This command is used to start all eSAU service processes.

Authorized UserThis command is executed by user omcuser.

PrerequisitesBefore you run this command, ensure that:l The operating system and database are running properly.l You have set environment variables by running the svc_profile.sh script on the SUSE linux

operating system.

Application Example# cd /opt/esau# . ./svc_profile.sh# esau_startStart all eSAU service processes.

2.2 esau_stopThis section describes the command for stopping eSAU service processes.

Command Syntaxesau_stop




42


This command is used to stop all eSAU service processes.


PrerequisitesBefore you run this command, ensure that:l The operating system and database are running properly.l You have set environment variables by running the svc_profile.sh script on the SUSE linux

operating system.

Application Example# cd /opt/esau# . ./svc_profile.sh# esau_stopStop all eSAU service processes.

2.3 esau_killThis section describes the command for forcibly stopping all eSAU service processes.

Command Syntaxesau_kill


You are advised not to forcibly stop eSAU service processes. If a process is suspended orabnormal, you can perform this operation.

2. ExampleForcibly stop all eSAU service processes.


PrerequisitesYou have set environment variables by running the svc_profile.sh script on the SUSE linuxoperating system.



43

Precautionsl Normally, you can run the esau_stop command to stop eSAU services.l If you run the esau_kill command, service data loss or service exceptions may occur.

Therefore, this command is the last resort to forcibly stopping eSAU services.

Application Example# cd /opt/esau# . ./svc_profile.sh# esau_killForcibly stop all eSAU service processes.

2.4 esau_psThis section describes the command for checking the running status of eSAU services. Read thissection before you check the running status of eSAU services.

Command Syntaxesau_ps

FunctionThis command is used to check the operating status of all eSAU services on the server.



Application Example# cd /opt/esau# . ./svc_profile.sh# esau_psThe operating status of all eSAU services is displayed as running or not running.

2.5 esau_versionThis describes the command for viewing the version of the running eSAU software.



44

Command Syntaxesau_version

FunctionThis command is used to view the version of the eSAU software running on the server.



Application Example# cd /opt/esau# . ./svc_profile.sh# esau_version------------------------eSAU Server --------------------------Component Name : eSAU ServerVersion : iManagerNastarESAUV600R010C00InstalledPath : /opt/esauReleaseVer : SUSE_X86_64_pkgInternalVersion : Sat Feb 25 16:36:51 CST 2012, revision 171323.

2.6 svc_profile.shThis section describes the function, directory, and running method of the svc_profile.sh script.Before running eSAU commands, you must run the svc_profile.sh script to set the user operatingenvironment.

Script Format. ./svc_profile.sh

FunctionBefore running eSAU commands, you can run the svc_profile.sh script to set the user operatingenvironment such as the command search path and dynamic library searching path.

Saving PathThis script is saved in the /opt/esau directory.

Authorized UsersUser omcuser is authorized to run this script.



45

ExampleLog in to the server as an authorized user and run the environment variable script.# cd /opt/esau# . ./svc_profile.sh



46

3 LTE SAU CommandsAbout This Chapter

This chapter provides the common commands related to LTE SAU services required for LTESAU software operation. LTE SAU maintenance commands are stored in the opt/ransaudirectory.

3.1 ran_startThis section describes the command for starting LTE SAU service processes.3.2 ran_stopThis section describes the command for stopping LTE SAU service processes.3.3 ran_killThis section describes the command for forcibly stopping all LTE SAU service processes.3.4 ran_psThis section describes the command for viewing LTE SAU service process status on the server.3.5 ran_versionThis describes the command for viewing the version of the running LTE SAU software.3.6 svc_profile.shThis section describes the function, directory, and running method of the svc_profile.sh script.Before running LTE SAU commands, you must run the svc_profile.sh script to set the useroperating environment.

NastarCommand Reference 3 LTE SAU Commands


47

3.1 ran_startThis section describes the command for starting LTE SAU service processes.

Command Syntaxran_start



This command is used to start all LTE SAU service processes.


PrerequisitesBefore you run this command, ensure that:l The operating system is running properly.l You have set environment variables by running the svc_profile.sh script on the SUSE linux

operating system.

Application Example# cd /opt/ransau# . ./svc_profile.sh# ran_startStart all LTE SAU service processes.

3.2 ran_stopThis section describes the command for stopping LTE SAU service processes.

Command Syntaxran_stop




48


This command is used to stop all LTE SAU service processes.


PrerequisitesBefore you run this command, ensure that:l The operating system is running properly.l You have set environment variables by running the svc_profile.sh script on the SUSE linux

operating system.

Application Example# cd /opt/ransau# . ./svc_profile.sh# ran_stopStop all LTE SAU service processes.

3.3 ran_killThis section describes the command for forcibly stopping all LTE SAU service processes.

Command Syntaxran_kill


You are advised not to forcibly stop LTE SAU service processes. If a process is suspendedor abnormal, you can perform this operation.

2. ExampleForcibly stop all LTE SAU service processes.





49

Precautionsl Normally, you can run the ran_stop command to stop LTE SAU services.l If you run the ran_kill command, service data loss or service exceptions may occur.

Therefore, this command is the last resort to forcibly stopping LTE SAU services.

Application Example# cd /opt/ransau# . ./svc_profile.sh# ran_killForcibly stop all LTE SAU service processes.

3.4 ran_psThis section describes the command for viewing LTE SAU service process status on the server.

Command Syntaxran_ps

FunctionThis command is used to check the operating status of all LTE SAU services on the server.



Application Example# cd /opt/ransau# . ./svc_profile.sh# ran_psThe operating status of all LTE SAU services is displayed as running or not running.

3.5 ran_versionThis describes the command for viewing the version of the running LTE SAU software.



50

Command Syntaxran_version

FunctionThis command is used to view the version of the LTE SAU software running on the server.



Application Example# cd /opt/ransau# . ./svc_profile.sh# ran_version------------------------SAU Server --------------------------Component Name : SAU ServerVersion : iManagerNastarRANSAUV600R010C00InstalledPath : /opt/ransauInternalVersion : Wed Feb 22 18:24:48 CST 2012,Revision: 170634

3.6 svc_profile.shThis section describes the function, directory, and running method of the svc_profile.sh script.Before running LTE SAU commands, you must run the svc_profile.sh script to set the useroperating environment.

Script Format. ./svc_profile.sh

FunctionBefore running LTE SAU commands, you can run the svc_profile.sh script to set the useroperating environment such as the command search path.

Saving PathThis script is saved in the /opt/ransau directory.

Authorized UsersUser omcuser is authorized to run this script.



51

ExampleLog in to the server as an authorized user and run the environment variable script.# cd /opt/ransau# . ./svc_profile.sh



52

4 Operating System CommandsAbout This Chapter

This chapter provides the reference to the common commands on the Solaris and Linux operatingsystems. The commands consist of files and directories commands, backup and compressioncommands, file view and modification, account management commands, find and helpcommands, system information commands, process-related commands, networkcommunication commands, and other common commands.

4.1 Files and DirectoriesThis section describes the reference of the Files and Directories common commands. Thissection also provides function descriptions and examples.4.2 Backup and CompressionThis section describes the functions of the commands used for backup and compression andprovides some application examples.4.3 File View and ModificationThis section describes the functions of the file view and modification and provides someapplication examples.4.4 Account ManagementThis section describes the functions of t

Documents

Nastar Command Reference(V600R010_07)(PDF)-En