• How to create a compressed zip file in Windows, OS X, and Linux

    This article describes how to create a zip file that contains important information needed by Wowza™ Media Systems for analysis and troubleshooting. Wowza support engineers will request that you send specific configuration and log folders from your Wowza media server install directory. This is best accomplished by creating a *.zip archive that will contain several key folders.

    Contents


    Introduction
    Creating Compressed Files

    Introduction


    Typically, the following files are requested by Wowza support engineers that are investigating your issue:

    [install-dir]/conf
    [install-dir]/logs
    [install-dir]/transcoder
    [install-dir]/manager/logs


    Wowza may then request additional information, such as the following:

    • A screenshot of your exact live encoder settings.

    • A copy of your .stream file(s).

    • A sample of a problematic VOD asset (media file).

    • A sample recording of a problematic incoming stream.

    Large log files


    In most cases, the files you send to Wowza can be attached to an email and included in the support ticket. When the file attachment size is too large to be sent via email, Wowza Support suggests posting files for download by using a file-sharing service like Dropbox or by uploading them to a web or FTP server.
    Note: It's very helpful to note the server date and time when outages and problems occur.
    Also, if your production server generates a significant volume of log files, it's extremely helpful to refresh and specify a log statement, which makes for a more efficient auditing process that can reduce the overall time a support engineer will require when processing your request. If possible, please follow these simple steps:

    1. Stop your Wowza media server software.
      Note: For help starting and stopping the software, see How to start and stop Wowza Streaming Engine software.
    2. List the contents of the [install-dir]/logs folder.

    3. Rename wowzastreamingengine_access.log to wowzastreamingengine_access_OLD.log.

    4. Start your Wowza media server software.

    5. Duplicate the troubleshooting issue or set of issues.

    6. Send the new log file by using the steps outlined below.

    Creating Compressed Files


    Creating a *.zip folder archive is a simple process that varies depending on the operating system in use. There are also many excellent third-party applications that can create *.zip archives. The following sections cover steps that use available tools that are built in with each operating system.

    Creating a compressed zip file in Windows 7 and XP

    1. Using Windows Explorer, navigate to C:\Program Files (x86)\Wowza Media Systems\Wowza Streaming Engine 4.x.x.

    2. Click to highlight each folder that you need to zip.
      Note: Press Ctrl on the keyboard to select multiple folders.
    3. Right-click the file and select Send to > Compressed (zipped) Folder.

    4. Windows will create the zip file and will position the cursor where you can choose a unique name for the file. If you already have an open Wowza support ticket, name the file conf_12345.zip, logs_12345.zip, otherwise conf.zip and logs.zip.

    5. Submit a Wowza Streaming Engine Technical Support Ticket. (Technical support is included with all active monthly subscriptions and maintenance and support contracts.) In the support ticket form, provide a detailed description of the problem and attach the zipped file in the area provided.

    Creating a compressed zip file in OS X

    1. Open a new Finder window.

    2. Navigate to <root>/Library/WowzaStreamingEngine-4.x.x.
      Note: Alternatively, you can navigate to Applications/WowzaStreamingEngine.
    3. Click to highlight each folder that you need to zip.
      Note: Press command on the keyboard to select multiple folders.
    4. Select File > Compress X Items from the pull-down menu.

    5. Finder will compress the selected folders and will create a file named Archive.zip. This is your zip archive. At this point, your file can be renamed. You can choose a unique name for the file. If you already have an open Wowza support ticket, name the file conf_12345.zip, logs_12345.zip, otherwise conf.zip and logs.zip.

    6. Submit a Wowza Streaming Engine Technical Support Ticket. (Technical support is included with all active monthly subscriptions and maintenance and support contracts.) In the support ticket form, provide a detailed description of the problem and attach the zipped file in the area provided.

    Creating a compressed zip file in Linux

    1. Open a terminal session and log in to the server.

    2. Navigate to your Wowza Streaming Engine install directory:
      cd /usr/local/WowzaStreamingEngine
    3. To view a listing of directory contents, enter the following command:
      ls
    4. Note the files to be zipped (for example, /conf and /logs).

    5. Create the zip file by entering the command:
      root@ubuntu:/usr/local/WowzaStreamingEngine# ls
      applications  documentation       keys        NOTICE.txt       
      bin           dvr                 lib         QUICKSTART.html
      conf          examples            lib-native  README.html
      content       filename_12345.zip  logs        transcoder
      root@ubuntu:/usr/local/WowzaStreamingEngine# zip -r filename_12345.zip conf
        adding: conf/ (stored 0%)
        adding: conf/LiveStreamTranscoders.xml (deflated 77%)
        adding: conf/MediaCasters.xml (deflated 90%)
        ...
        ...
      root@ubuntu:/usr/local/WowzaStreamingEngine# zip -r filename_12345.zip logs
        adding: logs/ (stored 0%)
        adding: logs/wowzastreamingengine_access.log.2012-08-07 (deflated 94%)
        adding: logs/wowzastreamingengine_error.log.2012-09-07 (deflated 90%)
        ...
        ...
    6. Submit a Wowza Streaming Engine Technical Support Ticket. (Technical support is included with all active monthly subscriptions and maintenance and support contracts.) In the support ticket form, provide a detailed description of the problem and attach the zipped file in the area provided.


    Originally Published: 09-12-2012.
    Updated: For Wowza Streaming Engine on 08-11-2014.