20.5 Debugging Synchronization Activity on Your iFolder Server

You can view a log of synchronization activity on your Novell iFolder servers to help debug problems.

To enable or disable logging:

  1. If you are not logged in, go to the iFolder Management Console, click Global Settings, enter your administrator username and password, then click login. For details, see Logging In to the iFolder Management Console.

  2. From the iFolder Management Console, click Global Settings > Global Policies.

  3. Click Display Server Policies.

  4. Check the Debug Output check box to enable logging. Uncheck the Debug Output check box to disable logging.

  5. Click Update Server Policies.

To view the log, use one of the following methods, depending on the server operating system and the version of iFolder you use:

20.5.1 Using Debug Output in iFolder 2.1.x for NetWare Servers

You can view all of the synchronization activity on each NetWare server when you click Debug Output. The log information is output to the Apache screen located on each iFolder server.

20.5.2 Using Debug Output in iFolder 2.1 for Windows 2000 Servers

  1. Create a logs directory at c:\inetpub\wwwroot\iFolder\DocumentRoot.

  2. In the Windows Registry, go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\iFolderServer, then add the following line:

                       ifolderserverlogging c:\inetpub\wwwroot\iFolder\DocumentRoot\logs\index.html
    
  3. To access the log, in a Web browser, enter the DNS name or IP address of your iFolder server, followed by the directory and filename.

    For example, http://nif1.your-domain-name.com/logs/index.html, where nif1.your-domain-name.com is the actual DNS name or IP address of your iFolder server.

20.5.3 Using Debug Output in iFolder 2.1 for Linux Servers

  1. To set permissions for the logs directory to allow Apache to create and write a file for logging, at the server console prompt, enter the following command:

    chmod 760 /usr/local/apache2/ifolder/DocumentRoot/logs
    
  2. Edit the /usr/local/apache2/iFolderServer/httpd_ifolder_unix.conf file by adding the following directive to the end of the Virtual Hosts sections for both port 80 and port 443:

                      iFolderServerLogging “/usr/local/apache2/ifolder/DocumentRoot/logs/index.html”
    

    This allows iFolder to create the index.html file in the /usr/local/apache2/ifolder/DocumentRoot/logs directory and to write the synchronization activity for the iFolder server to it.

  3. Restart your Apache server by entering the following commands at the server console:

    /etc/init.d/httpd stop
    
    /etc/init.d/httpd start
    
  4. To access the iFolder log, do one of the following:

    • In your Web browser, enter the DNS name or IP address of your iFolder server, followed by the directory and filename.

      For example, go to the URL http://nif1.your-domain-name.com/logs/index.html, where nif1.your-domain-name.com is the actual DNS name or IP address of your iFolder server.

    • At the server console, enter
      tail -f pathandfilename
      

      For example,

      tail -f /usr/local/apache2/ifolder/DocumentRoot/logs/index.html
      

20.5.4 Using Debug Output in iFolder 2.1.2 for Enterprise Linux Servers

  1. To create and set permissions for a directory where the log file resides, at the server console prompt, enter the following commands:

    mkdir /var/opt/novell/ifolder/DocumentRoot/logs
    
    chmod 760 /var/opt/novell/ifolder/DocumentRoot/logs
    
    chown novlwww /var/opt/novell/ifolder/DocumentRoot/logs
    
  2. Edit the /etc/opt/novell/ifolder/httpd_ifolder_unix.conf file by adding the following directive to the end of the file:

                         iFolderServerLogging “/var/opt/novell/ifolder/DocumentRoot/logs/index.html”
    

    This allows iFolder to create the index.html file in the /var/opt/novell/ifolder/DocumentRoot/logs directory and to write the synchronization activity for the iFolder server to it.

  3. Restart your Apache server by entering the following commands at the server console:

    /etc/init.d/novell-httpd stop
    
    /etc/init.d/novell-httpd start
    
  4. To access this information, do one of the following:

    • In your Web browser, enter the DNS name or IP address of your iFolder server, followed by the directory and filename.

      For example, go to the URL http://nif1.your-domain-name.com/logs/index.html, where nif1.your-domain-name.com is the actual DNS name or IP address of your iFolder server.

    • At the server console, enter
      tail -f pathandfilename
      

      For example,

      tail -f /var/opt/novell/ifolder/DocumentRoot/logs/index.html