Running AppleShare Server in Global Debug Mode to Retrieve Logs

Overview

You may need to gather additional debugging logs for the support team to investigate an issue related to AppleShare. If you are experiencing issues with multiple workstations, you can run the server in global debug mode. Also, this mode can be used when you are experiencing issues with the AFP login, even if it is affecting only one user.

If you are experiencing issues with a single workstation, you can run the server in debug mode for a single user.

 

Warning
The global debug mode will cause KSD to run at 60-70% of its normal speed. Also, it may generate very large debug logs (many gigabytes) if it is running with many active users.

Process

  1. Stop the KSD in one of the following ways. Remember, it will disconnect all active users.
  • In Xinet Admin GUI, navigate to FILESHARE/ACLS > AppleShare Service > restart and click on the Shut Down AppleShare button.

    image4.png

  • From the shell, run /usr/etc/appletalk/ksd_restart, you will be prompted with the following questions:
    1. Do you really want to halt the AppleShare daemon?
      Type y
    2. Do you want to give the users time to disconnect[y]?
      Type y
    3. How many minutes do you want to wait[2]?
      Enter the desired amount of minutes you want to give the users to manually disconnect; the default is 2.
      We will use the default for this example: press Enter
    4. Do you want to customize the logout message[n]?
      Type n
    5. After the selected time (2 minutes in this example) have passed, the shell will show the message Killing the daemon… and will request for the final confirmation:
      Do you want to re-start the AppleShare daemon[y]?
      Type n

      image2.png
  • Run the KSD on the command line using the configuration options in the services file, but adding a debug flag and redirecting the output to a file.
    Make sure to be in a CSH shell when you run this command, or the & will not work.
    For example, if /var/adm/appletalk/services has the following listing for KSD:
    /usr/etc/appletalk/ksd -f -v -t 'localpasswd' -longcomment -i -o 'Xinet-Test', then run the below command (the changes are highlighted in bold):
     /usr/etc/appletalk/ksd -d 0xFFFF -f -v -t 'localpasswd' -longcomment -i -o 'Xinet-Test' >& /var/tmp/ksd.debug.out &


    image3.png

    Click to open image in a new tab.

  • Replicate the issue you are experiencing. It is preferable to have only one user working at that time; it will keep the debug log as small as possible, and it would be easier to track the issue.
  • Run the following command ps -eaf | grep /ksd to find the process id of the parent KSD process. Kill this process using the process id. Note that the process id is the same as reported on the second line of the picture in step 2.

    image1.png

    Click to open image in a new tab.

  • Restart the regular KSD in one of the following ways.
    • In Xinet Admin GUI, navigate to FILESHARE/ACLS > AppleShare Service > restart, and click on the Start AppleShare button.

      image5.png

    • From the shell, run /usr/etc/appletalk/ksd_restart, you will be prompted with the following question:
      Do you want to re-start the AppleShare daemon[y]?
      Type y

      image6.png

      Click to open image in a new tab.

  • Send the logs file located at /var/tmp/ksd.debug.out to NorthPlains Support for further investigation.
  • Comments

    0 comments

    Please sign in to leave a comment.