acsadm_commands

Page 1 of 8
URL: http://uabweb.uab.ericsson.se/~etxjfp/BraAttHa/acsadm_commands.html Filemanager:~/home/etxjfp/public_html/BraAttHa/acsadm_commands.html

commands in acsadm
Extract from man-pages for commands in ACS. '***' after the description means that it is abbreviated, read the full description in the man-page. If there is just a - (dash) after the command, there is no man-page for the command (1998-02-12).

If you not are familiar with the command, read the man-page before using the command!
acsadm> man <command> acease - AP Alarms Ceasing The acease command is used by an operator to cease an alarm. It is especially used for those alarms issued by an application that does not have the possibility to know when the anomalous situation that caused the alarm will cease. acsinstall aehboot alist - AP Alarms Listing The alist command displays information about alarms in an AP. It is possible to get either the complete list of alarms or just the alarm records that match the criteria defined in parameters to the command. alogact - Activation of Audit Log This command activates the Audit Log function of an Adjunct Processor (AP). The alarm indicating that the Audit Log function was inactive is ceased. There is one Audit Log function in each AP node. There may be several AP nodes in a network element. alogdeact - Deactivation of Audit Log This command deactivates the Audit Log function of an Adjunct Processor (AP). An alarm is generated when this command is completed successfully. The alarm indicates that the Audit Log function is deactivated. There is one Audit Log function in each AP node. There may be several AP nodes in a network element. alogexcl - Exclusion in Audit Log, Insert or End This command changes the exclusion status of Man Machine Language (MML) commands, MML command parameters, MML printouts or UNIX commands in the Audit Log function of the Adjunct Processor (AP). There is one Audit Log in each AP node. There may be several AP nodes in a network element. alogexls - List Excluded Items in Audit Log This command changes the exclusion status

of

Man

Machine

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
Language (MML) commands, MML command parameters, MML printouts or UNIX commands in the Audit Log function of the Adjunct Processor (AP). There is one Audit Log in each AP node. There may be several AP nodes in a network element. alogfind - Search in Audit Log This command searches in the logged data for items that correspond to the specified search parameters. Any combination of search parameters can be used in order to limit the search range. If no options are specified, all the logged data is listed. The logged data is stored in the Audit Log function of an Adjunct Processor (AP). There is one Audit Log function in each AP node. There may be several AP nodes in a network element. aloglist - List Attributes of Audit Log This command lists the attributes of the Audit Log function of an Adjunct Processor (AP). The Audit Log function creates one new log-file each hour. When the upper limit for the sum of all the log-file size values is reached, the oldest log-files are deleted. In this way the Audit Log function makes sure that the allowed level of disk usage is not exceeded. There is one Audit Log function in each AP node. There may be several AP nodes in a network element.

Page 2 of 8

alogset - Set Attributes in Audit Log This command specifies the attributes of the Audit Log function of an Adjunct Processor (AP). The Audit Log function creates one new log-file each hour. When the upper limit for the sum of all the log-file size values is reached, the oldest log-files are deleted. In this way the Audit Log function makes sure that the allowed level of disk usage is not exceeded. There is one Audit Log function in each AP node. There may be several AP nodes in a network element. burbup - Create a Backup of the AP System on Tape This command initiates a backup to DAT tape. Only the users root or fchadm can run the command burbup. The command makes a backup of the software in the currently active system in such a manner that the backup may later be restored using the burres command, and brought into operation. *** burcmf burcmv burver - Verify that a Backup Tape is Readable This command reads the archives on a backup tape and checks that the tape is still readable. There are no user restrictions on the burver command. When the command is started it checks the label on the tape to verify that the tape really is created by the burbup command before operation continues. calctime chkstat - Check system status The chkstat command checks the status and revision of all packages in the system. It will run two passes, the first pass will check that all

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
expected packages is installed in the right revision, the second pass will check that only the expected packages is install and will report all packages installed that are not in the template. dsdls - Directory Service Listing This command lists and display the content of the registration file that is a part of the Directory Service function. By using the command, an operator can display applications registered as servers in a Central Processor (CP) or Adjunct Processor (AP). dslist - Directory Service Listing The dslist command lists and display the content of the registration file that is part of the Directory Service function. By using the dslist command an operator can display applications registered as servers in a CP or AP. ***

