Home

EnFuzion for Render Farms Installation and Configuration Guide

1. e eese eeeee eene e enne 7 3 1 Installing and Configuring a One Machine EnFuzion Render Farm 7 SL Geng SIANCO WI ENF UZION sseni ia E EA E A E EA E A mu ede 13 3 3 Adding More Machines to Your Render FarM iii 15 gA UNINSIQUING ENF U ION cae I E lizza 24 SES IN OX asaro iire N AE A E ANAE A AEAEE EEEE E EEEE A E 24 4 Installing EnFuzion3D v11 on the Linux Platform ri 25 4 1 Installing and Configuring a One Machine EnFuzion Render Farm esses 25 4 2 Getting Started with ERFUZION scroller 31 4 3 Adding More Machines to Your Render Farm ssi sessi eese nnne nnn ahhh naa nnns naa 33 Z4 OUDIHSTOBO ENF UZON oaa a meet ach ced a m addet d ua tu oto Ate 34 AOWD NOX shaolin 35 5 Installing EnFuzion3D v11 on the Mac OS X Platform rr 36 5 1 Installing and Configuring a One Machine EnFuzion Render Farm esses eene 36 5 2 Gelling stalled WIhEHFUZIOh eno o EE eae aise eee A inu DN RUE 41 5 3 Adding More Machines to Your Render Farm eese iiis esses snas nhanh nnns saa aan rss s aa aas nra sna 43 5a UPPS ENF UZON TET 44 DO WNUN ernea a a aE 45 6 Setting upa Shared Fil REpositorVi ul 46 b T Fileohanng With SAMA nesretna a a tee evo r doa dete ROEA 46 6 2 Setting up a Shared File Repository Summary of Steps iii 46 6 3 Configuring F
2. nennen nennen nnn nnn nnn resta nnn nnns 43 Figure 6 1 Typical EnFuzion Render Farm sss nennen nennen nnn nnn nnn annes nna nnn nnns 47 Flgure 6 2 File Preperties Dialogue aaa acilia lalla 48 Table of Tables Table 2 1 EnFuzion3D v11 Supported ConfiguratioNs enne 3 Table 2 2 Key steps to setting up EnFuzion Based Render Farm eese 4 Table 7 1 Start Stop EnFuzion on Windows platform iii 56 Table 7 2 Start Stop EnFuzion on Linux platform ii 57 Table 7 3 Start Stop EnFuzion on Mac OS X platform ii 57 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 1 Introduction Welcome to EnFuzion for Render Farms This guide describes the process of installing and running EnFuzion on a render farm This guide is organized as follows Chapter 1 Introduction Chapter 2 Overview of an EnFuzion Based Render Farm In this chapter basic EnFuzion concepts and terminology are introduced along with a recommended way to set up an EnFuzion based Render Farms Chapter 3 Installing EnFuzion3D v11 on the Windows Platform This chapter describes the steps to install EnFuzion3D v11 on the Windows Platform Chapter 4 Installing EnFuzion3D v11 on the Linux Platform This chapter describes the steps to install EnFuzion3D v11 on the Linux Platform Chapter 5 Installing EnFuzion3D v11 on
3. Figure 3 3 Provide EnFuzion User Name and Password 10 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Step 5 Next you will be prompted to tell your Compute Node how to connect to the EnFuzion Control Root Computer as shown in Figure 3 4 For your one machine render farm the name of the EnFuzion Control Root Computer should be localhost Do not change the default Port number ie Setup EnFuzion 8 2 by Axceleon Configure Compute Node How does this Compute Node connect to the Control Root computer Provide the network name or address of the Control Root computer Click Next to continue with the installation EnFuzion Control Root Host Port for Node Connections 10103 Notice The default port value 10103 rarely needs to be changed Do not change this value without changing the default EnFuzion service port on the Control Root computer Figure 3 4 Configure an EnFuzion Compute Node Step 6 As shown in Figure 3 5 next you will be prompted to configure the User Submit Computer Here you will tell the User Submit Computer to submit jobs to the EnFuzion Control Root machine at the address localhost and using the port 10102 Again do not change the default port number Click on Next to continue io Setup EnFuzion 8 2 by Axceleon De Configure User Submit Computer Newt What iz the address of the EnFuzion service on the Control Root computer Provide the network name or address of the Control Roo
4. 3 Install Render Package and EnFuzion Plug ins Where to Find Information Control Root Compute User Submit Computer Nodes Computers EnFuzion3D v11 Plug in Guide 4 Test Your Render Farm Table 2 2 Key steps to setting up EnFuzion Based Render Farm ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE This guide the EnFuzion3D v11 Installation and Configuration Guide provides the information on how to accomplish steps 1 and 2 in the table above The EnFuzion3D v11 Plug in Guide provides the information on steps 3 and 4 2 5 How dol start Axceleon strongly recommends that all first time users of EnFuzion follow the steps below start simple and gradually build up your EnFuzion render farm e Step 1 Setup a one machine EnFuzion render farm as shown in Figure 2 3 This machine will serve as a User Submit Computer an EnFuzion Control Root Computer and an EnFuzion Compute Node at the same time Figure 2 3 A one machine EnFuzion Render Farm e Step 2 Setup the designated EnFuzion Control Root Computer for your render farm Install and configure your real EnFuzion Control Root Computer Figure 2 4 Install and configure an EnFuzion Control Root Computer e Step 3 Set up a typical EnFuzion render farm cluster by adding more User Submit Computers and EnFuzion Compute Nodes to the EnFuzion Control Root Computer which you set up earlier If you are setting up a heterogeneous render farm make sure you i
5. ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Step 3 Load the share description to Netlnfo with the following command in the Terminal niload EZSLtsD lt TSEAD Step 4 Reboot the machine Step 5 Confirm the SMB mount with the following steps e Login as enfuzion e Navigate to the mnt SharedRepository directory and confirm that you can read and write files in the directory 6 5 3 Configuring a Mac OS X SMB Client on an User Submit Computer On a Mac OS X based User Submit Computer you do not need to do anything to enable the SMB Client Once a SMB Server has been properly configured you can connect to the SMB Server with the steps below e Select Finder gt Go gt Connect to Server to open the Connect to Server dialogue window e Inthe dialogue window enter smb Name of the SMB server gt lt share name Example We have a Shared File Repository located on the machine with the IP 192 168 0 160 SharedRepository which is running as a SMB Server To mount the Shared File Repository from a User Submit Computer select Finder gt Go gt Connect to Server to open the Connect to Server dialogue window In the dialogue window enter smb 192 168 0 160 SharedRepository 52 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 6 5 4 Configuring Mac OS X Based NFS Server The simplest way to configure NFS on an Mac OS X based system is using the NFS Manager utility You can download the NFS
6. Search the Web PSearch Address http localhost 10101 summary html v Ee Links gt Y search web fay gue Shopping Mail my Yahoo Fj Games Basketball SP Personals Music X axcelean fe more EnFuzion 8 2 e Updated Fri May 13 22 12 56 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluster my lp2cv2bo2ef1 10102 Nodes Nodes 1 Runs Runs 0 Messages Time Object Message Done amp J Local intranet Figure 3 7 One machine render farm running 12 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE If for any reason that the EnFuzion Web Interface did not start automatically you can start it manually by opening your web browser of choice and enter as the URL http lt EnFuzion Control Root gt 10101 Please reference the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d fag htm if you re unable to open the EnFuzion Web Interface By completing all the steps in the previous sections you have successfully setup and configured a one machine render farm 3 1 6 Common Installation Problems The most common installation problems can lead to the following symptoms at the end of the installation process e Some or all of the required EnFuzion processes enfDispatcher enfeye enfNodeServer and enfStarterSvc are not running e You cannot connect to the En
7. EnFuzion 8 2 by Axceleon Completing the EnFuzion Setup Wizard Setup has finished installing and configuring EnFuzion on pour computer Click Finish to perform the tasks below and exit Setup Register EnFuzion Control Root service Start EnFuzion Control Root service Figure 3 13 Register and Start EnFuzion Root service Step 7 Verify that the EnFuzion Control Root Computer is working by using the Windows Task Manager You should see two new EnFuzion processes running the enfDispatcher exe and enfeye exe 18 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Step 8 You can also open the EnFuzion Web Interface to verify that your EnFuzion Control Root Computer is running Open your web browser of choice and type in the following URL as shown in Figure 3 14 http IP Address of your Control Root Computer gt 10101 Once the EnFuzion Web Interface is open click on Cluster to see the status of your render farm Cluster Summary Microsoft Internet Explorer File Edit View Favorites Tools Help Q sack E M x E Search ste Favorites media Address http localhost 10101 summary html vw E o Links Nr v Search Web e attempting to retrieve buttons From Yahoo 1 axceleon MAE EnFuzion 8 2 e Updated Sat May 14 16 09 44 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Clust
8. the Terminal application EnFuzion Services Mac OS X Stop Service ibrar r killall enfdi h e enfdispatcher i EnFuzionEnFuzion killall enfeye bin e enfeye bin sudo Library Startupltems EnFuzionNode lallallteninodesenier EnFuzionNode EnFuzion Node Service e enfnodeserver Table 7 3 Start Stop EnFuzion on Mac OS X platform You can also use the Activity Monitor application to kill the processes instead of the command line in the Terminal 57 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 7 6 Upgrading your EnFuzion Installation On the Windows platform the graphical installer will prompt you to upgrade your installation of EnFuzion if an older release is detected on your machine You should install the new version of EnFuzion at the same location as your old version so that all of your user configurations files will be used by the new version of EnFuzion The new EnFuzion configuration files will be created with a new extension You can decide when you want to upgrade to the new version of configuration files On the Linux and Mac OS X platform to upgrade your EnFuzion version simply install the new version at the location of the older version EnFuzion will preserve your user configuration files The new EnFuzion configuration files will be created with a new extension You can decide when you want to upgrade to the new version of configuration files 7 7 Choosing Between the EnFuzion Setup
9. 3 2 io Setup EnFuzion 8 2 by Axceleon Select Components Which components should be installed Select the components you want to install clear the components vou do not want to install Click Nest when vau are ready to continue Test Install on One Computer Compute Node User Submit Computer Current selection requires at least 8 2 MB of disk space Figure 3 2 Test Install on One Computer ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Step 2 Proceed by clicking the Next button and follow all the default values which are preset to ensure the easiest startup experience Step 3 When prompted to provide an EnFuzion License File please browse to locate your enflicense txt file Step 4 As shown in Figure 3 3 next you will be prompted for the EnFuzion User Name and Password which will be used by the EnFuzion program on this machine Enter the valid user name and password which you have created earlier 15 Setup EnFuzion 8 2 by Axceleon EnFuzion User Account and Password Which user account can EnFuzion use on this compute node Provide EnFuzion with the user account and password to use on this compute node Make sure that the account exists and that it has a valid password NOTICE Setup will not create an EnFuzion user account for vou IF you have not yet created an EnFuzion user account please create an account before proceeding User Mame enfuzion Password Password Confirmation
10. 8 Install EnFuzion Using the Command Line Setup Program Please refer to the EnFuzion User Manual for a complete description on how to use the command line setup program for all platforms 7 9 Additional Information For addition information on EnFuzion please refer to the EnFuzion User Manual For technical support please contact Axceleon at support axceleon com 58
11. Components Which components should be installed Select the components you want to install clear the components you do not want to install Click Next when you are ready to continue EnFuzion Service on the Control Root COMPUre Mode C User Submit Computer Current selection requires at least 4 0 ME of disk space Cancel _ Figure 3 11 Install and configure an EnFuzion Control Root Computer Step 4 When prompted to select addition tasks you want the setup wizard to perform choose Register and Start EnFuzion Service as shown in Figure 3 12 This means that the setup wizard will start the EnFuzion Control Root Computer running after it is installed 17 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE iG Setup EnFuzion 8 2 by Axceleon Select Additional Tasks Which additional tasks should be performed Select the additional tasks you would like Setup to perform while installing EnFuzion then click Next EnFuzion Service on the Control Root Register and Start EnFuzion Service Figure 3 12 Start EnFuzion Service on the Control Root Computer Step 5 Browse to locate the EnFuzion license file when prompted Click Next to proceed with the installation Step 6 Finish the installation process by registering and starting the EnFuzion Root services as the default values suggest Click Finish to conclude EnFuzion Control Root Computer installation as shown in Figure 3 13 o Setup
12. Compute Node On a Windows based Compute Node you do not need to do anything to enable a SMB Client Once a SMB Server has been properly configured verify that you can access shared files in your Shared File Repository by selecting Windows gt Start gt My Network Places on the Compute Node 6 3 4 For Al Windows Users Only For all Windows users it is possible to start without a central Shared File Repository For the render package you use you can simply share your entire Project Directory on your own computer including the Image Directory Remember to explicitly enable the following while setting up sharing of your Project Directory e Share this folder on the network e Allow network users to change my files This enables all Compute Nodes to read Scene files from your shared drive and write the rendered Images back 6 4 Configuring File Sharing on Linux Based Computers This section provides the information on configuring Linux machines for SMB based file sharing including e Howto enable file sharing on a Linux based SMB Server and e How to configure Linux based SMB Clients on User Submit Computers and the Compute Nodes Please see below for details 6 4 1 Configuring a Linux SMB Server The steps to enable file sharing on a Linux SMB Server are beyond the scope of this guide Please contact your systems administrator or contact Axceleon if you have questions on how to set up a Linux server for file sharing 6 4 2 Configuring a Li
13. Computer Make sure you do not have more than one Control Root Computer One at a time add more Compute Nodes to your render farm After each Compute Node is added make sure it is running by checking the Nodes page from the EnFuzion Web Interface One at a time add more User Submit Computers to your render farm After each User Submit Computer make sure that you can successfully start the EnFuzion Web Interface from it You must also install and license all the rendering packages you wish to use on each Compute Node and each User Submit Computer Your render farm will not work until you have set up and configured your Shared File Repository You must read Chapter 6 Setting up a Shared File Repository and follow the directions therein to set up a Shared File Repository You must also read Chapter 15 Render Farm Administrator Guide in the Plug in Guide for additional required configuration steps for Compute Nodes and User Submit Computers The directions on installing and testing Windows based Control Root Compute Nodes and User Submit Computers are below If you have a heterogeneous render farm you can find directions on installing and testing Linux and Mac OS X based components are in Chapter 4 and Chapter 5 respectively 3 3 3 Installing EnFuzion from a Download Package An EnFuzion download package for Windows users is named enfuzion 3d setup version build zip e g enfuzion 3d setup 9 0 05204 zip Unzipped the zip file t
14. EnFuzion 2 Compute Node Utilities Unregister EnFuzion Node Service and e Choose Windows Start All Programs EnFuzion Uninstall EnFuzion 3 5 What Next Render farm administrators and artists alike should proceed to the Plug in Guide from here 24 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 4 Installing EnFuzion3D v11 on the Linux Platform This chapter describes the steps to install EnFuzion3D v11 on the Linux Platform This chapter is organized as follows e Installing a One Machine EnFuzion Render Farm e Getting Familiar with Your One Machine Render Farm e Adding More Machines to Your Render Farm If you have been using an earlier version of EnFuzion3D v11 and wish to upgrade your installation please go to Chapter 7 Upgrading a Previous Installation of EnFuzion 4 1 Installing and Configuring a One Machine EnFuzion Render Farm This section describes the steps to install EnFuzion3D v11 for the first time This section provides the step by step instructions to help you install and configure a one machine EnFuzion render farm IMPORTANT Axceleon strongly recommends all first time users to start here 4 1 1 Before You Begin e EnFuzion does not have any special installation requirements for hardware or software Any Linux based system is suitable However please note that your choice of hardware will directly affect the performance of your render farm e Identify the computer which you will set up as y
15. Login as the root super user by executing Su provide root password e Create the enfuzion user account by executing adduser enfuzion e Specify a password for the enfuzion user by executing passwd enfuzion specify enfuzion password Supply a password when prompted This completes the steps to create an enfuzion user 4 1 4 Installing and Configuring the EnFuzion Control Root Computer The steps to installing and configuring the EnFuzion Control Root Computer are as follows e Make sure that you have created an enfuzion user account on the EnFuzion Control Root Computer See Section 4 1 3 for directions e Onthe Control Root Computer login as the enfuzion user su enfuzion lt provide password for the enfuzion user gt Please make sure to include the after su to change the working directory to the enfuzion user home directory 26 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Copy the EnFuzion installation package to a location under the enfuzion users home directory The EnFuzion installation package format for Linux is enfuzion linux tar gz e Unpack the EnFuzion installation package using the following command bar zxwvri ent uzxrion linux taridgx e Change your working directory to the unpacked EnFuzion installation package cd enfuzion linux e Execute the install root script to install the EnFuzion files for the Control Root Computer install root EnFuzion files will be installed
16. Manager utility from http z www bresink com osx NFSManager html Using the NFS Manager the steps to configuring an NFS Server on a Mac OS X based system are as follows e Install and start NFS Manager e Select NFS Shares e Click on the Lock and provide administrator s credentials e Click on Add Entry e Select the folder to share e Select Any computer no restrictions e Under Options specify Treat all users as user enfuzion e Leave all other options unchecked e Click OK e Click Activate Changes After you configure the NFS Server test it by doing the following e n NFS Manager select List Remote NFS Shares e Inthe Server field type localhost e Under Folder there should be the shared folder e Under Options it should say mapall enfuzion This completes the configuration of the NFS Server on a Mac OS X based system This configuration must be done once on the machine that is used as a file server 6 5 5 Configuring a Mac OS X Based NFS Client on an EnFuzion Compute Node The simplest way to configure NFS on a Mac OS X based system is using the NFS Manager utility You can download the NFS Manager utility from http www bresink com osx NFSManager html Using the NFS Manager the steps to configuring a NFS Client on a Mac OS X based system are as follows e Open NFS Manager e Verify that the NFS Server is operational e Select Computer List Remote NFS Shares e Enter Server name press List 53 ENFUZION FOR RENDER FARMS IN
17. N Submit Computers EnFuzion Compute Nodes Shared Repository File Server Figure 5 7 A typical EnFuzion Render farm 5 3 1 Before You Begin e identify a computer that will be the EnFuzion Control Root Computer for your render farm Since the EnFuzion Control Root Computer controls all EnFuzion activities in a render farm it is important that the EnFuzion Control Root Computer runs continuously and that it has sufficient disk space to hold user input and output files e he EnFuzion Control Root Computer must have a fixed IP address You cannot use DHCP to allocate different IP addresses for the EnFuzion Root Computer 43 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e EnFuzion does not have any special installation requirements for hardware or software Any Mac OS X based system is suitable for EnFuzion User Submit Computers and EnFuzion Compute Nodes However please note that your choice of hardware will directly affect the performance of your render farm e Identify all the EnFuzion Compute Nodes and all the User Submit Computers on your render farm e You will need a valid EnFuzion license key in the form of a file called enflicense txt f you do not have a valid license key please contact Axceleon at sales axceleon com 5 3 2 Summary of Steps The recommended steps to building and testing a bigger EnFuzion render farm are as follows e Always start with a one machine configuration add more machine
18. Wizard and the EnFuzion Command Line Setup Program Prior to version 8 2 service pack 1 EnFuzion was installed with a command line setup program on all platforms The command line setup program provides experienced users with added flexibility and control It is also batch friendly allowing users to install EnFuzion from user command line scripts The command line setup program is still provided with EnFuzion 8 2 and later releases With EnFuzion 8 2 service pack 1 and later releases Windows users have an additional option of using the new EnFuzion Setup Wizard The new Setup Wizard brings a graphical and intuitive way of installing EnFuzion The EnFuzion Setup Wizard and the command line setup program are functionally identical they both install EnFuzion However there are some differences between the two due to backward compatibility constraints While choosing between the two installation upgrade methods please note the following e Regardless how release N was installed you can always safely upgrade to release N 1 using the graphical setup wizard e You can always upgrade your EnFuzion installation using the same method as you originally used to install it e itis not safe to upgrade an EnFuzion installation using the command line setup program if it was originally installed using the graphical setup wizard In this case you should uninstall the old version first before installing the new version with the command line installer 7
19. a Shared Test Directory are as follows Please do this before proceeding to the next section e Create a directory in Users Shared for example Users Shared EnFuzionShared e Share this directory by allowing Owner Group and Others to have Read amp Write Access as shown in Figure 5 1 e Make sure to choose Apply to enclosed items A EnFuzionShared Info EnFuzionShared Zero KB E Modified Today at 10 02 PM w General Kind Folder Size Zero KB on disk Zero bytes Where Users Shared Created Today at 10 02 PM Modified Today at 10 02 PM Color label x o 6 9 Locked le More Info le Name amp Extension eoo 7 Shared EM eee Pm E zm t Q Y Ownership amp Permissions laut You can Read amp Write H Network n L Macintosh HD Ls E f w Details Ij _ LEXAR MEDIA Owner test vo da Alias Autodesk GarageBand Demo Sa 5 Desktop 9 Access Read amp Write Hj test A A Applications Group wheel m H 13 Documents si Movies Access Read amp Write Hj Music EnFuzionShared B Pictures SSS SE Others Read amp Write Hd m gt 5 items 49 b AValtaDie WY Apply to enclosed items Figure 5 6 Create a Shared Test Directory 42 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE This Shared Test Directory for your one machine render farm serves as your temporary Sha
20. a successful installation of the Control Root Computer you should see the EnFuzion Web Interface as shown in Figure 5 2 6 6 Cluster Summary http localhost 10101 summary html DO Apple 45 v Amazon eBay Yahoo News 82 v DA E 3E ELE Do more EnFuzion 9 0 Updated Fri Dec 22 20 46 04 2006 Root mini2 local 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluster mini2 local 10102 Nodes 0 0 0 0 0 7 Figure 5 2 Control Root as Seen from the EnFuzion Web Interface 38 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE If you do not see the Web page please see the section below titled Common Installation Problems Please make sure this step is successful before you continue to the next installation step 5 1 5 Installing EnFuzion on an EnFuzion Compute Node The steps to install and configure an EnFuzion Compute Node are as follows e Make sure that you have created an enfuzion user account on the EnFuzion Compute Node See Section 5 1 3 for directions e Login as the enfuzion user e Copy the EnFuzion installation package to the enfuzion user s Desktop or home directory The EnFuzion installation package for Mac OS X is called enfuzion 3d version darwin version ppc32 tgz e Double click on the installation package to unpack it This will result in a directory with the installer programs e Install the E
21. in the HOME enfuzion directory e Install the EnFuzion license key Obtain a file with an EnFuzion license key and copy it to the EnFuzion config directory The file with the EnFuzion license key must be named enflicense txt The location of the config directory is HOME enfuzion config Gp enflicense txt HOMB enfuzron config This completes the installation of the EnFuzion package and the license key on your Control Root Computer The remaining step of configuring the Control Root Computer is to set up EnFuzion as a service so that it is started automatically e Change your working directory to the unpacked EnFuzion installation package Cd emr zron lrnux e Onthe Control Root Computer login as the root super user Su lt provide root password gt Execute the install service script to install the EnFuzion service install service e To start EnFuzion reboot the computer or execute Leto IME cay enum Start 27 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 4 1 5 Installing EnFuzion on an EnFuzion Compute Node The steps to installing and configuring an EnFuzion Compute Node are as follows The steps must be repeated on each Compute Node in your render farm e Make sure that you have created an enfuzion user account on the EnFuzion Compute Node See Section 4 1 3 for directions e On the Compute Node login as the enfuzion user su enfuzion provide password for the enfuzion user 17 17 Please make
22. new Computer Node is running 3 3 7 EnFuzion Node Start up Script for Windows based Compute Nodes EnFuzion requires users to supply a Node Start up Script for each Windows based Compute Node EnFuzion executes this Node Start up Script each time a Compute Node is started or restarted and causes the Compute Node to mount your Shared File Repository Failure to provide a Node Start up Script for a Compute Node may cause rendering to fail on that node Please refer to Chapter 6 for information on how to set up a Shared File Repository An EnFuzion Node Start up Script must be named startup bat and it must be placed in the EnFuzion_Installation_Directory bin directory on each Compute Node The script must conform in syntax to a Windows batch file An example startup bat is provided in the EnFuzion Installation Directory bin directory Please modify this file to adapt it for your environment After you make any changes to a startup bat file on a Compute Node you must restart the EnFuzion Node Service on that Compute Node To do this choose Windows Start All Programs 3 EnFuzion 32 Compute Node Utilities from there choose Stop EnFuzion Node Service gt Register EnFuzion Node Service and finally gt Start EnFuzion Node Service There is no equivalent to startup bat on Mac OS X and Linux platforms 3 3 8 Installing and Configuring a User Submit Computer Step 1 Identify the first User Submit Computer you will install and confi
23. the Mac OS X Platform This chapter describes the steps to install EnFuzion3D v11 on the Mac OS X Platform Chapter 6 Setting up a Shared File Repository The EnFuzion plug ins for rendering packages require that all scenes files texture files and other project files are stored in a shared file repository and that they are accessible by all the compute nodes and from all the user submit computers This chapter provides the information on how to set up a shared file repository Chapter 7 Upgrading a Previous Installation of EnFuzion This Chapter provides key information on how to upgrade an existing installation of EnFuzion All current users of EnFuzion should consult this chapter before performing an upgrade Please review this guide and follow all installation procedures closely ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 2 Overview of an EnFuzion Based Render Farm In this chapter basic EnFuzion concepts and terminology are introduced along with a recommended way to set up a render farm with EnFuzion 2 1 Key Components of an EnFuzion Based Render Farm A typical EnFuzion based Render farm is illustrated in Figure 2 1 EnFuzion Control Root Computer EnFuzion User N M N Submit Computers EnFuzion Compute Nodes Shared Repository File Server Figure 2 1 A typical EnFuzion Based Render Farms Key components of an EnFuzion based render farm are as follows e EnFuzion User Submit Co
24. the user account and password information to the setup wizard for this EnFuzion Computer Node as shown in Figure 3 16 437 ilo Setup EnFuzion 8 2 by Axceleon EnFuzion User Account and Password UN Which user account can EnFuzion use an this compute node X Provide EnFuzion with the user account and password to use on this compute node Make sure that the account exists and that it has a valid password NOTICE Setup will not create an EnFuzion user account for you IF you have not yet created an EnFuzion user account please create an account before proceeding User Name enfuzion Password Password Confirmation Figure 3 16 Provide User Name and Password for a Compute Node Step 4 Next tell this Compute Node how to connect to your EnFuzion Control Root Computer Make sure to enter the correct IP address of the computer which you have set up as the EnFuzion Control Root Computer earlier See Figure 3 17 20 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE ie Setup EnFuzion 8 2 by Axceleon Configure Compute Node How does this Compute Made connect to the Control Root computer Provide the network name or address of the Control Root computer Click Next to continue with the installation EnFuzion Control Root Host 132 158 0 10 Part for Node Connections 10103 Notice The default port value 10103 rarely needs to be changed Do not change this value without changing the default EnFu
25. FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 3 3 1 3 3 2 Before You Begin Identify a computer that will be the EnFuzion Control Root Computer for your render farm Since the EnFuzion Control Root Computer controls all EnFuzion activities in a render farm it is important that the EnFuzion Control Root Computer runs continuously and that it has sufficient disk space to hold user input and output files The EnFuzion Control Root Computer must have a fixed IP address You cannot use DHCP to allocate different IP addresses for the EnFuzion Control Root Computer EnFuzion does not have any special installation requirements for hardware or software Any Windows based system is suitable for EnFuzion User Submit Computers and EnFuzion Compute Nodes However please note that your choice of hardware will directly affect the performance of your render farm Administrative User Rights are required to install EnFuzion although EnFuzion users do not need Administrative User Rights to use EnFuzion once it is installed You will need a valid EnFuzion license key in the form of a file called enflicense txt If you do not have a valid license key please contact Axceleon at sales axceleon com Summary of Steps The recommended steps to building and testing a bigger EnFuzion render farm are as follows Always start with a one machine configuration add more machines to it and test as you go Each render farm can have only one Control Root
26. Fuzion Web Interface e he EnFuzion3D v11 Interface runs sluggishly Most common installation problems have to do with expired license key files blocked port numbers and antivirus software Diagnostic tips and solutions for these problems can be found in the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d faq htm Please make sure to peruse the Troubleshooting Guide on line if you encounter any installation problems 3 2 Getting Started with EnFuzion This section takes you through a quick test drive of EnFuzion using the one machine render farm that you have installed and configured 3 2 1 Understanding Your One Machine Render Farm By successfully completing the procedure in the previous sections you have installed and configured a one machine EnFuzion render farm as shown in Figure 3 8 n this render farm the EnFuzion Control Root Computer the User Submit Computer and the EnFuzion Compute Node all reside in the same machine giving you a simple render farm configuration to learn and to explore EnFuzion features Figure 3 8 The One Machine EnFuzion Render farm 13 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 3 2 2 The EnFuzion Web Interface The EnFuzion Web Interface as shown in Figure 3 9 is intended mostly for render farm administrators to monitor and control various aspects of the render farm operations The EnFuzion User Manual provides a complete description of the EnFuzion Web Inter
27. STALLATION AND CONFIGURATION GUIDE e An NFS share name should be shown e Define an NFS Client e Click on the main NFS Manager dialog e Click on the Lock and enter credentials e Select NFS Entry menu at the top New Connection e Enter NFS Server NFS Share e Unselect Connect as read only folder e Click OK which closes the dialog e Click Activate Changes in the main dialog e Quit NFS Manager The NFS share should appear as another entry in the left column in the Finder This configuration must be done once on each render node 6 5 6 Configuring a Mac OS X Based NFS Client on an User Submit Computer Please contact your system administrator on how to access a NFS server from User Submit Computers 54 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 7 Upgrading a Previous Installation of EnFuzion This Chapter provides key information on how to upgrade an existing installation of EnFuzion All current users of EnFuzion should consult this chapter before performing an upgrade Key topics addressed in this chapter are e Planning an EnFuzion upgrade e Updating your EnFuzion license file e Re hosting your EnFuzion Control Root Computer e Managing different versions of EnFuzion e Start stop EnFuzion services e Choosing between the EnFuzion Setup Wizard and the EnFuzion command line setup program e How to install EnFuzion using the command line setup program e Upgrading your EnFuzion installation 7 1 P
28. account should be used for the installation of the EnFuzion on the Control Root Computer and the Compute Node A regular user account should be used for EnFuzion on the User Submit Computer 5 1 4 Installing EnFuzion on the Control Root Computer The steps to install and configure the EnFuzion Control Root Computer are as follows e Make sure that you have created an enfuzion user account on the EnFuzion Control Root Computer See Section 5 1 3 for directions e Login as the enfuzion user e Copy the EnFuzion installation package to the enfuzion user s Desktop or home directory The EnFuzion installation package for Mac OS X is called enfuzion 3d lt version gt darwin lt version gt ppc32 tgz e Double click on the installation package to unpack it This will create a directory with the installer programs e Install the EnFuzion Control Root Computer by running the InstallRoot application as shown in Figure 5 1 37 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 00 enfuzion 3d 9 0 12702 darwin 7 0 ppc32 cO EE Es Le e Network El Macintosh HD distrib InstallNode InstallRoot mE Desktop T enfuzion M A Applications InstallSubmit 5 Documents a Movies 6 Music Pictures Figure 5 1 The EnFuzion Installer Programs e When you are prompted to install the EnFuzion license key file select the enflicense txt file sent to you by Axceleon Upon
29. change this value without changing the default EnFuzion service port on the Control Foot computer Figure 3 20 Provide Control Root Computer address to a User Submit Computer Step 5 Continue and finish installation by clicking on Next At the end a web browser will be started for you 23 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Please reference the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d fag htm if you re unable to open the EnFuzion Web Interface 3 4 Uninstalling EnFuzion This section provides information on how to uninstall EnFuzion from the User Submit Computers the Control Root Computer and the Compute Nodes Please note that there is no need to uninstall EnFuzion prior to an upgrade unless you are specifically told otherwise by Axceleon To uninstall EnFuzion on the User Submit Computers e Choose Windows Start All Programs EnFuzion Uninstall EnFuzion To uninstall EnFuzion on the Control Root Computer e Choose Windows Start All Programs EnFuzion 3 Control Root Utilities Stop EnFuzion Root Service e Choose Windows Start All Programs gt EnFuzion Control Root Utilities Unregister EnFuzion Root Service and e Choose Windows Start All Programs EnFuzion Uninstall EnFuzion To uninstall EnFuzion on the Compute Nodes e Choose Windows Start All Programs gt EnFuzion Compute Node Utilities Stop EnFuzion Node Service e Choose Windows Start All Programs gt
30. dministrator or contact Axceleon if you have questions on how to set up a Mac OS X based server for file sharing 6 5 2 Configuring a Mac OS X Based SMB Client on an EnFuzion Compute Node To configure a SMB Client on a Mac OS X based Compute Node please follow the steps below Step 1 Create a mount point Open the Terminal application and type the following command mkdir p mnt share name Example We have a Shared File Repository located on the machine 192 168 0 160 SharedRepository We wish to configure a Mac OS X based Compute Node to mount this repository in the directory mnt SharedRepository Create a mount point with the following command mkdir p mnt SharedRepository Step 2 Create a share description file fstab on the Compute Node Open the Terminal application and type the following command to create the file echo server name gt lt share name mnt lt share name url smb enfuzion lt password gt lt server name gt lt share name uid enfuzio n gid enfuzion 0 0 gt fstab Example We have a Shared File Repository located on the machine 192 168 0 160 SharedRepository We wish to configure a Mac OS X based Compute Node to mount this repository in the directory mnt SharedRepository Create an fstab file with the following line echo 192 168 0 160 SharedRepository mnt SharedRepository url smb enfuzion enfuzion 192 168 0 160 SharedRepository uid enfuzion gid enfuzion 0 0 gt fstab 51
31. e EnFuzion does not have any special installation requirements for hardware or software Any Windows based system is suitable However please note that your choice of hardware will directly affect the performance of your render farm e Identify the computer which you will set up as your one machine render farm The computer must have sufficient disk space to hold EnFuzion files and user submission and log files At least 30Mb of available disk space is recommended e You will need a valid EnFuzion license key in the form of a file called enflicense txt f you do not have a valid license key please contact Axceleon at sales axceleon com e Administrative User Rights are required to install EnFuzion although EnFuzion users do not need Administrative User Rights to use EnFuzion once it is installed 3 1 2 Create an enfuzion User Account On Compute Nodes EnFuzion needs a user account to run under We recommend that you create a user called enfuzion Since you are setting up a one machine render farm this machine will serve as a Compute Node and therefore it needs an enfuzion user account ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Create an enfuzion user account on the machine you have identified as your one machine render farm You can do so by following the directions from Microsoft for your version of the Windows operating system We suggest that you name this user account enfuzion and give it a valid password The enf
32. e completed all the steps in Sections 4 1 and 4 2 successfully If you have not gotten EnFuzion to work successfully with your rendering package on your one machine render farm please return to Section 4 2 wa 7 a N EnFuzion Control ponas Root Computer EnFuzion User N Pd VI Submit Computers EnFuzion Compute Nodes Shared Repository File Server Figure 4 4 A typical EnFuzion Render farm 33 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 4 3 1 4 3 2 Before You Begin Identify a computer that will be the EnFuzion Control Root Computer for your render farm Since the EnFuzion Control Root Computer controls all EnFuzion activities in a render farm it is important that the EnFuzion Control Root Computer runs continuously and that it has sufficient disk space to hold user input and output files The EnFuzion Control Root Computer must have a fixed IP address You cannot use DHCP to allocate IP different IP addresses for the EnFuzion Control Root Computer EnFuzion does not have any special installation requirements for hardware or software Any Linux based system is suitable for EnFuzion User Submit Computers and EnFuzion Compute Nodes However please note that your choice of hardware will directly affect the performance of your render farm Identify all the EnFuzion Compute Nodes and all the User Submit Computers on your render farm You will need a valid EnFuzion license key in the form of a
33. eeeeeessaaaeeeess 20 Figure 3 16 Provide User Name and Password for a Compute Node 20 Figure 3 17 Configure the Compute Node with Control Root computer address 21 Figure 3 18 Confirm the new Computer Node is running nnne 22 Figure 3 19 Install and Configure an EnFuzion User Submit Computer eeeeeeeeeeeeeeess 23 Figure 3 20 Provide Control Root Computer address to a User Submit Computer 23 Figure 4 1 One machine render farm running sese nennen nennen nnn nnn nnns ann nnns nnn nnn nnns 30 Figure 4 2 The One Machine EnFuzion Render farm ei 31 Figure 4 3 EnFUZION Wep IMEA CE a sac alla ail 32 Figure 4 4 A typical EnFuzion Renderfarn ec otio n et v gast cet aaa eve Us nuu ure o FANS usen 33 Figure 5 1 The EriFuzion Installer Programs uisvdeansetorexdretusevtutuvevet had eto Venue use teen aria 38 Figure 5 2 Control Root as Seen from the EnFuzion Web Interface 38 Figure 5 3 Compute Node Running as Seen from the EnFuzion Web Interface 39 Figure 5 4 The EnFuzion Render Farms InterfaCe i 40 Figure 5 5 The One Machine EnFuzion Render farm nennen nennen nnne nnn nnns 41 Figure 5 6 Create a Shared Test Directory esses nennen nennen nnne ann nnns 42 Figure 5 7 A typical EnFuzion Render farm
34. endering packages require that all scene files texture files and other project files are stored in a Shared File Repository and that they are accessible by all the Compute Nodes and from all the User Submit Computers This chapter provides the information on how to set up a Shared File Repository 6 1 File Sharing with Samba SMB is the default file sharing protocol implemented by Windows Samba is the most commonly used file sharing program which mimics the SMB protocol on Linux and Mac OS X platforms Samba therefore allows machines which run Linux and Mac OS X to share files with Windows machines using the SMB protocol Most likely you already have Samba and SMB because e Samba is distributed with most Linux and Mac OS X software distributions e You have SMB by default on Windows The instructions and examples in this guide show you how to set up and configure file sharing with SMB and Samba If you wish to use another file sharing protocol such as NFS please contact Axceleon For more information on Samba or to download it please visit www samba org 6 2 Setting up a Shared File Repository Summary of Steps Recall that a typical EnFuzion render farm consists of the following parts as shown in Figure 6 1 below 46 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE BS EnFuzion Control Root Computer EA EnFuzion User N mM Submit Computers SMB Clients EnFuzion Compute Nodes Shared Repository SMB Client
35. er Submit Computer please follow the steps below Step 1 Step 2 the file Step 3 Step 4 Login as a root super user and create a mount point with the following command mkdir p mnt lt share name gt Create a share description in the etc fstab file on the Compute Node by adding the following line to server name gt lt share name gt mnt lt share name gt smors username enfuzion password lt password gt uid enfuzion gid enfuzion 0 0 Mount the new share with the following command mount mnt lt share name gt Confirm the SMB mount with the following steps 50 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Login using your normal user login not as the enfuzion user e From a command prompt type cd mnt lt share_name gt and confirm that files can be read from and written to the Shared File Repository 6 5 Configuring File Sharing on Mac OS X Based Computers This section provides the information on working with Mac OS X and SMB based file sharing including e How to enable file sharing on a Mac OS X based SMB Server and e Howto configure Mac OS X based SMB Clients on User Submit Computers and the Compute Nodes e Howto configure NFS based file sharing on Mac OS X Please see below for details 6 5 1 Configuring a Mac OS X Based SMB Server The steps to configure a Mac OS X based Samba SMB Server for file sharing are beyond the scope of this guide Please contact your systems a
36. er my lp2 cv2bo2 ef1 10102 my lp2cv2bo2efi10102 P 50 n800 50231 Nodes Nodes 1 Runs Runs 0 amp I amp Local intranet Figure 3 14 The EnFuzion Web Interface 3 3 6 Installing and Configuring an EnFuzion Compute Node Step 1 Create an enfuzion user on each Compute Node On Compute Nodes EnFuzion runs under a user name of your choice We recommend that you create a user called enfuzion and give it a valid password The enfuzion user does not need administrative user rights You can do so by following the directions from Microsoft for your version of the Windows operating system You will need to do this for every Compute Node on your render farm Please complete this step before proceeding Step 2 Identify the first Compute Node you will install and configure Start the EnFuzion setup wizard as you have before When prompted to select the component to install select Compute Node as shown in Figure 3 15 Click Next to continue 19 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE ib Setup EnFuzion 8 7 by Axceleon Select Components Which components should be installed Select the components you want to install clear the components you do not want to install Click Next when you are ready to continue Custom installation vi e Lafitrol Root Current selection requires at least 2 9 MB of disk space Figure 3 15 Install and Configure an EnFuzion Computer Node Step 3 Provide
37. face This interface is not intended for artists For now we will use the EnFuzion Web Interface only to verify that your one machine render farm is up and running Login as a user not the enfuzion user open a Web browser such as Firefox and enter as the URL http lt EnFuzion Control Root Computer gt 10101 For our one machine render farm the URL should be http localhost 10101 Click on the Cluster link You will see the EnFuzion Web Interface as shown in Figure 3 9 E Cluster Summary Microsoft Internet Explorer EG a File Edit View Favorites Tools Help Q ak x a po Search jf Favorites A Media Rd gt a Bel Address za http localhost 10101 summary html v Go Links yi M 2 v v Search Web amp attempting to retrieve buttons from Yahoo 3 axceleon Pimms EnFuzion 8 2 e Updated Sat May 14 16 09 44 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluster my Ip2 cv2bo2 ef1 10102 my Ip2ev2be2efl 1ol02 Rus 00 30 23 1 Nodes Nodes 1 Runs Runs 0 a Local intranet Figure 3 9 EnFuzion Web Interface 14 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE From the Web interface you can see that e Youhave 1 Cluster named after your computer e You have 1 Node e Youhave0 Runs Please reference the EnFuzion3D v11 Troubleshooting Guide at htip w
38. file called enflicense txt If you do not have a valid license file please contact Axceleon at sales axceleon com Summary of Steps The recommended steps to building and testing a bigger EnFuzion render farm are as follows Always start with a one machine configuration add more machines to it and test as you go Each render farm can have only one Control Root Computer Make sure you do not have more than one Control Root Computer One at a time add more Compute Nodes to your render farm After each Compute Node is added make sure it is running by checking the Nodes page from the EnFuzion Web Interface One at a time add more User Submit Computers to your render farm After each User Submit Computer make sure that you can successfully start the EnFuzion Web Interface from it You must also install and license all the rendering packages you wish to use on each Compute Node and each User Submit Computer Your render farm will not work until you have set up and configured your Shared File Repository You must read Chapter 6 Setting up a Shared File Repository and follow the directions therein to set up a Shared File Repository You must also read Chapter 15 Render Farm Administrator Guide in the Plug in Guide for additional required configuration steps for Compute Nodes and User Submit Computers The directions on installing and testing Linux based Control Root Compute Nodes and User Submit Computers are in Section 4 1 If yo
39. gure Step 2 Start the EnFuzion setup wizard as you have before When prompted to select the component to install select User Submit Computer as shown in Figure 3 19 Click Nextto continue 22 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 15 Setup EnFuzion 8 2 by Axceleon Select Components Which components should be installed Select the components you want to install clear the components you do not want to install Click Next when you are ready to continue Custom installation lll EnFuzion Service on the Control Root User Submit Computer Current selection requires at least 3 5 MB of disk space Figure 3 19 Install and Configure an EnFuzion User Submit Computer Step 3 Start the EnFuzion setup wizard as you have before When prompted to select the component to install select User Submit Computer Click Next to continue Step 4 When prompted to provide EnFuzion Service Host address provide the IP address of your EnFuzion Control Root Computer as shown in Figure 3 20 ial ic Setup EnFuzion 8 2 by Axceleon Configure User Submit Computer What is the address of the EnFuzion service on the Control Root computer Provide the network name or address of the Control Root computer Click Next to continue with the installation EnFuzion Service Hast 192 168 010 EnFuzion Service Port 10102 Notice The default port value 10102 rarely needs to be changed Do not
40. hare this folder on the network and provide a Share name and e Choose Allow network users to change my files Step 4 Click OK to finalize From the Windows Explorer you can see the directory marked as shared as shown Centraleposit ory with the symbol of a hand CentralRepository Properties General sharing Customize Local sharing and security E To share this folder with other users of this computer 9 only drag it ta the Shared Documents folder To make this folder and its subfolders private so that only you have access select the following check box Network sharing and security To share this folder with both network users and other LI users of this computer select the first check box below and type a share name Share this folder on the network Share name CentralRepository Allow network users to change my files Learn more about sharing and security Figure 6 2 File Properties Dialogue 48 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 6 3 2 Configuring a Windows Based SBM Client on an EnFuzion User Submit Machine On a Windows based User Submit Computer you do not need to do anything to enable a SMB Client Once a SMB Server has been properly configured verify that you can access shared files in your Shared File Repository by selecting Windows gt Start gt My Network Places on the User Submit Computer 6 3 3 Configuring a Windows Based SMB Client on an EnFuzion
41. ice e enfeye bin exe EnFuzion gt Control Root Utilities gt Start EnFuzion Root Service e enfDispatcher exe Start gt All Programs gt EnFuzion gt Control Root EnFuzion Node Service Utilities gt Register EnFuzion Node Service Start gt All Programs gt EnFuzion gt Control Root Utilities gt Stop EnFuzion Node Start gt All Programs gt Service e en Startersvc exe EnFuzion gt Control Root Utilities gt Start EnFuzion Node Service e enfNodeServer exe Table 7 1 Start Stop EnFuzion on Windows platform 56 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Onthe Linux platform the EnFuzion Root Service consists of two main processes enfdispatcher and enfeye bin The EnFuzion Node Service has one main process enfnodeserver To manually start or stop EnFuzion services on the Linux platform use the following commands EnFuzion Services Linux Stop Service EnFuzion Root Service e enfdispatcher letc init d enfuzion start etc init d enfuzion stop e enfeye bin EnFuzion Node Service etc init d enfnode start letc init d enfnode start e enfnodeserver Table 7 2 Start Stop EnFuzion on Linux platform e Onthe Mac OS X platform the EnFuzion Root Service consists of two main processes enfdispatcher and enfeye bin The EnFuzion Node Service has one main process enfnodeserver To manually start or stop EnFuzion services on the Mac OS X platform use the following commands in
42. ile Sharing on Windows Based Computers iii 47 6 4 Configuring File Sharing on Linux Based Computers lisse sese 49 6 5 Configuring File Sharing on Mac OS X Based Computers essen 51 7 Upgrading a Previous Installation of EnFuzion ee eclesie eeeee eene eene nennen nnns 55 7 4 Planning an EnFuzion UbOragde uu ee ea ete uio e Eva kae del osa ed ad Vaso de Aun ewe s dk usa v ug la ad owed us 55 7 2 Updating Your EnFuzion License File iii 56 7 3 Re hosting Your EnFuzion Control Root Computer ccccccssseeeeeecccsccssseeeseececsessaseeeeeeccessssasaeesseceessessaaneeess 56 7 4 Managing Different Versions of ENFUZION iii 56 FO Sal SOP ENF UZON SEV CES qeu duimeuidades i t comet ede diis tav posed dc entlastet an stam e bo 56 70 Upgrading VourEnFuzion insialialo n att ad esL dete bt une baa to piede do oo son eo bo aspbe E as M ed Me PNE 58 7 7 Choosing Between the EnFuzion Setup Wizard and the EnFuzion Command Line Setup Program 58 7 8 Install EnFuzion Using the Command Line Setup Program sees esee nnne 58 7 9 Additional Inrermatilofre s oiu m itp ei TE 58 Table of Figures Figure 2 1 A typical EnFuzion Based Render Farms ie 2 Figure 2 2 How does an EnFuzion based render farm Work iii 4 Figure 2 3 A one machine EnFuzion Rende
43. installation problems can lead to the following symptoms at the end of the installation process e Some or all of the required EnFuzion processes enfdispatcher enfeye enfnodeserver are not running e You cannot connect to the EnFuzion Web Interface e he EnFuzion3D v11 Interface runs sluggishly Most common installation problems have to do with expired license key files blocked port numbers and antivirus software Diagnostic tips and solutions for these problems can be found in the EnFuzion3D v11 30 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Troubleshooting Guide at httpz www axceleon com Sd fag htm Please make sure to peruse the Troubleshooting Guide on line 4 2 Getting Started with EnFuzion This section takes you through a quick test drive of EnFuzion using the one machine render farm that you have installed and configured 4 2 1 Understanding Your One Machine Render Farm By successfully completing the steps in the previous sections you have installed and configured a one machine EnFuzion render farm as shown in Figure 4 2 n this render farm the EnFuzion Control Root Computer the User Submit Computer and the EnFuzion Compute Node all reside in the same machine giving you a simple render farm configuration to learn and explore EnFuzion services Figure 4 2 The One Machine EnFuzion Render farm Upon a successful installation and starting of EnFuzion on Linux you should have the following processes
44. ion Control Root Computer Your EnFuzion license file is tied to your EnFuzion Control Root Computer or more specifically its IP address If you plan to re host your EnFuzion Control Root Computer you will need a new EnFuzion license file To obtain a new EnFuzion license file for your new server please contact Axceleon at support axceleon com and provide us with the IP address of your new Control Root Computer 7 4 Managing Different Versions of EnFuzion You should not mix EnFuzion services from different versions Before installing and running a new version of EnFuzion on your render farm you should stop EnFuzion services on all the machines that ran an older version of the software Once you have successfully upgraded your installation you can then start the EnFuzion services associated with the new version of the software 7 5 Start Stop EnFuzion Services e Onthe Windows platform the EnFuzion Root Service consists of two processes enfDispatcher exe and enfeye exe The EnFuzion Node Service has 2 processes enfNodeServer exe and enfStartersvc exe To manually start or stop EnFuzion services on the Windows platform follow the steps below EnFuzion Services Windows Stop Service Start gt All Programs gt EnFuzion gt Control Root EnFuzion Root Service Utilities gt Register EnFuzion Root Service e Start gt All Programs 3 EnFuzion gt Control Root Utilities gt Stop EnFuzion Root Start gt All Programs gt Serv
45. lanning an EnFuzion Upgrade To plan for an orderly upgrade of EnFuzion on your render farm please note the following recommended Steps e Stop EnFuzion services associated with your current version of EnFuzion For more detail on this please see the section below titled Start Stop EnFuzion Services e Backup your current EnFuzion installation directory e tis not necessary to uninstall an older version of EnFuzion before updating it e Installa new version of EnFuzion on the EnFuzion Control Root Computer all the User Submit Computers and all the Compute Nodes We recommend that you always install EnFuzion at the same location so that your new installation will be able to find your user files at their default locations e he EnFuzion services associated with the new version of EnFuzion should be started by default during the installation process If for any reason blocked ports anti virus programs the EnFuzion processes fail to start you can manually start the necessary EnFuzion processes after you resolve the 55 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE problems To see how to manually start EnFuzion services please see the section below titled Start Stop EnFuzion Services 7 2 Updating Your EnFuzion License File EnFuzion license files are version dependent When you upgrade your version of EnFuzion please contact Axceleon at support axceleon com to obtain a new license file 7 3 Re hosting Your EnFuz
46. mputers These are desktop machines that artists use to create scenes You can have as many User Submit Computers as needed Your EnFuzion license does not limit the number of EnFuzion User Submit Computers you can have e EnFuzion Control Root Computer Designate one machine per render farm to serve as the EnFuzion Control Root Computer This computer controls all EnFuzion activities on the render farm This machine is also where your EnFuzion license file is installed e EnFuzion Compute Nodes These are the worker machines dedicated or shared that make up your render farm i e the machines that do the rendering The maximum number of the EnFuzion Compute Nodes you can have is set by your EnFuzion license file ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e A Shared Repository File Server EnFuzion plug ins for rendering packages e g Maya After Effects XSI require that all rendering project files are stored in a repository which must be accessible by all the Compute Nodes and by all the User Submit Computers The Shared Repository File Server is the computer which stores the repository of project files EnFuzion imposes no restrictions on the number of Files Servers and Shared Repositories Multiple File Servers and Shared Repositories can be configured in one render farm Please note that EnFuzion is flexible and it can be configured to work without a shared file repository Please contact Axceleon to find o
47. nFuzion Compute Node by running the InstallNode applications as shown in Figure 5 1 e You will be prompted to configure the Compute Node by telling it the network address of the EnFuzion Control Root Computer You must supply a valid static network address for the Control Root Computer For the one machine test configuration you can simply enter localhost e Upon a successful installation of a Compute Node it should connect to the Control Root Computer automatically You can verify this from Nodes page from the EnFuzion Web Interface as shown in Figure 5 3 e Reboot the Compute Node atter installation Ta a Nodes 4 gt v http localhost 10101 nodelist html OF Q Google H CI Apple 45 v Amazon eBay Yahoo News 103 v t axceleon DARA EnFuzion 9 0 e Updated Fri Dec 22 21 22 10 2006 Root mini2 local 10102 Nodes User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Nodes Node Control Start Terminate Remove Add Figure 5 3 Compute Node Running as Seen from the EnFuzion Web Interface 39 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE If you do not see the Web page please see the section below titled Common Installation Problems Please make sure this step is successful before you continue to the next installation step 5 1 6 Installing EnFuzion on an EnFuzion User Submit Computer The steps to in
48. nstall the correct EnFuzion executable for the machines running on different operating system platforms ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Figure 2 5 A Typical EnFuzion Render Farm 2 6 Whatto do next If you are a first time EnFuzion user please proceed to Chapters 3 4 or 5 for instructions on how to install and configure EnFuzion on your platform of choice If you are upgrading your current version of EnFuzion please proceed to Chapter 7 Upgrading a Previous Installation of EnFuzion ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 3 Installing EnFuzion3D v11 on the Windows Platform This chapter describes the steps to install EnFuzion3D v11 on the Windows Platform This chapter is organized as follows e Installing a One Machine EnFuzion Render Farm e Getting Familiar with Your One Machine Render Farm e Adding More Machines to Your Render Farm If you have been using an earlier version of EnFuzion3D v11 and wish to upgrade your installation please go to Chapter 7 Upgrading a Previous Installation of EnFuzion 3 1 Installing and Configuring a One Machine EnFuzion Render Farm This section describes the steps to install EnFuzion3D v11 for the first time This section provides the step by step instructions to help you install and configure a one machine EnFuzion render farm IMPORTANT Axceleon strongly recommends all first time users to start here 3 1 1 Before You Begin
49. nux Based SMB Client on an EnFuzion Compute Node To configure a SMB Client on a Linux based Compute Node please follow the steps below Step 1 Login as a root super user and create a mount point with the following command mkdir p mnt lt share name gt Step 2 Create a share description in the etc fstab file on the Compute Node by adding the following line to the file 49 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE lt server name gt lt share name gt mnt lt share name gt smbfs username enfuzion password password uid enfuzion gid enfuzion 0 0 Example We have a Shared File Repository located on the machine 192 168 0 160 SharedRepository We wish to mount this Shared File Repository from an EnFuzion Compute Node using the directory mnt SharedRepository To accomplish this create a etc fstab file on the Compute Node and add the following line Step 3 Step 4 192 168 0 160 SharedRepository mnt SharedRepository smbfs username enfuzion password enfuzion uid enfuzion gid enfuzion 0 0 Mount the new share with the following command mount mnt lt share name gt Confirm the SMB mount with the following steps e Log in as enfuzion e From a command prompt type cd mnt lt share_name gt and confirm that files can be read from and written to the Shared File Repository 6 4 3 Configuring a Linux SMB Client on an User Submit Computer To configure the SMB Client on a Linux based Us
50. o extract the EnFuzion executable enfuzion 3d setup version build exe 16 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE To install EnFuzion click on enfuzion 3d setup version build exe The EnFuzion Setup Wizard windows should appear If you plan to install EnFuzion Compute Nodes and User Submit Computers on many networked nodes you may want to place the enfuzion 3d setup version build exe on a shared network drive for network installation 3 3 4 Installing EnFuzion from a CD ROM Insert the EnFuzion software CD into your CD ROM drive The EnFuzion Setup Wizard window should appear If the EnFuzion Setup Wizard window does not appear choose Start gt Run and browse to locate the enfuzion 3d setup version build exe file on the EnFuzion CD Click OK in the Run dialog box to begin the installation 3 3 5 Installing and Configuring the EnFuzion Control Root Computer Step 1 Select the machine that will be your EnFuzion Control Root Computer and note its IP address Step 2 Located the EnFuzion executable from your download package or CD ROM and click on the enfuzion 3d setup version build exe file to begin the installation You will see the EnFuzion Setup Wizard otep 3 Proceed by clicking the Next button When prompted to select components to install choose the option EnFuzion Service on the Control Root Computer as shown in Figure 3 11 is Setup EnFuzion 8 2 by Axceleon Select
51. one machine EnFuzion render farm This is the recommended starting point for all new EnFuzion users The steps to install a one machine render farm are as follows e Create an enfuzion user account 36 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Install and configure the EnFuzion Control Root Computer the Compute Node and the User Submit Computer all on the same machine e Verify your installation Detailed instructions on how to install and configure your one machine render farm are in the sections below 5 1 3 Create an enfuzion User Account An enfuzion user account is required by EnFuzion At run time the Control Root Computer uses this account to execute EnFuzion processes and the Compute Nodes use this account to execute EnFuzion processes and rendering applications While this user account can have any name of the user s choice we recommend that you create a user called enfuzion and give it a valid password The enfuzion user needs administrative user rights during the installation process After EnFuzion is installed administrative rights can be removed Create an enfuzion user account with the Systems Preferences gt System gt Accounts menu This account should have following characteristics e Name enfuzion e Password specify password e Allow user to administer this computer Note the admin user rights can be removed once you re finished with the installation process The enfuzion user
52. our one machine render farm The computer must have sufficient disk space to hold EnFuzion files and user submission and log files At least 30Mb of available disk space is recommended e You will need a valid EnFuzion license key in the form of a file called enflicense txt lf you do not have a valid license key please contact Axceleon at sales axceleon com 4 1 2 Installing and Configuring a One Machine EnFuzion Render Farm This section describes how to install and configure a one machine EnFuzion render farm This is the recommended starting point for all new EnFuzion users An overview of steps to install a one machine render farm is as follows e Create an enfuzion user account 25 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Install and configure the EnFuzion Control Root Computer the Compute Node and the User Submit Computer all on the same machine e Verify your installation Detailed instructions on how to install and configure your one machine render farm are in the sections below 4 1 3 Create an enfuzion User Account An enfuzion user account is required by EnFuzion At run time the Control Root Computer uses this account to execute EnFuzion processes and the Compute Nodes use this account to execute EnFuzion processes and rendering applications While this user account can have any name of the user s choice we recommend that you create a user called enfuzion and give it a valid password e
53. ow to uninstall EnFuzion from the User Submit Computers the Control Root Computer and the Compute Nodes Please note that there is no need to uninstall EnFuzion prior to an upgrade unless you are specifically told otherwise by Axceleon To uninstall EnFuzion on the User Submit Computers e Delete the enfuzion directory from the computer user s home directory For example for a user called bob you need to delete the Users bob enfuzion directory To uninstall EnFuzion on the Control Root Computer 44 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Using the Activity Monitor locate the processes called enfdispatcher and enfeye and choose Quit Process to stop both processes e Delete the enfuzion directory from the enfuzion user s home directory i e the Users enfuzion enfuzion directory e Delete the Library Startupltems EnFuzion directory To uninstall EnFuzion on the Compute Nodes e Using the Activity Monitor locate the process called enfnodeserver and use Quit Process to stop it e Delete the enfuzion directory from the enfuzion user s home directory i e the Users enfuzion enfuzion directory e Delete the Library Startupltems EnFuzionNode directory 55 What Next Render farm administrators and artists alike should proceed to the Plug in Guide from here 45 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 6 Setting up a Shared File Repository The EnFuzion plug ins for r
54. puter the root host can be localhost e To start EnFuzion Compute Node reboot the computer or execute Jetcoc init d enfnode start 4 1 6 Installing EnFuzion on an EnFuzion User Submit Computer The steps to installing and configuring an EnFuzion User Submit Computer are as follows The steps must be performed on each User Submit Computer by each user that will be submitting jobs from that computer e Login as a user on an EnFuzion User Submit Computer that will submit jobs from that computer su submit uUser lt provlde password for the submit user 17 17 Please make sure to include the after su to change the working directory to the enfuzion user home directory e Copy the EnFuzion installation package to a location under the submit user home directory The EnFuzion installation package format for Linux is enfuzion linux tar gz e Unpack the EnFuzion installation package using the following command tar zxyr entu uzron linux tar gz e Change your working directory to the unpacked EnFuzion installation package cd enfuzion linux e Execute the install submit script to install the EnFuzion files for the User Submit Computer a lnstall subNHIEL 0006 hosL The root host is the name or IP address of the EnFuzion Control Root Computer If the Control Root Computer and the User Submit Computer are the same computer the root host can be localhost EnFuzion files will be installed in the HOME enf
55. r Familiare iii ie 5 Figure 2 4 Install and configure an EnFuzion Control Root Computer 5 Figure 2 5 A Typical EnFuzion Berdet f arms eios ca ea eae sa ate nae teles a Lun ted ues acme uu Ded 6 Figure 93 15 EnFUZIOM Seti WZA O balia elia 8 Figure 3 2 TestInstallon One Computer 9 Figure 3 3 Provide EnFuzion User Name and Password sss nennen nennen nnns 10 Figure 3 4 Configure an EnFuzion Compute Node ssesessssssseeeeene eene nennen nnne nnnm nnns nnn nnns 11 Figure 3 5 Configure an EnFuzion User Submit Computer nennen 11 Figure 3 6 Start EnFuzion on the one machine render farm nennen 12 Figure 3 7 One machine render farm running eiue c dece eaa eec Ee resto diee YE UD ee des rece ai 12 Figure 3 8 The One Machine EnFuzion Render farm i 13 Figure 3 9 EnFuzion Web Interface i 14 Figure 3 10 A typical EnFuzion Render farms ii 15 Figure 3 11 Install and configure an EnFuzion Control Root Computer 17 Figure 3 12 Start EnFuzion Service on the Control Root Computer 18 Figure 3 13 Register and Start EnFuzion Root Service nennen nnne nennen nnn nnns 18 Figure 3 14 The EnFtuzion Web Interface i io eoe alone bll 19 Figure 3 15 Install and Configure an EnFuzion Computer Node ccccccseseeceeeceeeeeeeeeeeeeeeeeeesse
56. r my Ip2cv2bo2 ef1 10102 my lp2cv2bo2 ef1 10102 Running 1d 06 34 58 1 Figure 4 3 EnFuzion Web Interface 32 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE From the Web interface you can see that e You have 1 cluster named after your computer its status is running e You have 1 node its status is idle e You have 0 Runs Please reference the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d faq htm if your one machine render farm is not running successfully 4 2 3 Getting EnFuzion to Work with Your Rendering Packages To get EnFuzion to work with your rendering packages of choice e g Maya XSI on your one machine render farm you need to load the respective EnFuzion plug ins for those rendering packages Directions for how to do this are in the Plug in Guide which you can download from the same location as where you downloaded your EnFuzion software The Plug in Guide will also introduce you to the primary user interface for artists to submit jobs to monitor their progress and to retrieve results Please proceed to the Plug in Guide to continue 4 3 Adding More Machines to Your Render Farm This section describes how to expand from the one machine render farm to a bigger EnFuzion render farm with a dedicated EnFuzion Control Root Computer several User Submit Computers and several EnFuzion Compute Nodes as show in Figure 4 4 Proceed to expand your one machine render only after you hav
57. red File Repository As you expand beyond your one machine render farm please refer to the EnFuzion3D v11 Installation and Configuration Guide for more details on sharing files over the network and on setting up a Shared File Repository 5 2 4 Getting EnFuzion to Work with Your Rendering Packages To get EnFuzion to work with your rendering packages of choice e g Maya After Effects on your one machine render farm you need to load the respective EnFuzion plug ins for those rendering packages Directions for how to do this are in the Plug in Guide which you can download from the same location as where you downloaded your EnFuzion software The Plug in Guide will also introduce you to the primary user interface for artist to submit jobs to monitor their progress and to retrieve results Please proceed to the Plug in Guide to continue 5 3 Adding More Machines to Your Render Farm This section describes how to expand from the one machine render farm to a bigger EnFuzion render farm with a dedicated EnFuzion Control Root Computer several User Submit Computers and several EnFuzion Compute Nodes as show in Figure 5 7 Proceed to expand your one machine render only after you have completed all the steps in Sections 5 1 and 5 2 successfully If you have not gotten EnFuzion to work successfully with your rendering package on your one machine render farm please return to Section 5 2 B EnFuzion Control Root Computer EnFuzion User N M
58. rg axceleon Axceleon Inc EnFuzion 3D Release v11 Installation and Configuration Guide For Windows Mac OS X and Linux Users Legal Notices EnFuzionsD v11 Installation and Configuration Guide Release 11 For Windows Mac OS X and Linux Users Document Version 2 2 2002 2012 Axceleon Inc All rights reserved Axceleon is a trademark of Axceleon Inc EnFuzion is a registered trademark of Axceleon Inc EnFuzion3D v11 is a trademark of Axceleon Inc All other trademarks mentioned herein are the property of their respective owners Axceleon Inc 2134 Main Street Suite 210 Huntington Beach CA 92648 Phone 714 960 5200 Fax 714 782 5647 Email info axceleon com Web www axceleon com 3d Table of Contents Table oFContents al D E RD i Table of FigUles ii nici iii Table oFTables lla iv 1 PEPER OCUIG WOM MU M 1 2 Overview of an EnFuzion Based Render Farm 1 11 leeeee eei ieeeee ee eieee enne nnn n anna nana n nnn nn nnns 2 2 1 Key Components of an EnFuzion Based Render Farm ssi sese eene 2 2 2 Heterogeneous Render Farm Support e iii 3 2 3 ve Me eizizimielardio iuret 4 2 4 Setting up an EnFuzion Based Render Farm Summary of Steps senes 4 ZO TIOW CON SUA T 5 LOWAO olo TON eil 6 3 Installing EnFuzion3D v11 on the Windows Platform
59. running e enfdispatcher e enfeye e enfnodeserver Please see Chapter 7 for instructions on how to manually start EnFuzion processes Please reference the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d faq htm if you re unable to start the EnFuzion processes 4 2 2 The EnFuzion Web Interface The EnFuzion Web Interface is intended mostly for render farm administrators to monitor and control various aspects of the render farm operations The EnFuzion User Manual provides a complete description of the EnFuzion Web Interface This interface is not intended for artists For now we will use the EnFuzion Web Interface only to verify that your one machine render farm is up and running Login as a user not the enfuzion user open a Web browser such as Firefox and enter as the URL http Control Root Computer gt 10101 31 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE For our one machine render farm the URL should be http localhost 10101 Click on the Cluster link You will see the EnFuzion Web Interface as shown in Figure 4 3 Cluster Summary Mozilla Firefox Do Q Fie Edit Yiew Go Bookmarks Tools Help Qa E v Ej A IB http my Ip2cy2bo2ef1 10101 summary html v Q Go IG Do morel EnFuzion 8 2 e Updated Sun Aug 21 20 02 42 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluste
60. s File Server SMB Server Figure 6 1 Typical EnFuzion Render Farm To set up the Shared File Repository you need to do the following e Configure the SMB Server which runs on the Repository File Server machine e Configure the SMB Clients which run on the Submit Computers and the Compute Nodes On heterogeneous render farms the SMB Server and Clients run on different operating systems Please see below for instructions on how to configure SMB Servers and Clients on Windows Linux and Mac OS X platforms 6 3 Configuring File Sharing on Windows Based Computers This section provides the information on configuring Windows machines for SMB based file sharing including e How to enable file sharing on a Windows SMB Server and e How to configure Windows based SMB Clients on User Submit Computers and the Compute Nodes Please see below for details 6 3 1 Configuring a Windows SMB Server for File Sharing The steps to configure a Windows based SMB Server for file sharing are as follows Step 1 Open a Windows Explorer window by choosing Windows Start gt My Computer Step 2 Locate the directory which contains all of your scenes texture files and other project files Right Click on this directory choose the Sharing and Security option to open the files Properties dialogue window as shown in Figure 6 2 Step 3 Also shown in Figure 6 2 from the Sharing tab 47 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE e Choose S
61. s to it and test as you go e Each render farm can have only one Control Root Computer Make sure you do not have more than one Control Root Computer e Oneata time add more Compute Nodes to your render farm After each Compute Node is added make sure it is running by checking the Nodes page from the EnFuzion Web Interface Reboot each Compute Node after the installation e Oneata time add more User Submit Computers to your render farm After each User Submit Computer make sure that you can successfully start the EnFuzion Web Interface from it e You must also install and license all the rendering packages you wish to use on each Compute Node and each User Submit Computer e Your render farm will not work until you have set up and configured your Shared File Repository You must read Chapter 6 Setting up a Shared File Repository and follow the directions therein to set up a Shared File Repository e You must also read Chapter 15 Render Farm Administrator Guide in the Plug in Guide for additional required configuration steps for Compute Nodes and User Submit Computers The directions on installing and testing Mac OS X based Control Root Compute Nodes and User Submit Computers are in Section 5 1 f you have a heterogeneous render farm you can find the directions on installing and testing Windows and Linux based components are in Chapter 3 and Chapter 4 respectively 5 4 Uninstalling EnFuzion This section provides information on h
62. stall and configure an EnFuzion User Submit Computer are as follows e Login as a user e g yourself and not the enfuzion user e Copy the EnFuzion installation package to your Desktop or home directory The EnFuzion installation package for Mac OS X is called enfuzion 3d version darwin version ppc32 tgz e Double click on the installation package to unpack it This will result in a directory with the installer programs e Install the User Submit Computer by using the InstallSubmit application as shown in Figure 5 1 e You will be prompted to configure the User Submit Computer by telling it the network address of the EnFuzion Control Root Computer You must supply a valid static network address for the Control Root Computer For the one machine test configuration you can simply enter localhost Upon a successful installation of a User Submit Computer the EnFuzion3D v11 application should start automatically as shown in Figure 5 4 Run ID 4 Submission User Status Submitted Completed Uptime Waitina Done Failed Rescheduled Job Lenath Total Time Welcome to EnFuzion for Render Farms Figure 5 4 The EnFuzion Render Farms Interface 40 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE If this application starts but runs very sluggishly it usually means that it is not able to connect to the Control Root Computer f this happens please reference the EnFuzion3D v11 Troubleshooting Guide at http www a
63. sure to include the home directory after su to change the working directory to the enfuzion user e fthe EnFuzion installation package has not yet been copied to a location under the enfuzion users home directory copy the EnFuzion installation package The EnFuzion installation package format for Linux is enfuzion linux tar gz e fthe EnFuzion installation package has not yet been unpacked unpack the EnFuzion installation package using the following command bat XVFr enruzion Linux cat O2 e Change your working directory to the unpacked EnFuzion installation package cd entugion lanux e Execute the install node script to install the EnFuzion files for the Compute Node install node EnFuzion files will be installed in the HOME enfuzion directory This completes the installation of the EnFuzion package on your Compute Node The remaining step of configuring the Compute Node is to set up EnFuzion as a service so that it is started automatically e Change your working directory to the unpacked EnFuzion installation package cd entuzron linu ux e login as the root super user Su lt provide root password gt e Execute the install svcnode script to install the EnFuzion service install svcnode root host 28 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE The root host is the name or IP address of the EnFuzion Control Root Computer If the Control Root Computer and the Compute Node are the same com
64. t computer Click Nest to continue with the installation EnFuzion Service Host EnFuzion Service Part 10102 Notice The default port value 10102 rarely needs to be changed Do not change this value without changing the default EnFuzion service port on the Control Root computer Figure 3 5 Configure an EnFuzion User Submit Computer 11 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Step 7 Click on Install to begin installation and configuration of EnFuzion for your one machine render farm Step 8 After the installation completes you will be prompted to start EnFuzion on this machine Check all the boxes to start EnFuzion on this machine as shown in Figure 3 6 below and click Finish io Setup EnFuzion 8 2 by Axceleon Completing the EnFuzion Setup Wizard Setup has finished installing and configuring EnFuzion on your computer Click Finish to perform the tasks below and exit Setup Start EnFuzion Control Root service Start EnFuzion Compute Node Connect a Web Browser to the EnFuzion Service Figure 3 6 Start EnFuzion on the one machine render farm Congratulations You have just set up a one machine EnFuzion render farm Now you will see the EnFuzion Web Interface which shows the status of your render farm as shown in Figure 3 7 Cluster Summary Microsoft Internet Explorer File Edit View Favorites Tools Help J gt x E O pJ Search Sy Favorites media O3 e 2 E m
65. ter is organized as follows Installing an One Machine EnFuzion Render Farm Getting Familiar with Your One Machine Render Farm Adding More Machines to Your Render Farm If you have been using an earlier version of EnFuzion3D v11 and wish to upgrade your installation please go to Chapter 7 Upgrading a Previous Installation of EnFuzion 5 1 Installing and Configuring a One Machine EnFuzion Render Farm This section describes the steps to install EnFuzion3D v11 for the first time This section provides the step by step instructions to help you install and configure a one machine EnFuzion render farm IMPORTANT Axceleon strongly recommends all first time users to start here 5 1 1 Before You Begin e EnFuzion does not have any special installation requirements for hardware or software Any Mac OS X based system is suitable However your choice of hardware will directly affect the performance of your render farm e Identify the computer which you will set up as your one machine render farm The computer must have sufficient disk space to hold EnFuzion files and user submission and log files At least 30Mb of available disk space is recommended e You will need a valid EnFuzion license key in the form of a file called enflicense txt lf you do not have a valid license key please contact Axceleon at sales axceleon com 5 1 2 Installing and Configuring a One Machine EnFuzion Render Farm This section describes how to install and configure a
66. u have a heterogeneous render farm you can find the directions on installing and testing Windows and Mac OS X based components are in Chapter 3 and Chapter 5 respectively 4 4 Uninstalling EnFuzion This section provides information on how to uninstall EnFuzion from the User Submit Computers the Control Root Computer and the Compute Nodes 34 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE Please note that there is no need to uninstall EnFuzion prior to an upgrade unless you are specifically told otherwise by Axceleon To uninstall EnFuzion on the User Submit Computers e Delete the enfuzion directory from the computer user s home directory i e the enfuzion directory To uninstall EnFuzion on the Control Root Computer e Kill the processes called enfdispatcher and enfeye e Delete the enfuzion directory from the enfuzion user s home directory e Delete the etc init d enfuzion file To uninstall EnFuzion on the Compute Nodes e Kill the processes called enfnodeserver e Delete the enfuzion directory from the enfuzion user s home directory e Delete the etc init d enfnode file 4 5 What Next Render farm administrators and artists alike should proceed to the Plug in Guide from here 35 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 5 Installing EnFuzion3D v11 on the Mac OS X Platform This chapter describes the steps to install EnFuzion3D v11 on the Mac OS X Platform This chap
67. ut how 2 2 Heterogeneous Render Farm Support EnFuzion3D v11 supports heterogeneous render farms Tested and supported configurations are indicated as Yes in the table below IMPORTANT Please note EnFuzion cannot distribute rendering to a platform which is unsupported by your rendering package Please verify that the render package you use is supported on the OS platform that you chose EnFuzion E Control Root Compute Nodes P Computer Windows 2000 XP 2003 Server Mac OS X 10 3 or newer Linux Red Hat 7 3 Novell SUSE Yes Yes Yes Linux 9 or newer Table 2 1 EnFuzion3D v11 Supported Configurations ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 2 3 How does EnFuzion work A typical multi user multi compute node EnFuzion based render farm works as follows as illustrated in Figure 2 2 2 EnFuzion distributes 1 Users submit frames to frames to the render farm EnFuzion wp i i x m Pd EnFuzion man rendering 4 Users retrieve Results 3 EnFuzion manages rendering stores results and cleans up the worker machines Figure 2 2 How does an EnFuzion based render farm work 2 4 Setting up an EnFuzion Based Render Farm Summary of Steps Key steps to setting up an EnFuzion based render farm are shown in the table below where x marks the required steps Shared Repository File Server me O This Guide 2 Configure a Shared X X X File Repository Clients Clients Server
68. uzion directory Congratulations You have just set up a one machine EnFuzion render farm Proceed to the next section to test your installation 4 1 7 Verifying Your Installation To verify your installation open a Web browser such as Firefox enter as the URL http Control Root Computer gt 10101 29 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE For our one machine render farm the URL can be http localhost 10101 From the EnFuzion Web Interface click on Cluster You should see that your cluster is Running as shown in Figure 4 1 From the Web interface you can see that e You have 1 Cluster named after your computer e You have 1 Node e You have 0 Runs If you do not see the Web page please see the section below titled Common Installation Problems 4 Cluster Summary Mozilla Firefox File Edit view Go Bookmarks Tools Help Qa D Ej en E http my lp2cv2bo2ef1 10101 summary html Go IG Do morel EnFuzion 8 2 e Updated Sun Aug 21 20 02 42 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluster my Ip2cv2bo2 ef1 10102 my lp2cv2bo2ef1 10102 Running 1d 06 34 58 1 Figure 4 1 One machine render farm running By completing all the steps in the previous sections you have successfully setup and configured a one machine render farm 4 1 8 Common Installation Problems The most common
69. uzion user does not need administrative user rights 3 1 3 Installing EnFuzion from a Download Package An EnFuzion download package for Windows users is named enfuzion 3d setup version build zip e g enfuzion 3d setup 9 0 05204 zip Unzip the zip file to extract the EnFuzion executable enfuzion 3d setup version build exe To install EnFuzion click on enfuzion 3d setup version build exe The EnFuzion Setup Wizard window should appear as shown in Figure 3 1 below ist Setup EnFuzion 8 2 by Axceleon Welcome to the EnFuzion Setup Wizard This will install EnFuzion 8 2 on your computer It iz recommended that you close all other applications before continuing Click Next ta continue or Cancel ta exit Setup Figure 3 1 EnFuzion Setup Wizard ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE 3 1 4 Installing EnFuzion from a CD ROM Insert the EnFuzion software CD into your CD ROM drive The EnFuzion Setup Wizard window should appear as shown in Figure 3 1 If the EnFuzion Setup Wizard window does not appear choose Start gt Run and browse to locate the enfuzion 3d setup version build exe file on the EnFuzion CD Click OK in the Run dialog box to begin the installation 3 1 5 Installing EnFuzion Step 1 From the EnFuzion Setup Wizard window start by clicking the Next button When prompted to select components to install choose the option Test Install on One Computer as shown in Figure
70. ww axceleon com 3d fag htm if your one machine render farm is not running successfully Getting EnFuzion to Work with Your Rendering Packages To get EnFuzion to work with your rendering packages of choice e g Maya After Effects on your one machine render farm you need to load the respective EnFuzion plug ins for those rendering packages Directions for how to do this are in the Plug in Guide which you can download from the same location as where you downloaded your EnFuzion software The Plug in Guide will also introduce you to the primary user interface for artists to submit jobs to monitor their progress and to retrieve results Please proceed to the Plug in Guide to continue 3 3 Adding More Machines to Your Render Farm This section describes how to expand from the one machine render farm to a bigger EnFuzion render farm with a dedicated EnFuzion Control Root Computer several User Submit Computers and several EnFuzion Compute Nodes as show in the Figure 3 10 below Proceed to expand your one machine render only after you have completed all the steps in Sections 3 1 and 3 2 successfully If you have not gotten EnFuzion to work successfully with your rendering package on your one machine render farm please return to Section 3 2 EnFuzion Control Root Computer EnFuzion User A BM oubmit Computers Shared Repository File Server EnFuzion Compute Nodes Figure 3 10 A typical EnFuzion Render farms 15 ENFUZION
71. xceleon com 3d fag htm for more debugging tips 5 1 7 Common Installation Problems The most common installation problems can lead to the following symptoms at the end of the installation process e Some or all of the required EnFuzion processes enfdispatcher enfeye enfnodeserver are not running e You cannot connect to the EnFuzion Web Interface e he EnFuzion3D v11 Interface runs sluggishly Most common installation problems have to do with expired license key files blocked port numbers and antivirus software Diagnostic tips and solutions for these problems can be found in the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d faq htm Please make sure to peruse the Troubleshooting Guide on line 5 2 Getting Started with EnFuzion This section takes you through a test drive of EnFuzion using the one machine render farm that you have installed and configured 5 2 1 Understanding Your One Machine Render Farm By successfully completing the steps in the previous sections you have installed and configured a one machine EnFuzion render farm as shown in Figure 5 5 n this render farm the EnFuzion Control Root Computer the User Submit Computer and the EnFuzion Compute Node all reside in the same machine giving you a simple render farm configuration to learn and to explore EnFuzion features Figure 5 5 The One Machine EnFuzion Render farm 5 2 2 The EnFuzion Web Interface The EnFuzion Web Interface is intended mostl
72. y for render farm administrators to monitor and control various aspects of the render farm operations The EnFuzion User Manual provides a complete description of the EnFuzion Web Interface This interface is not intended for artists For now we will use the EnFuzion Web Interface only to verify that your one machine render farm is up and running Login as a user not the enfuzion user open a Web browser such as Safari and enter as the URL http lt EnFuzion Control Root Computers 10101 41 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE For our one machine render farm the URL should be http localhost 10101 Click on the Cluster link You will see the EnFuzion Web Interface as shown in Figure 5 2 above From the Web interface you can see that e Youhave 1 Cluster named after your computer its status is running e You have 1 node its status is idle e You have 0 Runs Please reference the EnFuzion3D v11 Troubleshooting Guide at http www axceleon com 3d fag htm if your one machine render farm is not running successfully 5 2 3 Creating a Shared Test Directory for Your First Render Test If you are a Mac OS X user and you are running your first render test on a one machine test render farm you must first create a Shared Test Directory on your machine This directory will contain all the project files scene files and texture files for your test It will also contain the rendered images The steps to creating
73. zion service port on the Control Root computer Figure 3 17 Configure the Compute Node with Control Root computer address Step 5 Complete the installation and ask the setup wizard to start the EnFuzion Compute Node service upon completion of installation Step 6 Note that your Computer Node has been configured to automatically connect to the EnFuzion Control Root Computer after the installation is completed and after each time you boot restart the machine Verify that the Compute Node is connected successfully to the EnFuzion Control Root Computer using the EnFuzion Web Interface as shown in Figure 3 18 You may have to wait for up to two minutes for the Compute Nodes to connect to the EnFuzion Control Root Computer 21 ENFUZION FOR RENDER FARMS INSTALLATION AND CONFIGURATION GUIDE E Cluster Summary Microsoft Internet Explorer EG File Edit View Favorites Tools Help gt E 5 gt o Back x a ad Search K Favorites a Media f gt g Address E http localhost 10101 summary html v Go Links gt NI Ca Search Web B attempting to retrieve buttons from Yahoo axceleon ME EnFuzion 8 2 Updated Sat May 14 16 09 44 2005 Root my Ip2cv2bo2ef1 10102 Cluster Summary User anonymous Home Cluster Nodes Runs Accounting Execution Submit Results Cluster my Ip2 cv2bo2 ef1 10102 Nodes Nodes 1 Runs Runs 0 amp a Local intranet Figure 3 18 Confirm the

EnFuzion for Render Farms Installation and Configuration Guide

Contents

Download Pdf Manuals

Related Search

Related Contents