installation FAQ

  1. How much space will UWIN take up on my system?

    UWIN will typically use about 25-30 MB of disc space.

  2. Does it matter whether I install on a FAT partition or an NTFS partition?

    Some UNIX features will not be available if you install on a FAT partition. In particualy, UNIX file permission only work on NTFS and therefore some commands might not be secure on FAT.

  3. Are the registry keys created for UWIN? If so, where?

    Yes, registry keys are all created in

         HKEY_LOCAL_MACHINE\SOFTWARE\AT&T Labs\UWIN\
    
    Note the the directory that you choose to install UWIN will become the UWIN_ROOT which is referenced by / from UWIN. Most of the entries in the registry can be controlled by the UWIN Applet.

  4. Does it matter what directory I install UWIN in?

    No, it should not matter. However, you should install it on an NTFS file system rather than a FAT file system if possible.

  5. What is the UWIN Applet?

    The UWIN applet is a program that is invoked from the Window Control Panel which can be used to configure UWIN and to stop and start services.

  6. What is the UMS services?

    On NT/2000/XP UWIN creates a service known as the UWIN Master Service which should start up whenever you start the system. This service runs the shell script /etc/rc. In addition, the Master Service handles setuid/setgid requests and starts up UCS servers to run these requests.

  7. What does /etc/rc do?

    The script /etc/rc is executed when UMS starts up. This script is used clear out files, run inetd, and start the at/cron daemon. In addition, you can edit it to start the X11 server or the ssh daemon.

  8. What is the function of UCS in UWIN?

    A UWIN Client Service (UCS) has to be installed for every user to whom a setuid() call is to be made. Telnet-ing to a user account in UWIN, automatically installs a UCS service for that user. Alternatively, UCS services can be created by the /etc/ucs command and from the UWIN Applet.

  9. How do I restart UWIN without booting the machine?

    You can do this from the control panel under the master serice tab. You can stop the UMS service which will kill all UWIN processes and then restart the service. Alternatively, the script /etc/stop_uwin should stop all uwin processes.

  10. Does UWIN log error messages and if so where?

    The following are the list of log files associated with UWIN processes and services:

    /tmp/install_log    UWIN Installation trace
    /tmp/uwin_log    Windows API errors
    /tmp/ums.out    UWIN Master Service errors
    /tmp/ucs.out    UWIN Client Service errors

  11. How can I generate the /etc/passwd and /etc/group files?

    On NT/2000/XP the /etc/passwd and /etc/group files are generated when the UMS service starts. They can be regenerated running /etc/mkpasswd. Note, that the /etc/passwd.add will be prepended so that you can override generated entries. On Windows 95/98/ME you need to generate these manually.

  12. How can I manipulate the maximum values for IPC (inter-process communication) configurations?

    You can manipulate the IPC values using the System tab in the UWIN applet and can revert back to default values using the Restore Default button.

  13. How can I prevent anyone from telnet-ing into my machine?

    You can disable the telent service to prevent anyone from telneting into the system or you can selectively allow or disallow users by entries in the files /etc/login.allow and /etc/login.deny.

  14. How do I Enable/Disable the services like ftp, telnet, rlogin and rsh?

    You can edit the /etc/services file directly or you can do this with the UWIN Applet as follows:

    1. Open Inetd Tab of the UWIN applet.
    2. Double Click on the service name you want to enable/disable or select the service name and click on Configure button.
    3. Check/uncheck the Enable combo box.
    4. Click the OK button.

  15. Why do I get telnet: Unable to connect to remote host: Connection refused message when I try to telnet into a UWIN box?

    One of the common reasons why this happens is that the inetd may not be running on the UWIN host. First check if UMS services is running on the host machine. If UMS is not running then start uwin service. This will start inetd by default. If UMS is already running on the host, start inetd using /etc/inetd & command from the prompt.

  16. How do I start the ssh daemon?

    After you have done the key setup, you can add /usr/sbin/ssh to the /etc/profile file.


UWIN users mailgroup
Information and Software Systems Research
AT&T Research
Florham Park NJ
December 28, 2004