{"id":477391,"date":"2008-06-25T19:35:54","date_gmt":"2008-06-25T23:35:54","guid":{"rendered":"https:\/\/segue.middlebury.edu\/view\/html\/node\/477391"},"modified":"2008-06-25T19:35:54","modified_gmt":"2008-06-25T23:35:54","slug":"os-x-installation","status":"publish","type":"page","link":"https:\/\/segueproject.org\/segue-documentation\/segue-v1\/documentation\/for-administrators\/os-x-installation\/","title":{"rendered":"OS X Installation"},"content":{"rendered":"<h3>Untitled<\/h3>\n<div>\n<p>Segue is a web-based tool which should be run from a computer that is always on and has a static ip-address. You could run it otherwise, but then it would not be accessable to users when the machine is off or when the ip-address changes.<\/p>\n<p>The system requirements are minimal and Segue\/Apache\/MySQL runs just fine on anything that OS X will run on.<\/p>\n<p>For Segue to function, you need to have working installations of Apache (with PHP) and MySQL as these provide the enviroment for Segue to run in. If you have OS X &#8211; Server, all of these may be installed already.\n<\/p><\/div>\n<h3>Apache<\/h3>\n<div>\n<p>The Apache webserver comes installed by default on OS X.<\/p>\n<p>To start\/restart Apache, go to <\/p>\n<p> &nbsp; &nbsp; System Preferences &#8211;&gt; Sharing &#8211;&gt; Services<\/p>\n<p>and turn on &#8220;Personal Web Sharing&#8221;. That&#8217;s it.\n<\/p><\/div>\n<h3>PHP<\/h3>\n<div>\n<p>Follow these excellent directions for installing PHP under OS X (might be installed by default in OS X &#8211; Server):<\/p>\n<p> &nbsp; &nbsp; <a href=\"http:\/\/developer.apple.com\/internet\/opensource\/php.html\">http:\/\/developer.apple.com\/internet\/opensource\/php.html<\/a><\/p>\n<p>As is mentioned in the documentation, you can install the need libraries using the <a href=\"http:\/\/finkcommander.sourceforge.net\/\">Fink Commander<\/a> front end for the <a href=\"http:\/\/fink.sourceforge.net\/download\/\">Fink<\/a> package management system. Fink is a great Open Source program for installing unix software on OS X. You can use it to install MySQL later as well as much (current 1509 packages) of the Open Source software that is used on other unix\/unix-like systems such as Linux, FreeBSD, OpenBSD, etc.\n<\/div>\n<h3>MySQL<\/h3>\n<div>\n<p>MySQL is the database used by Segue. Either install it via <a href=\"http:\/\/finkcommander.sourceforge.net\/\">Fink Commander<\/a>, mentioned above, or follow these detailed directions from Apple:<\/p>\n<p><a href=\"http:\/\/developer.apple.com\/internet\/opensource\/osdb.html\">http:\/\/developer.apple.com\/internet\/opensource\/osdb.html<\/a><\/p>\n<div style=\"margin: 25px\"><em>If you\u2019re running Mac OS X Server, you are in luck \u2014 MySQL is already there. Just go to Applications\/Utilities\/MySQL Manager to access it. If you are running Mac OS X, you\u2019ll have to install MySQL. You may just want to run a binary installer. In that case, I can recommend the binary distribution from http:\/\/www.entropy.ch, which comes with a nice graphical installer. Or, go for the definitive binary distribution from http:\/\/www.mysql.com\/. However, sometimes you want to compile and install directly from the source, either because you are changing the default build settings, or you want the latest and greatest version before there\u2019s a binary installer. The following will help you through that process.<\/em><br \/>\n&#8211; Apple.com<\/div>\n<p>\nIf you need to install MySQL and are unsure how you want to install it, just use Fink\/FinkCommander. Anything you install with Fink\/FinkCommander can be upgraded easily with Fink and installation is a two-click process. Very easy.<\/p>\n<p>To manage (create, create users, etc) your MySQL databases, you can either use the MySQL command line utility, a database client such as <a href=\"http:\/\/cocoamysql.sourceforge.net\/\">CocoaMySQL<\/a>, or a web-based client such as <a href=\"http:\/\/www.phpmyadmin.net\/\">PHPMyAdmin<\/a>.\n<\/div>\n<h3>Set Up a MySQL Database for Segue<\/h3>\n<div>\n<p>To set up a MySQL account and database for Segue.<\/p>\n<p><b>(Using PHPMyAdmin)<\/b>\n <\/p>\n<ol>\n<li>Point your browser to <a href=\"http:\/\/localhost\/phpmyadmin\/\">http:\/\/localhost\/phpmyadmin\/<\/a><\/li>\n<\/ol>\n<ul>\n<li>\n  <b>Create a database for Segue<\/b><br \/>\n  <br \/>Click &#8220;Home&#8221; in the top-left of PHPMyAdmin.<br \/>\n  <br \/>Enter a database name, i.e. &#8220;segue&#8221;; then hit &#8220;Create&#8221;.\n <\/li>\n<ul>\n<li>\n  <b>Add a &#8220;segue&#8221; user<\/b><br \/>\n  <br \/>Go to Home &#8211;&gt; Privileges &#8211;&gt; Add a New User<br \/>\n  <br \/>Enter a username and password, i.e. &#8220;segue&#8221;, &#8220;secret&#8221;. Set host to &#8220;localhost&#8221;, as this will prevent anyone from using this account from remotely accessing the database. Then hit &#8220;Go&#8221;.\n <\/li>\n<ul>\n<li>\n  <b>Give the &#8220;segue&#8221; user access to the &#8220;segue&#8221; database.<\/b><br \/>\n  <br \/>If you have just created the &#8220;segue&#8221; user, you should already be at the correct screen if not, got to Privileges &#8211;&gt; Edit (next to the &#8220;segue&#8221; user).<br \/>\n  <br \/>Go down to the &#8220;Database-specific privileges&#8221; section and select the &#8220;segue&#8221; database from the drop-down menu.<br \/>\n  <br \/>Check all of the <i>Data<\/i> and <i>Structure<\/i> boxes then hit &#8220;Go&#8221;.\n <\/li>\n<\/ul>\n<\/ul>\n<\/ul>\n<\/div>\n<h3>Set Up Segue<\/h3>\n<div>\n<ol>\n<li>\n <b>Download Segue<\/b><br \/>\n <br \/>Download the <a href=\"http:\/\/sourceforge.net\/projects\/segue\/\">latest version of Segue<\/a><\/li>\n<p> from SourceForge.net.\n<\/ol>\n<ul>\n<li>\n <b>Untar Segue<\/b><br \/>\n <br \/>Untar the segue-1.x.x.tar.gz file into your webserver&#8217;s root directory,<br \/>\n <br \/> &nbsp; &nbsp; \/Library\/WebServer\/Documents\/<br \/>\n <br \/>you can either let StuffIt decompress the archive or do it from the command line with:<br \/>\n <br \/> &nbsp; &nbsp; tar -xzf \/Library\/WebServer\/Documents\/segue-1.x.x.tar.gz<br \/>\n <br \/>This will create a directory called segue-1.x.x in \/Library\/WebServer\/Documents\/ . Rename this directory to &#8220;segue&#8221;.\n<\/li>\n<ul>\n<li>\n <b>Create a userfiles directory<\/b><br \/>\n <br \/>Create a directory for the Segue userfiles. This directory is outside of the segue directory to allow you to update the Segue code without loosing the userfiles. you should now have a &#8220;segue&#8221; and a &#8220;segue_userfiles&#8221; directories in \/Library\/WebServer\/Documents\/.\n<\/li>\n<ul>\n<li>\n <b>Configure Segue<\/b><br \/>\n <br \/>Rename the file \/Library\/WebServer\/Documents\/segue\/config_sample.inc.php to &#8220;config.inc.php&#8221;.<br \/>\n <br \/>Open config.inc.php in a text editor (such as the included &#8220;TextEdit&#8221;) and edit the various values to fit your system.<br \/>\n <br \/>Below are examples of the parts that you must change:\n<\/li>\n<\/ul>\n<\/ul>\n<\/ul>\n<\/div>\n<h3>Untitled<\/h3>\n<div>\n<div style=\"margin-left: 30px\">\n\/******************************************************************************<br \/>\n\t * full_uri &#8211; Segue&#8217;s full URL path (ie, https:\/\/segue.middlebury.edu\/view\/html\/site\/segue)<br \/>\n\t *\t\tDon&#8217;t put a slash &#8220;\/&#8221; at the end of the url!<br \/>\n\t ******************************************************************************\/<br \/>\n\t$cfg[full_uri] = $_full_uri = &#8220;http:\/\/140.233.12.105\/segue&#8221;;\t\t\t<\/p>\n<p><b><i>Contact your network administrator to set up a DNS hostname and static IP address for your server to give you a url such as https:\/\/segue.middlebury.edu\/view\/html\/site\/segue\/<\/i><\/b><\/p>\n<p>\n\t\/******************************************************************************<br \/>\n\t * uploaddir &#8211; the local folder where userfiles are kept<br \/>\n\t * uploadurl &#8211; the URL equivalent of the above folder<br \/>\n\t ******************************************************************************\/<br \/>\n\t$cfg[uploaddir] = $uploaddir = &#8220;\/Library\/WebServer\/Documents\/segue_userfiles&#8221;;\t\t<br \/>\n\t$cfg[uploadurl] = $uploadurl = &#8220;http:\/\/140.233.12.105\/segue_userfiles&#8221;;\t\t<\/p>\n<p>\n\t\t\/******************************************************************************<br \/>\n\t\t * DB AUTHENTICATION &#8211; REQUIRED<br \/>\n\t\t *<br \/>\n\t\t * dbhost\t\t\t\tthe hostname of the sql server (ie, sql.middlebury.edu)<br \/>\n\t\t * dbuser\t\t\t\tthe user to connect as (ie, segue)<br \/>\n\t\t * dbpass\t\t\t\tthe above user&#8217;s passwd. may be blank<br \/>\n\t\t * dbdb\t\t\t\t\tthe name of the database to use (ie, segue)<br \/>\n\t\t ******************************************************************************\/<br \/>\n\t\t$cfg[dbhost] = $dbhost = &#8220;localhost&#8221;;\t<br \/>\n\t\t$cfg[dbuser] = $dbuser = &#8220;segue&#8221;;<br \/>\n\t\t$cfg[dbpass] = $dbpass = &#8220;secret&#8221;;<br \/>\n\t\t$cfg[dbdb] = $dbdb = &#8220;segue&#8221;;<\/p>\n<\/div>\n<\/div>\n<h3>Start Segue<\/h3>\n<div>\n<p>Point your browser to <a href=\"http:\/\/localhost\/segue\/\">http:\/\/localhost\/segue\/ or http:\/\/xxx.xxx.xxx.xxx\/segue\/ (where the xxx&#8217;s are your IP address) to use Segue.<\/p>\n<p>The first time that you go to Segue, you should see messages saying that Segue created the necessary tables in your database.<\/p>\n<p>Log in with user\/pass admin\/changeme to start using Segue.<\/p>\n<p>Enjoy!<\/a>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Untitled Segue is a web-based tool which should be run from a computer that is always on and has a static ip-address. You could run it otherwise, but then it would not be accessable to users when the machine is&hellip; <a href=\"https:\/\/segueproject.org\/segue-documentation\/segue-v1\/documentation\/for-administrators\/os-x-installation\/\" class=\"continue-reading\">More &rarr;<\/a><\/p>\n","protected":false},"author":29,"featured_media":0,"parent":480637,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-477391","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/pages\/477391","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/comments?post=477391"}],"version-history":[{"count":0,"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/pages\/477391\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/pages\/480637"}],"wp:attachment":[{"href":"https:\/\/segueproject.org\/segue-documentation\/wp-json\/wp\/v2\/media?parent=477391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}