install-macosx.xml 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. <section id="install-macosx">
  2. <title>
  3. Toolkit Installation on Mac OS X
  4. </title>
  5. <para>
  6. Toolkit installation on <productname>Mac OS X</productname> is essentially identical to installation on Linux but special steps are needed before starting.
  7. </para>
  8. <para>
  9. First, you must install the toolkit as the <varname>root</varname> user or you will be denied permission. The <varname>root</varname> user account is disabled by default and so you must enable it in order to login. Follow instructions at <ulink url='http://support.apple.com/kb/HT1528'>Enabling the &quot;root&quot; user in Mac OS X</ulink> to enable the account and login. After installation, toolkit programs should be run from a normal user account.
  10. </para>
  11. <para>
  12. Second, <productname>Mac OS X</productname> does not include C Language development tools by default. You must download and install them in order to build the toolkit. You can download and install them from the Apple website or (if you are ambitious) download, compile and install them from various open source websites. Consider using <ulink url="https://developer.apple.com/technologies/tools/"><application>Xcode</application></ulink> on <application>Mac OS X Leopard</application> or <application>Lion</application>.
  13. </para>
  14. <para>
  15. Login as the root user and download or copy the toolkit archive file to your preferred folder then follow the <link linkend='install-linux'>instructions</link> for installing the toolkit on Linux.
  16. </para>
  17. <example>
  18. <title>
  19. Setting the <constant>PATH</constant> variable on <productname>OS X</productname>
  20. </title>
  21. <para>
  22. While still logged in as the <varname>root</varname> user, edit <filename>/etc/profile</filename> and add folder<filename>/usr/local/bin</filename> to the <varname>PATH</varname> definition found there. This will ensure that all users can access toolkit programs. The change may not take effect until the next time you login or open a new command shell.
  23. </para>
  24. <screen>
  25. PATH="/bin:/sbin:/usr/local/bin"
  26. </screen>
  27. </example>
  28. <example>
  29. <title>
  30. Installing the Toolkit on <productname>Mac OS X</productname>
  31. </title>
  32. <para>
  33. While still logged in as the <varname>root</varname> user, remember to delete the toolkit source folder or, at least change ownership of all files in the toolkit folder, so that you can access and/or remove them later.
  34. </para>
  35. <screen>
  36. cd ..
  37. rm -r plc-utils-x.x.x
  38. </screen>
  39. </example>
  40. </section>