Creating a Compressed TAR File for Updating DMI Schema
This topic contains instructions for creating
a compressed tar file (extension .tgz
or .tar.gz
) on Linux or Microsoft
Windows. You use the compressed tar file to update a DMI schema on
Junos Space Network Management Platform (see Adding Missing DMI Schemas or Updating Outdated DMI Schemas by Using the Update Schema Menu).
Before you create a compressed tar file, ensure the following:
The internal directory structure of the compressed tar file complies with the following format; that is, when you extract the compressed tar file, all files must be extracted to a folder structured as follows:
dmi/deviceFamily/releases/osVersion/….
The compressed tar file has the
.tgz
or.tar.gz
extension.You have the username and password for xml.juniper.net, which are your Juniper Networks support credentials.
In this topic, we provide examples that contain only HTTPS URLs. However, both HTTP and HTTPS URLs are supported. If the repository (whose URL is being entered) supports both HTTP and HTTPS access, we recommend that you use an HTTPS URL.
This topic contains the following sections:
Creating a Compressed Tar File on Linux
To create a compressed tar file (for updating DMI schema) on Linux:
- Install the Subversion (SVN) client on Linux. To install Subversion client on Linux, refer to Installing Subversion or other relevant documentation.
- Create a temporary directory.
- Navigate to the temporary directory created in the preceding step.
- Check out the files from Subversion by executing the following
command:
svn --username=userName --password=userPwd co
dmiRepositoryURL
where userName and userPwd are the username and password required to access xml.juniper.net , and
dmiRepositoryURL
is the URL of the repository folder that you want to checkout.Examples of the DMI respository URLs are shown in Table 1.
Table 1: Sample URLs for the Repository
Type
Example URL
For the whole Junos OS family
For a device family
For a selected OS version
https://xml.juniper.net/dmi/repository/trunk/junos-ex/releases/11.2R2.4/
- Tar the
dmi
directory by executing the following command from within the directory containing thedmi
directory:tar czvf filename dmi
where filename is the same of the compressed tar file. You can use any filename as long as the extension of the file is
.tgz
or.tar.gz
The compressed tar file is now ready for uploading into Junos Space Platform.
Creating a Compressed Tar File on Microsoft Windows
To create a compressed tar file (for updating DMI schema) on Microsoft Windows:
- Install the Subversion (SVN) client on Microsoft Windows
from the following location: https://tortoisesvn.net/ .
Note To install the Subversion client, you can also use any software or tool that is equivalent to TortoiseSVN.
- Install 7-Zip to generate a compressed tar file on Microsoft
Windows by using the following link: http://www.7-zip.org/ .
Note To generate the compressed tar file, you can also use any software or tool that is equivalent to 7-Zip.
- Create a temporary folder.
Note You can use any name for the temporary folder.
- Create a folder called
dmi
within the previously created temporary folder. - Right-click the dmi folder and select SVN Checkout:
A dialog box is displayed.
- In the URL of repository field, enter the full URL of the repository. Refer to Table 1 for examples of URLs that you can enter.
- In the Checkout directory field, enter the
full path of the checkout directory; for example,
C:\test\dmi\junos-es\
.Note The portion of the path to the right of the
dmi
folder must be equivalent to the corresponding portion aftertrunk
in the URL of the repository. For example, if the repository URL is https://xml.juniper.net/dmi/repository/trunk/junos-es/ the checkout directory path isC:\test\dmi\junos-es\
, and if the repository URL is https://xml.juniper.net/dmi/repository/trunk/junos-es/releases/10.1R3/, the checkout directory path isC:\test\dmi\junos-es\releases\10.1R3\
. - In the Checkout depth field, enter Fully recursive.
- Ensure that the Omit externals check box is cleared.
- Select HEAD revision.
- Click OK, and if you are prompted to, provide
credentials.
The files are checked out from the Subversion repository into the specified folder.
- Create the tar file from the
dmi
folder using 7-Zip:- Right-click the
dmi
folder and select 7-Zip. - Click Add to Archive.
- In the Archive Format field, select tar.
- Click OK
- Right-click the
- Compress the tar file file using 7-Zip:
Right-click the
dmi.tar
file and select 7-Zip.Click Add to Archive.
In the Archive Format field, select gzip.
Click OK
- (Optional) Rename the
*.tar.gz
file to*.tgz
The compressed tar file is now ready for uploading into Junos Space Platform.
Schemas Available in Junos Space Platform
Table 2 displays information about the schemas available for use in Junos Space Network Management Platform.
Table 2: Schema Name Mapping Information
Schema Family | Device Family Series |
---|---|
junos | ACX Series/J Series/M Series/MX Series/T Series/TX Series/PTX Series/EX92xx Series |
junos-es | J Series/SRX Series/LN Series |
junos-ex | EX Series |
media-flow | Junos Content Encore |
junos-qfx | QFX Series |
junos-qf | QF |
bxos | BXOS |
tcaos | TCA Series |