2.1.2 Apple Mac OS

2.1.2.1 Preparation

For Mac OS platforms, do the following prior to installing SquidNet:

  • Make sure you have sudo/root access.
  • Make sure you have enough disk space.
  • Make sure to change the default Mac OS name from “localhost” to something more meaningful. To change, use the following commands:
  • Change: sudo scutil –set HostName <new-node-name>
  • Check: sudo scutil –get HostName
  • If using a cross-platform render farm, update Mac OS’s hosts file (/private/etc/hosts) with the IP addresses and node names of WIndows or Linux nodes.

2.1.2.2 Basic installer

To install SquidNet using the Mac OS installer, execute the following instructions:

  1. Make sure you have admin (root) access before beginning installation process.

  2. Always check the website for the latest updates.

  3. In Finder, double-click on squidnet-osx-x.xxx.dmg image file.

    _images/mac_pkg.png

    Figure 1. SquidNet DMG image.

    _images/mac_installer.png

    Figure 2. SquidNet Mac OS Installer.

    Hint

    Alternatively, you may start the installer from a terminal shell.

    >> open squidnet-osx-x.xxx.dmg
    
  4. Install as normal. Enter admin (root) password if prompted.

    Note

    The installer will place files in “/Applications/SquidNetSoftware” folder.

  1. Allow installer to finish then umount DMG image when complete.

    Tip

    From a terminal shell, you may start, stop or restart the SquidNet daemon using the following commands:

    • To start up server:
    >> sudo launchctl start com.squidnet.server
    
    • To stop server:
    >> sudo launchctl stop com.squidnet.server
    
    • To restart server:
    >> sudo launchctl restart com.squidnet.server
    

2.1.2.3 Firewall Settings

If your Mac firewall is enabled, please allow “squidnetd” to accept all incoming connections. The squidnetd daemon uses the following network ports: TCP 17394, UDP 17395, UDP 17396 and UDP 17397.

_images/mac_firewall.png

Figure 3. Mac OS Firewall.

2.1.2.4 Netbios

If using SquidNet in a mixed OSX/WINDOWS environment, make sure to set the proper NetBios/Workgroup settings in network preferences.

_images/mac_netbios.png

Figure 4. Mac OS Netbios settings.

2.1.2.5 Hosts file

Depending on your network setup, in particular your DNS server configuration, the hostname and IP address of every SquidNet Mac OS node must be added to each nodes /private/etc/hosts file.

From a terminal session, execute the following command:

>> sudo vi /private/etc/hosts

Or, use a text editor to modify /private/etc/hosts using the MAC UI.

2.1.2.6 Uninstall

To uninstall SquidNet, do the following:

  1. From a terminal, “cd” to the SquidNet installation directory /Applications/SquidNetSoftware/SquidNet and execute uninstall script squidnet-uninstall.sh.
>> sudo ./squidnet-uninstall.sh