Page 3 of 8

fastshutdown - quickly shut down and reboot the system This command quickly shuts down and reboots the system. You can use this command to reboot a system after you install new software (for example, a new kernel). You must have root privileges to run this command. *** fchabort fchadm.sh fchcmf fchcmv fchend - Function Change End The fchend commands ends a Function Change session. During supervision of a system in which newly installed software is running, fchend commits the system to the new software. Fall-back to the previous system is no longer possible after this command is issued. *** fchevent fchfb - Function Change Fallback The fchfb command reverts the system to its state before a Function Change. During supervision of a system in which the newly installed software is running, fchfb allows an operator to fall back to the previous system and activate the old software. *** fchfsync fchlog fchpm fchresume fchstart - Function Change Start This command initiates a Function Change Session. fchstart allows a user to install new software and (or) update and

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
compile parameter files on-line software currently is running. while *** the old system

Page 4 of 8

fchsudo - Function Change Set User This command enables execution of commands as another user in the restricted Function Change environment. For reasons of security, the only commands fchadm can execute are Function Change, Backup, and some rksh built-in commands. To enable readings of logs, check for space etc, the command fchsudo is available. *** fchsvs fchsvt ispprint - ISP Print Tool This command prints the process control in service performance log to standard output or makes some simple statistics and prints the result to standard output. mktr - Make Trouble Report This command reports and collects additional information, to be used when trouble reports are received. This information is intended to be used as complementary information as a help to identify the problem. *** msareader msdls - Message Store Listing The msdls command lists and displays the content of a message store. By using the msdls command an operator can display and decode data stored in the specified message store. Different parts of the message store can be displayed. A '*' in the output indicates that the previous line is repeated until next printed line. The first instance of msdls displays the contents of a data_file. The second instance of msdls displays an analysis of the message store. The third instance of msdls displays collected statistics. *** phabup phacreate - Parameter Create The phacreate is used at installation to create the parameter tables for a CXC specified in a Parameter file. Before the parameter table is created a check of the parameter formats against the Format file is performed. *** phaprint - Parameter Printing Utility The phaprint command will read and print one parameter, a group of parameters or all parameters to standard output. pharm - Parameter removal The pharm command is only relevant to CXCs that have parameters handled by PHA Parameter Handling.

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
It is used at pkg removal to clean up the directory structure from the CXCs private parameter tables. It will also remove any backupfiles that phatrans(1m) may have created. *** pharst phatrans - Parameter Transfer Utility The phatrans command transfers parameter values from one revision of a CXCs parameters to a later revision. It will only create a new parameter file. It does not perform the same logical analysis of the parameter and format files as the phacreate command does. *** prcavail - Wait for service to be available The prcavail command is used mainly during boot to ensure that a needed service is available before the application is started. prcavail polls each interval seconds no longer than maxtime seconds for service to be available. *** prcbot prcsrp prcutil - Process Control User Interface This command starts the user interface to Process Control. Only one instance of the command is allowed at any time. If one instance already is running the user interface, the error message FUNCTION BUSY will be displayed. sadfsconf - System Analysis Daemon FileSystem Configuration The sadfsconf sets and/or displays the alarm-limits for filesystem supervision. The System Analysis Daemon (SAD) supervises filesystems and generates events and/or alarms when a filesystem is filled above a specified limit or when a filesystem is fragmented. *** sfcbckup sfccmf sfccmv sfccrsw sfccrsys sfcend - Soft Function Change End This command ends a Soft Function Change (SFC) session. During supervision of a system in which the running Adjunct Processor (AP) software has newly updated parameters, the command ends the SFC session. sfcevent sfcfb - Soft Function Change Fallback This command makes a fallback of a Soft Function Change (SFC) session. During supervision of a system in which the running Adjunct Processor (AP) software has newly updated

