Knowledge Search


×
 

[Junos Space] How to create Offline Hardware Catalog file for Junos Space Platform for Import

  [KB34688] Show Article Properties


Summary:

Junos Space Network Management Platform provides an option to manually upload the hardware catalog when Junos Space is not able to connect to the Juniper Networks SVN repository . This article explains the procedure to do so.

You can navigate to this workspace from the webpage: Platform > Administration > Hardware Catalog. The relevant hardware catalog can be downloaded using the SVN (sub-version) client or wget.

 

Symptoms:

Starting from Release 17.1R1, Junos Space Network Management Platform provides Hardware Catalog that enables you to manage hardware components of Juniper Networks devices. Hardware catalog saves you from updating Junos Space Platform software every time a new hardware component, for example, a line card, an FPC, or a power supply module, is added to a Juniper Networks device that Junos Space Platform manages. When new components are added, Juniper Networks provides a new hardware catalog that you can import to the Junos Space platform.

You can extend Junos Space Platform support to new hardware components on managed devices by uploading the latest hardware catalog distributed in the *.tgz archived format by Juniper Networks or downloaded from the Juniper Networks subversion (SVN) repository to Junos Space Platform.

Preferred method:
If your Space system can reach Juniper's SVN server please use the Online method: https://www.juniper.net/documentation/en_US/junos-space17.1/platform/topics/task/configuration/hw-catalog-uploading.html   and use  URL: https://xml.juniper.net/space/repository/trunk/hardware-catalog/

 

Solution:

Part 1:  Create File bundle on a different system:

Option 1:  wget  (linux / windows)

Windows does not include wget see wget homepage  https://www.gnu.org/software/wget/faq.html#download to download and install if desired
Any linux system with internet access can be used to create this bundle

The following commands can be used to create a hardware-catalog bundle file to install, this will include all hardware versions.

wget  -r -np -nH --cut-dirs=3 -R index.html --http-user="user@domain.com" --ask-password https://xml.juniper.net/space/repository/trunk/hardware-catalog/
cd hardware-catalog
tar czf hardware-catalog.tgz junos junos-es junos-ex junos-qf junos-qfx

 



Option 2: Subversion  on Windows:

  1. Download and install the SVN (sub-version) client on the Windows PC (https://tortoisesvn.net/downloads.html

  2. Download and install 7-zip to create a tgz file (http://www.7-zip.org/).

  3. After the SVN Client is installed on the Windows PC, right click to choose the option SVN Checkout, as shown below:
  4. Check out the files from the SVN repository, as shown in the image below. Change the device family as per requirement; here it shows hardware catalog for device family - junos
    1.  In the URL of repository field, type the following URL:
      https://xml.juniper.net/space/repository/trunk/hardware-catalog/junos       <----------Here we want to download the hardware catalog for junos device family.

      Change the above URL as per the device family. Use the following table to get information about the device family/platform:
       
      Device family Platform  
      junos M/MX/T/TX series
      junos-es SRX series
      junos-ex EX series
      junos-qf Q Fabric Series
      junos-qfx QFX series
    2. In the Checkout directory, type the directory using the following format:
      For example: C:\Users\labroot\Documents\hw-catalog\junos

      Ensure that the directory name should be same as device family mentioned in the above table: \hw-catalog\device_family
    3. In the Checkout Depth field, select the Immediate Children, Including folders option.
    4. Click OK.
  5. On clicking OK, a dialog box will appear requesting for authentication for accessing the repository URL. Fill in your Juniper Support Credentials. After the credentials have been entered, the hardware-catalog download begins.


    Note: If you choose to save the credentials, on the next Download, the authentication will take place automatically and this step will be skipped.
  6. Go to the device_family folder (here: junos) and right-click 7-zip > Add to Archive > tar format. 
  7. Go to the tar file created (junos.tar) and right-click > Add to Archive > gzip format. It will create junos.tar.gz file in the hw-catalog folder.

Option 3: Open support case for JTAC to create file for you and attach to case

Part 2: Procedure to upload hardware catalog to Junos Space Platform by using the Import option:

  1. On the Junos Space Platform user interface, select Administration > Hardware Catalog.​The Hardware Catalog page appears.

  2. Click Browse to locate the hardware catalog file (junos.tar.gz) on your local system.

  3. Click Import to import the hardware catalog file to Junos Space Platform.​

  4. A job is initiated to import the hardware catalog and the ID of the job is displayed. The hardware catalog file is imported to /var/jboss/jmp-tmp/net/juniper/jmp/var/hw-catalog location on the Junos Space server.

  5. (Optional) Click the Job ID to view the job details.

  6. The Job Details page displays whether the hardware catalog was imported successfully or not.

 

Related Links: