MoShell 10.0b User Guide第二章.docx

2、软件安装及用户设置2.1Unix系统安装2.2Windows系统安装（使用Cygwin）当MoShell在Windows系统上运行时，MoShell使用Cygwin这款仿真器进行工作。如果之前您已经安装并配置Cygwin，请直接跳到第13步。第一步：打开网址：/；第二步：点击Install Cygwin；第三步：保存setup.exe文件，并运行文件；第四步：选择“Install from Internet”，点击“Next”；第五步：安装路径：“C:cygwin”（不建议使用其它安装路径，尤其当C盘仍有剩余空间情况下），如果提示“Default Text File Type”，选择“UNIX”，然后点击“Next”；第六步：选择网络连接：设置网络代理（通常结合ESOE PCs并使用IE5进行设置），点击“Next”；第七步：选择文件存储位置；第八步：选择安装组件，添加以下组件：l 在Archive下选择zip和unzip；l 在Perl下选择perl和perl-XML-Simple；l 在Net下选择inetutils、openssh和openssl；l 在Shells下选择rxvt VT102；l 在Utils下选择file；l 可选项：在Editors下选择vim（如果希望通过vi进行文件编辑，建议选择此项）。第九步：点击“Next”，开始安装，等待安装完成；第十步：下载http:/utran01.au.ao.ericsson.se/moshell/cygwin_install.txt到“C:cygwin”路径下；第十一步：点击“开始”-“运行”，输入“cmd”并回车，在DOS窗口中依此输入以下命令：“c:”、“cd cygwin”、“binperl cygwin_install.txt”，生成以下文件：“c:/cygwin/etc/proile”、“c:/cygwin/ cygwin.bat”、“c:/cygwin/home/youruserid/.bashrc”、“c:/cygwin/home/youruserid/.Xdefaults”、“c:/cygwin/home/youruserid/.inputrc”，如果这些文件已经存在，这些文件会自动转移到文件夹：“c:/cygwin/tmp/installbackup”；第十二步：打开一个新的cygwin终端窗口。窗口显示应为黑色，字体为白色，提示符为：$，如果不是，请检查以上所有步骤，查看是否有遗漏；更多关于cygwin安装的信息请登录：/faq/faq0.html；如何卸载cygwin请参考：/faq/faq.setup.html#faq.setup.uninstall-all第十三步：如果cygwin环境已经安装完毕，请按照以下步骤安装MoShell。l 从http:/utran01.au.ao.ericsson.se/moshell下载moshellxxx.zip到路径“c:/cygwin/home/youruserid”下；l 打开cygwin shell并输入以下命令：unzip o moshellxxx.zipbash moshell_install当提示您输入MoShell的安装路径时，建议您指定根路径。如果您是直接从根路径进行MoShell的安装，则直接回车即可（当前路径即为选择的安装路径）。如果之前已经安装过MoShell，推荐您安装到同一路径下，这样，您所有的用户文件（包括jar、xml以及基站文件等）都会复制到新版本软件中，而旧版本软件则会自动移动到另外的位置，您依然可以依旧需要访问旧的版本。当提示您输入JAVA路径时，请选择下面中的一个：l /cygdrive/c/Windows/system32/javal /cygdrive/c/Progra1/javasoft/jre/bin/java第十四步：第一次运行MoShell。如果已经在/.bashrc文件中将路径参数配置正确，那么应该可以在任何路径运行MoShell，例如：moshell 。如果这是您第一次在电脑上安装MoShell，MoShell将从节点下载若干jar文件，此时不会出现下载进度指示，请您耐心等待几分钟，可通过在moshell/jarxml路径下输入“l$ -l”来查看下载进度。关于用户设置的更多信息，请查看用户指南。第十五步：当在vista系统运行moshell出现以下错误时：fatal error unable to remap C:cygwinhomexxxmoshellcommonjarslibfile.dll to same请按以下步骤操作：l 将文件http:/utran01.epa.ericsson.se/moshell/xvista.txt及http:/utran01.epa.ericsson.se/moshell/xvista.bat下载至桌面；l 运行fixvista.bat文件。注意事项：快捷键CTRL-C不一定每次都有效，这种情况下，可以使用以下操作代替：首先使用快捷键：CTRL-Z，然后输入“kill 1%”。2.3MoShell目录结构MoShell目录下含有多个文件以及子目录，介绍如下：logfiles/ 此目录下存储由多个设备（例如：moshell、mobatch、swstat等）生成的日志文件；examples/ 此目录下存储设备要求的输入文件示例（例如：命令行文件、基站配置文件等）；cmdfiles/此目录下存储您的命令文件（这些文件将被用于mobatch、monode、telbatch、telnode等）；sitefiles/此目录下存储您的基站文件（这些文件将被用于mobatch、telbatch、swstat、swup等）；jarxml/此目录下存储jar文件（包括oms.jar和vbjorb.jar文件）和xml-MOM文件（用于MoShell），不同节点要求不同；commonjars/此目录下存储jar文件，所有节点均相同；moshell此文件用于启动MoShell，包含一些自定义变量设定。mobatch此文件用于在多个节点上并行运行moshell命令；gawk此文件用于不同设备间命令的统一；prog.awk，funcs.awkMoShell的主代码，这些文件不能自运行；moshellUserGuide.pdf帮助文档；rncaudit此文件用于检查rnc数据对小区CDR、utranrelations CDR、baseline、uerc等数据的一致性；swstat此文件用于检查软件版本、CV以及已经删除的旧版本组件；rbssudit此文件用于核查rbs数据对rbs数据和baseline的一致性，以及mobatch纠错文件的产生；swup此文件用于网络软件升级；cvms此文件用于在多个节点上cv的并行产生及设置；momdoc此文件用于将MOM从XML格式转换成HTML格式；mocmd此文件用于从baseline参数文件产生moshell命令文件。2.4开始一个MoShell会话此章节将对MoShell的使用做简要介绍。2.4.1启动MoShell在Unix shell中输入以下指令开始一个新的MoShell会话：moshell |如果通过节点名字来与节点建立联系，那么输入的名字必须在ipdatabase文件（用于节点名字与节点IP或DNS地址的对应）中存在。另外，在第九章中介绍了如何通过在MoShell中键入moshell来启动一个新的会话。在启动MoShell会话后，通过输入指令：lt all，MoShell将完成以下操作步骤：1、 下载节点的IOR文件并将其存储的工作站中，IOR文件是在网址：http:/nodeipaddress/cello/ior_les/nameroot.ior中得到的；2、 检查节点的MOM版本，节点的MOM是在网址：http:/nodeipaddress/cello/oe/xml/中得到的，其中是在用户变量xmlmomlist中列出的一个文件。MOM版本信息是通过MOM文件中的“mim”标签获得的，例如：由得到：RNC_NODE_MODEL_E_5_3，如果这个MOM版本并不存在于工作站（在moshell/jarxml目录下）中，则将其从节点下载并存储在此目录下。若不能得到MOM版本信息（即moshell不能在节点中找到任何MOM），则使用moshell用户变量中的default_mom；3、 对MOM进行语法上的解析，并在内部生成一个表格，包括所有的MO类型、属性以及节点支持的操作；4、 利用IOR文件中包含的信息在节点中发起一个CORBA过程；5、 从根MO中读取FDN；6、 随时准备接受用户指令。在这一阶段，可以获得告警服务和OSE shell但由于不知道节点的MO树（不包含根MO）中包含哪些MO实例，数据配置服务是受限的。在这一阶段可使用以下命令：l h-命令可用于显示帮助以及指令列表，可将其加在指令后面获得这条指令的帮助信息。出于阅读方便，将菜单分为两列（m和n）。2.4.2加载MO树当MoShell第一次连接到节点时，节点的MO结构方面除ManagedElement这一MO类型外一无所知。为了获得MO属性信息并执行其它操作，您需要首先下载stub到您的MoShell客户端上。可通过指令“lt all”读取整个MO树，此时，MO树的每个MO的LDN将会被分配一个数字（作为标示）存储在MoShell内存的内部表格中。这个表格可以通过指令“pr”打印出来，包括MO、LDN以及标示数字。当在MO上执行操作（例如：get、set、action等）时，标示数字或LDN都可作为索引。实际上，通过使用正则表达式对LDN进行匹配，可在多个MO上同时进行某一操作。更多信息请参考第三章或通过在MoShell会话中键入“h syntax”获得。为保存工作站中的信息，可能仅下载MO树的一部分。例如，键入“lt pluginunit”，则只会读取MO类型为PlugInUnit的MO的LDN。可通过键入正则表达式来匹配MO类型，而不需要键入整个MO类型名字，例如，“lt plu”等同于“lt pluginunit”，因为字符串“plu”与“pluginunit”相匹配。更多信息请参考第四章或通过在MoShell会话中键入“h lt”和“h lc”获得。2.4.3在加载的MO Stub上操作为了在已经下载的MO上执行操作，需遵照下面的指令语法：例1：使用MO的LDN读取MO属性数据：ManagedElement=1,Equipment=1,Subrack=MS,Slot=19,PlugInUnit=1，你需要输入以下指令：pr plu#输入完成后查看MO的标示数字get #proxy即为标示数字或者输入以下指令：lget ms,slot=19,pluginunit=1$例2：读取所有MO类型为PlugInUnit的MO的MO属性数据get plu#get指令将对所有RDN能与“plu”进行匹配的MO执行操作更多信息请参考第三章或通过在MoShell会话中键入“h syntax”进行查阅。!关于CDMA节点的重要信息!。（Page20）2.5特殊用户设置MoShell中存在若干配置参数（也称为用户变量），既可以将这些参数的配置数据设置为永久有效，也可以让它们仅在一次会话中有效，在文件moshell中存有这些参数的默认配置数据值。如果需要修改一个或多个用户变量的默认值，建议您将新的配置数据存储在moshellrc文件（/.moshellrc或moshell/jarxml/moshellrc）中，这样，即便以后对moshell进行升级，配置数据也不会丢失。可通过以下方式在一次会话中对用户变量进行配置数据修改：1、 使用指令：uv var=value，更多信息通过输入“h uv”获得；2、 或者在启动moshell时使用选项：“-v”，更多信息通过输入moshell获得。MoShell允许多个用户共同使用，并拥有各自的日志文件、权限文件、用户变量及别名（这些数据分别存储在用户自己的目录下），这中情况适用于在本地没有安装MoShell的多个用户共享大型网络的场景，此时，可以通过建立一个公共账户来使用户获得MoShell的使用权限。管理员可以定义若干个用户变量、别名，并将它们存储在moshell/jarxml/moshellrc文件中，任何用户在启动MoShell时都可以使用它们。每个用户也可以定义自己的用户变量等数据，并将它们存储在位于它们自己目录下的/.moshellrc文件中，如果这个文件并不存在，则它会自动生成，且用户可在任何时候对其进行修改。凡是在文件moshell中定义的变量均可在文件moshell/jarxml/moshellrc或/.moshellrc中设置新的数值。定义在文件/.moshellrc中的数据值会覆盖掉定义在文件moshell/jarxml/moshellrc中的数据值，进而覆盖掉定义在文件moshell中的数据值。下面是一个用户变量的简表，更多信息请查看文件moshell：l disk_check：查看工作站中是否有足够的磁盘空间，0：不做检查；1：只做警告；2：当没有足够的磁盘空间时，退出；l disk_limit：进行磁盘检查时，磁盘所剩余最小空间，默认为1G；l java：可执行JAVA的路径；l ip_database：IP数据库文件路径（此文件的示例在文件：moshell/examples/mobatch_files中）；l secure_shell、secure_ftp、username、ip_connection_timeout、ip_inactivity_timeout，关于这些变量的信息请参考2.6节；l corba_class、security_method、credential、sa_credential、sa_password、sls_urls、sls_username、sls_password，关于这些变量的信息请参考2.7节；l default_mom：默认MOM的路径，当找不到MOM时使用；l prompt_highlight：开启或关闭提示符的粗体显示；l set_window_title：开启或关闭窗口标题的显示；l http_port：标示HTTP端口值（例如：CPP为80；simcello为8080）；l keepLmList：标示不能被指令“fclean”删除的文件；l bldebset_confirmation、lt_confirmation：标示确认消息是否应在指令“lt/bl/deb/set”中给出；l logdir：日志文件的路径（此路径值不能通过“uv”或“-v”来修改，只能在moshellrc或. Moshellrc中修改）；l 其它变量信息，请参考文件moshell获取更多细节。2.5.1文件属性对于外部用户来说， moshell安装组件所包含的所有的文件以及子目录都是不可修改的，只有moshell安装账户的拥有者才能对安装信息做出修改。但是，任何用户均可对文件：moshell/jarxml进行修改，这样做也是有道理的，因为，任何用户都有权利在此路径下存储新的xml MOM文件（这是考虑到由于新节点软件版本的发布而使得xml MOM进行频繁的升级）。注意：不管在节点上运行的CPP软件版本是什么，相同的jar文件可被所有的用户使用，例如：可在CPP3节点上使用CPP4的jar文件，再例如CPP5.1移向JacORB。2.6与telnet/ftp/ssh/sftp协议相关的设置下面将要介绍的用户变量均与telnet/ftp协议相关。参数的设置可在文件moshell、/.moshellrc或在MoShell会话中通过“uv”指令实现，更多信息请参考2.5节或通过指令“h uv”获得。也可通过查看moshell文件获得每个变量的信息。l username：此参数表示在通过telnet/ftp/ssh/sftp远程登录协议登录节点时所使用的用户名；l secure_shell：此参数表示登录OSE shell的方式，telnet或ftp；l secure_ftp：此参数表示文件转移的方式，ftp或sftp；l ip_connection_timeout：此参数表示telnet/ftp/ssh/sftp连接建立的时限；l ip_inactivity_tiomeout：此参数表欧式telnet/ftp/ssh/sftp连接非激活状态的时限；l telnet_port/http_port/ftp_port/secure_port：此参数表示telnet/ftp/ssh/sftp所使用的不同端口。这些端口用于与SimCello（或CPPemu）建立连接或通过安全管道运行MoShell情况下。l node_login：此参数表示节点是否已登录（SimCello以及备份模式这两种情况不能登录）。因此，为了使ssh/sftp替代telnet/ftp，请选择下面措施中的一种：1、 将moshell文件中的变量secure_shell和secure_ftp的值设置为1（不推荐这种方式，因为在下次重启MoShell时，变量数值会再次恢复为默认值）；2、 在文件/.moshellrc、moshell/jarxml/moshellrc中添加以下指令：secure_shell=1secure_ftp=13、 在MoShell会话中执行以下指令（但这些参数设置仅在此次会话中有效）uv secure_shell=1uv secure_ftp=14、 使用以下方式启动MoShell：“-v secure_shell=1, secure_ftp=1”关于参数设置的更多信息请参考2.5节。注意，如果运行ssh/sftp，需要节点中含有加密密钥文件。可使用以下两种密钥中的一个：1、 使用RSA密钥时：使用文件/c/java/host.p12或/c/configuration/ssh_host_rsa_key；2、 使用DSA密钥时：使用文件/c/configuration/ssh_host_dsa_key。上面提到的三个文件的示例均可在目录moshell/commonjar下找到。关于ip_connection_timeout的注意事项：在moshell文件中，此参数的默认值为45秒，但某些指令的运行时长要超过45秒（例如：format、rcp等指令），为避免在运行此类指令时时限超时，建议修改参数值（例如更改为600s：uv ip_connection_timeout=600）。2.7CORBA设置为明确MoShell使用的是哪一种CORBA软件以及CORBA的安全设置如何，请将corba_class值按照以下说明进行设置：l corba_class=1：表示使用visibroker（vbjorb）这款软件进行安全模式的连接。 security_mothod=1（要求JAVA版本高于1.2.2）：使用主机认证文件：host.p12（仅适用于节点使用CPP5.0以及更低版本场景）同时用户变量credential必须做相应的设置，使其指向文件host.p12。文件host.p12是从PKS服务器或节点中下载的。 security_mothod=2（要求JAVA版本高于1.3.1）：使用独立认证文件：sam.pbe。文件sam.pbe是从SLS服务器下载的，其下载路径以及口令需在变量sa_credential以及sa_password中给出。l corba_class=2（要求JAVA版本高于1.3.1）：表示使用prismtech（jacorb）这款软件进行非安全模式的连接。l corba_class=3（要求JAVA版本高于1.4.2_05）：表示使用jacorb软件进行安全模式的连接，且使用独立认证文件：sam.pbe，文件sam.pbe是从SLS服务器下载的，其下载路径以及口令需在变量sa_credential以及sa_password中给出。l corba_class=4（要求JAVA版本高于1.4.2_05）：表示使用jacorb软件进行安全模式的连接，且使用网络模式的认证文件：ssucredentials.xml，此文件是自动从SLS服务器下载的，SLS服务器的登录账号以及密码需在变量sls_username以及sls_password中给出，SLS服务器的地址可从节点读取，也可由变量sls_urls进行标示。l corba_class=5（要求JAVA版本高于1.4.2_05）：表示使用jacorb软件进行安全模式的连接，且使用网络模式的认证文件：ssucredentials.xml。文件ssucredentials.xml的下载路径需在变量nm_credential中给出。关于如何设置变量值的更多信息请参考2.5节或使用指令：“huv”，通过查看文件moshell可获得各个变量的信息。2.8关于MoShell所使用的端口如果在MoShell和CPP节点间存在防火墙，请将以下TCP端口在防火墙中设置为开发：1、 Corba：a) 节点运行CPP5或更低版本（vbjorb）情况下：l 端口56834：用于安全及非安全CORBA；l 端口56835：用于安全及非安全CORBA；l 端口56836：未使用。b) 节点运行CPP5.1或更高版本（jacorb）情况下：l 端口56834：用于非安全CORBA；l 端口56835：未使用；l 端口56836：用于安全CORBA。2、 HTTP：80；3、 Telnet：23SSH：22；4、 FTP：21SFTP：22。若使用FTP，则需要新增加一个端口范围（用于数据连接，端口21仅用于控制）；如果使用SFTP，则端口22就足够了（不需要额外的端口用于数据连接）；5、 关于目标监控器：需使用端口33077、33087来对CPP的操作痕迹以及错误日志进行监控，此时，使用监控设备6054；6、 可选项：对于订阅Corba CS/FM情况（使用runClient.sh c/-a选项）下，节点到终端的回叫端口范围为：53248-55295（MoShell并无此设置，仅对设备使用runClient.sh c/-a选项这一情况而言）。2.9通过安全管道运行MoShell（RSG）注意：鉴于此方法允许与用户网络的激活节点建立会话，请谨慎使用此方法。此方法介绍了如何通过远程支撑网管（RSG：Remote Support Gateway）的安全通道来允许MoShell。此说明适用于三步RSG情况，涉及到三个串接的服务器。l 一个爱立信网关，称之为EGW；l 一个用户支撑网关，称之为SSW；