Page 5 of 8

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
parameters, CXC PKG packages, system name, Process Control (PRC) schedule file or LBB files, the command falls back to the system that existed when the SFC session started. *** sfcfsync sfcgstate - Soft Function Change Get State The sfcgstate command gets the state of Soft Function Change. When executed, by default, sfcgstate checks the file SFCHIP and returns the contents plus true if the file exists. If the file does not exist, it returns an empty string and false. sfclog sfcnew - Soft Function Change New System This command updates a system and switches over to the updated new system. The operator must invoke the command while logged in as fchadm or root on the target machine and after successfully issuing sfcstart. *** sfcpkg - Special handling of CXC symbolic zero-links during installation. This description concerns mainly designers who assembles PKG CXC packages. The sfcpkg command should only be called from PKG procedure scripts and is not to be invoked by the operator directly. *** sfcpm sfcreboot - Soft Function Change Reboot The sfcreboot command should be invoked during a Soft Function Change (SFC) session when an SFC Restore is needed. Executing an embedded SFC will result in a Function Change (FCH) fallback. The sfcreboot command should only be invoked when referred to from an Operational Instruction (OPI), to restore the system that existed prior to the SFC session. Various activities during SFC Reboot are logged in the SFC log file ACS_SFC_Install.log. sfcstart - Soft Function Change Start This command prepares and initiates a Soft Function Change (SFC) session by updating a system and switching over to the updated new system. *** sfcsudo - Soft Function Change Set user This command enables execution of commands as another user in the restricted Function Change environment. For reasons of security, the only commands fchadm can execute are Function Change (FCH), Soft Function Change (SFC), Backup, and some rksh built-in commands. *** sfcsvb sfcsvt sfcswitch -

Page 6 of 8

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
sfcwd sfcwdwd slinit sll - System Log Listing The sll command lists and displays the content of the event log that is part of the AP Event handler. By using the sll command an operator can display and decode event records in specified groups or intervals. This is done by add of search flags to the program. srmevmcoll srmlogwr swrbup - creates a backup of the SWR database The swrbup command creates a backup of the SWR database swrprint - print software records The swrprint command prints software records. When executed the command retrieves the current system name via swrsid command and the third party products via swrprod. Then information is retrieved for packages that are determined according to supplied options. *** swrprod - Handles the specification, changing and retriving of the third party products identity. The swrprod command implements support for the third party products identification. By using this command it is possible to print or change the name of the third party products. The third party products identification are kept in the product description file. When executed without options the name of the third party products are printed. swrrec - retrieval of parameters from PKG The swrrec command is the CLI for retrieval of parameters from PKG. It is used internally by swrprint and it can be used by any FB that needs product parameters supplied in the package. swrrst - restores SWR databse The swrrst command restores the SWR database from a backupfile created by swrbup swrsid - change or retrieve the name of AP system The swrsid command implements support for AP system identification. By using this command it is possible to print or change the name of the current AP system. The current system name and the history of changes are kept in the system description file. When executed without options the current system name is printed. tcsh trainit trautil - ACS_TRA_utility - the manual page. The operators interface to the ACS trace

Page 7 of 8

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01

acsadm_commands
trautil provides an operator with commands for creating/deleting trace tasks, and displaying the trace log generated by a trace task. A trace task orders a trace action to be executed when a traceable event, selected by the trace task, is encountered under run time. The only trace action implemented in the first stage is logging of the traceable events in a cyclic trace log. vtoc.to.disksetup.input -

Page 8 of 8

Memo: UAB.UABJFP mailto:%20Per.Jonsson-Finne@uab.ericsson.se

file://E:\Aquarium\Gewusst.wo\apg40\User_Guide\html\acsadm_commands.htm

07.08.01