ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

New Landscape Checklist

book

Article ID: 145718

calendar_today

Updated On:

Products

CA Spectrum DX NetOps

Issue/Introduction


At times when adding a new landscape to an environment, it will not be visible in OneClick. It is also possible for an existing landscape
   to sometimes disappear from OneClick and the landscapes list.

This KB will provide a checklist of things to check to ensure that Spectrum is configured properly


Note: This article can also be used to troubleshoot existing installations where a landscape might have gone missing  

Environment


Spectrum Release : All Supported Spectrum Releases

Component: SPCCSS - SpectroSERVER Core





Resolution

New Landscape Checklist

 

On The New Landscape Server

  •  LocServer: configured to report to the correct MLS Server

           $SPECROOT/LS/.locrc
           MAIN_LOCATION_HOST_NAME=specmls01               

     



  •  Verify LOCSERV process is started in $SPECROOT/LS/LOCSERV.OUT


  •  .hostrc file
         $SPECROOT/.hostrc
          
      This file should either contain a ‘+’ character at the start of the file or be populated with the server hostnames. In a DSS environment, and those with Fault Tolerant backup servers configured, all server hostnames should be included in all .hostrc on all servers. Meaning, the .hostrc files on each server should be identical, and list each and every server in the environment: MLS, DSS, FT, OC servers, etc. This ensures proper communication between all servers. 

           

 

  •  Name Resolution

            Ensure that the new landscape can resolve both the Short and FQDN of both the OneClick Server and MLS landscape. If necessary
               add these names to the hosts file on the system.

         

 

  •  Port Connectivity

     To MLS
          56063 TCP:  The LocServ process will attempt to connect to the LocServ process on the MLS SS to publish its topology
          48879 TCP:  The SpectroSERVER will try and connect to the MLS SpectroSERVER using the SSAPI on this port

     

    From/To OneClick
          14002 TCP: OneClick will connect to the SpectroSERVER on port 14002
          14003 TCP: OneClick will connect to the Archive Manager on port 14002
          14001 TCP: The SpectroSERVER will attempt to connect back (other direction) to the OneClick on 14001 after the 14002 connection is made



    Note: OneClick will also connect to ports 14004 and 14006 in addition, they may not always be connected


  •  Spectrum installation user
      
     Sometimes during installation the installation owner may be specified differently (case sensitivity) or might
       be a different user than the user OneClick is set to use (adminUserName). If the user OneClick is using
       does not exist or is in a different case then OneClick will not be able to connect.

    Check the initial_user_model_name set in the .vnmrc
        $SPECROOT/SS/.vnmrc

         If the user name specified in the initial_user_model_name is different than what is configured on the MLS SS and
            OneClick's adminUserName it may be necessary to open the Spectrum Control Panel (SCP) and add the user
            used by OneClick.
 
         You may also want to check Users tab in OneClick accessed by SpecAdmin user and verify the User or Group to view the new landscape is a "member" of the landscape:  
 
         

On the MLS SpectroSERVER

  •  Landscape Map
        OneClick discovers the Landscapes that it needs to connect to from the MLS SpectroSERVER's Landscape Map. Ensuring
          that the landscape is present in the map with the correct handle and precedence.

       

     If the new/problem landscape is not present, it would indicate a problem with the LocServer configuration or
       connectivity to the MLS. Check that the new/problem SpectroSERVER is running, the main location server is set
       to point to the mls on the problem server and that the connection on port 56063 is established

 

  •  .hostrc file
            $SPECROOT/.hostrc
      
          This file should either contain a ‘+’ character at the start of the file or have the problem landscape name added

         


  •  Name Resolution

            Ensure that the mls can resolve both the Short and FQDN of the new/problem landscape. If necessary
               add these names to the hosts file on the system.
       



On the OneClick Server


  • Landscapes Web Page

          In the OneClick Web interface, click Administration ~~> Landscapes and check the landscape table to see if the new/problem
              landscape is present and if there is a heartbeat. If the server is missing it would be worth while to check the previous 2
              sections. If the landscape is present and the heartbeat failed it might be due to connectivity issues. 


       



      If the landscape is present and the heartbeat is good (within ~ 60secs) it might be that the logged-in user does not have access to
         the landscape. Log in as the spectrum superuser and check the landscapes for that user and add the new/problem landscape if necessary

       

  •  Name Resolution

            Ensure that OneClick can resolve both the Short and FQDN of both the OneClick Server and MLS landscape. If necessary
               add these names to the hosts file on the system. 

            Note: In most cases, OneClick will use the short name so it is important that both Short and FQDN resolve

         

 

  •  Admin User Name (adminUserName)

    Check the spectrum user that OneClick is configured to connect to the landscapes. This user will need to exist on the new/problem landscape.
      In some cases, the user name on the new/problem landscape ends up in a different case or a different user altogether. The user name here
      needs to exist on the new/problem landscape for OneClick to connect.
       
         

    In a case where OneClick cannot connect to the MLS this can be checked in OneClick's configuration file, looking for adminUserName=

        $SPECROOT/tomcat/webapps/spectrum/META-INF/context.xml
       

Attachments