Understanding vGW Series Log Collection

vGW Series Collection Tool allows you to generate log collections for the vGW Security Design VM and vGW Security VMs. You can generate log collections for:

You can provide the log collection files to the Juniper Networks Support team to be used for diagnostic troubleshooting purposes. The Collection Tool is available on the Settings module Appliance Settings > Log Collection page.

Log Collection

For some reason you might encounter problems that necessitate troubleshooting the vGW Security Design VM itself and maybe one or more vGW Security VMs that exhibit problems. The Collection Tool allows you to generate information useful in solving the problem.

When you generate log collections for the vGW Security Design VM and vGW Security VMs together, they are included in a single compressed archive file. The (TGZ) zip file contains a separate zip for each component—a zip file for the vGW Security Design VM log collection and separate zip files for the log collections of each vGW Security VM that you selected. If no vGW Security VMs were selected, the zip file contains only the logs collected for the vGW Security Design VM.

Note: Because vGW Security VM log collections are copied to the vGW Security Design VM, it is recommended that you not initiate log collections for more than three vGW Security VMs concurrently. Although the recommendation is not a restriction, typically problems encountered are constrained to a small number of vGW Security VMs, so it should not be necessary to include a large number vGW Security VMs.

To remind you of the recommendation, vGW Series displays a confirmation alert after you have selected more than three vGW Security Design VMs.

After the log collections have completed, you can directly upload the file to a support server or you can download a copy of the file to submit to the Juniper support team manually. Juniper Networks recommends that you upload the file to the support server.

Generating the Log Collections

If you do not select the check box for any of the vGW Security VMs, vGW Series generates log collections only for the vGW Security Design VM. To take this action:

  1. Click Start New Collection.

    The resulting zip file contains only the vGW Security Design VM logs.

  2. Follow the instructions in Uploading the File or Downloading the File to send the log collections to the Juniper Support team.

To use the Collection Tool to generate log collections for the vGW Security Design and one or more vGW Security VMs:

  1. Select the Get Logs check box to the right of the name of each vGW Security VM for which you want to generate a log collection. The Collection Tool generates relevant log and system files and it compresses them in a TGZ zip file. The log collections are packaged together in a single zip file with the logs for the vGW Security Design VM.
  2. Click Start New Collection.

    The log collection process begins. The Collection Tool generates the log collection for all entities in parallel. When all the log collections are copied to the vGW Security Design VM, it shows a message of Done! The log is now ready.

You can either upload the file to the support center or download a copy of the zip file containing all the log collections to your local system to submit to the Juniper Support team manually.

Note: Juniper Networks recommends that you upload the file to the support server.

Uploading the File

When you click Upload in the Upload Log Collection pane, the newest zip file is uploaded, and an ID is returned to you. The upload process encrypts the file (through AES-256), and it transfers it to a protected server. Before you upload the file, briefly describe the problem in the comment field.

To upload the file:

  1. Provide a brief description of the problem in the scroll box in the Upload Log Collection pane, and any other comments that you would like to submit.
  2. Click Upload.

    A Submitting collection to support server.... progress message is reported. When the process completes, the message Submission successful. Upload ID id-number is displayed.

    Make note of the ID, which you use to track your submission. You should refer to this ID in trouble tickets or other communication with the Juniper Networks support team about the problem.

Downloading the File

If you click Download in the Download Log Collection pane to download the file, you can send the file to Juniper Networks Support through e-mail at any time, or you can post the log collection to a server.

The downloaded file is called datacollection-date.tar.gz.

Using a Method Other Than the vGW Security Design VM to Generate Log Collections for It

When it is not possible to generate a log collection from the vGW Security Design VM, you can run the Collection Tool using another method. You can use this method to generate a log collection only for the vGW Security Design VM.

From the vGW command line interface (vGW CLI), you can use the logs collect command to generate log collections for the vGW Security Design. The command prints out the location of the file. You can then copy the file to another location using scp.

Related Documentation