Typo Installation (Shared cPanel Servers)

Miraenda — Fri, 02 Jun 2006 08:53:00 -0700

This version of Typo requires FastCGI and Rails version 1.1. The current servers that this will work on are Gallifrey and Telos.

A. Creating your database for Typo:

Log into cPanel and click on MySQL Databases icon:

As per the example below, enter typo in the "New Database" field under Current Databases area, then click "Create Database" button. Your full database name will then show as cPaneluser_typo.

Under Current Users area as seen in the example below, enter typo for the "Username" field and enter a password that you write in your notes for the "Password" field, then click "Create User" button. Your full database user's name will then show as cPaneluser_typo.

Under Add Users to Your Database area as shown below, select in the "User" dropdown cPaneluser_typo and select in the "Database" dropdown cPaneluser_typo, then click "Add User to Database" button.

B. Get a Copy of typo.tar.gz

Download a copy of the current release (svn copy) from here. After obtaining a copy that you have saved to your system, you can then proceed with the next steps.

C. Upload Typo Using cPanel:

Log into cPanel.
Click on "File Manager" icon:

A new window will open. In that new window, click on "Upload File(s)" link toward the top:

The page will load new content. Click one of the "Browse..." buttons:

The Windows "File Upload" dialog prompt will open. Navigate to where you saved typo.tar.gz on your system, highlight typo.tar.gz, then click the "Open" button.

Back at the File Manager screen where you have the "Browse..." button, click the "Upload" button:

Typo will begin uploading. Please note that it might take awhile for it to upload due to the size, usually around 3-15 minutes depending on your connection speed.

D. Upload Typo via FTP:

If you prefer to use FTP to upload so you see the progress of the file upload, try the following instead

Open your FTP client and access your account via FTP with most clients using the following to connect:
Host/Address: domain.com
Username: cPanelusername
Password: cPanelpassword
Highlight the file typo.tar.gz on your system where you saved it and right click.
Select upload (it needs to be uploaded to your main directory not inside public_html folder, so you should be at the level where you see public_html listed as a folder)
Wait for the file to complete uploading.
You can view an image of what Filezilla FTP client would look like for this process at this location.

E. Extracting Typo:

Log into cPanel if you aren't already logged into it.
Click on "File Manager" icon if you aren't already in there:

A new window will open for File Manager, then click on the typo.tar.gz file name (not the icon):

In the upper right hand corner, there are a list of links. Select "Extract File Contents" link in that list:

A new window will open with the extracted files and folders listed as the extraction processes. Wait until this finishes (will say Done at the bottom left of most browsers once completed), then close the new window.
In the File Manager window, refresh your browser. You should now see a folder called typo there:

F. Changing the database.yml file for your database details:

In File Manager, click on the folder icon to the left of the typo folder:

Click on the folder icon to the left of the config folder:

Click on the database.yml file name (not the icon):

In the upper right hand corner, click on "Edit File" link as shown below.

A new window will open with the following in it:
login: &login adapter: mysql host: localhost username: cPaneluser_typo password: database user pass here development: database: cPaneluser_typo <<: *login test: database: cPaneluser_tests <<: *login production: database: cPaneluser_typo <<: *login

Replace cPaneluser with your cpanel username (there are 4 instances of this on lines 4, 8, 12 and 16). Do not remove the _typo or _tests part. For example, I would replace cPaneluser_typo with rubyasyl_typo for my rubyasylum.com account.
In the password: line (line 5), input the password you used when creating your database user earlier.
Click the "Save" button, then close that window (keep the File Manager Window open though).

G. Importing the database:

In File Manager, click on the "Up one level" link toward the top to go back to the main typo folder:

Click on the folder icon to the left of the db folder:

Click on the schema.mysql-v3.sql file name (not the icon):

In the upper right hand corner, click on the "Show File" link:

A new window will open. Copy the contents of that file from the --This file is autogenerated by the Rail schema generator, using line to the bottom of the file. Paste those contents into notepad or some note program (do not use MS Word).
Close the File Edit Window and Close File Manager Window.
Back in the main cPanel area, click on "MySQL Databases" icon:

Sroll to the bottom of that area, then click on the "phpMyAdmin" link, which opens a new window:

In the new window, click on the name of your database (should be cPaneluser_typo where cPaneluser is your cPanel username) on the left hand side:

In the top center, click on the "SQL" tab:

Take the Notepad contents that you copied above in this section Step 3, then paste all of that into the Run SQL query/queries on database box in phpMyAdmin:

Click the "Go" button:

Close out of the phpMyAdmin window.

H. Symlinking your folder to typo:

In cPanel main area, click on "Cron Jobs" icon:

Click "Advanced (Unix Style)" button:

Enter the following as an example in the Advanced area:

Minute Hour Day Month Weekday
10     7    *   *     *

This would run the cron at 7:10am Pacific time each day of the week. Change the 10 to a time 5 minutes from the current hour (so if it is currently 11:27am, change to 32 for the Minute). Change the hour to the current hour (so if it is currently 11:27am, change to 11).

Enter the following for the Command field:

cd /home/username/public_html && ln -s ../typo/public typo

Replace username in the command path with your cPanel username, then click "Commit changes" button. See the image below for an example of what the area might look like before you click that button:

After you click "Commit changes" button, then click the Go Back link on the new screen:

Wait for the cron job to process (around 10 minutes after you created it), then delete the cron using the "Delete" link to the far right of it in the "Advanced (Unix Style)" area:
Please note that it is very important that you perform this delete step so this cron does not keep running daily as you only want it to run this one time for the symlink creation.
You can check if the symlink actually worked by going into "File Manager" area, clicking on the folder icon next to public_html, then on the folder icon next to the new typo folder that should now be in public_html folder. It should have the same contents that /home/username/typo/public does.

I. Running rake migrate in cron:

In cPanel main area, click on "Cron Jobs" icon again:

Click "Advanced (Unix Style)" button:

Enter the following as an example in the Advanced area:

Minute Hour Day Month Weekday
10     7    *   *     *

As before, this would run the cron at 7:10am Pacific time each day of the week. Change the 10 to a time 5 minutes from the current hour (so if it is currently 11:27am, change to 32 for the Minute). Change the hour to the current hour (so if it is currently 11:27am, change to 11).

Enter the following for the Command field:

cd /home/username/typo && /usr/local/bin/rake migrate

Replace username in the command path with your cPanel username, then click "Commit changes" button.
After you click "Commit changes" button, then click the Go Back link on the new screen:

Wait for the cron job to process (around 10 minutes after you created it), then delete the cron using the "Delete" link to the far right of it in the "Advanced (Unix Style)" area:
Please note that it is very important that you perform this delete step so this cron does not keep running daily as you only want it to run this one time for the database migration.

J. Loading up Typo in a browser:

Now you can load up your Typo script in a browser using http://yourdomain.com/typo/ (replace yourdomain.com with your actual domain name).
If th rake migrate cron job in Section I failed, you would see a MySQL error about cPaneluser_typo.triggers. If you are unable to get the rake migrate cron to process for you, please open a ticket to support@lunarpages.com with the last 4 digits of your credit card on file with us or the billing address, zip code, telephone number and the first and last characters of your cPanel password for confirmation along with the request to run rake migrate from your /home/username/typo folder. Please ensure you provide your cPanel username in the ticket and the url for typo in a browser that is returning the error (so http://yourdomain.com/typo/ where yourdomain.com should be replaced by your actual domain name). This way once we run the command we will know if the script is working as we will be able to test the Typo page in a browser.
Once the command has been processed (by your cron or by us running the command), you should then see the Signup screen where you can pick your login details and password for the administrative area. The administrative area will be at http://yourdomain.com/typo/admin/, while your site blog will be at http://yourdomain.com/typo/

Have fun blogging!

"Typo Installation (Shared cPanel Servers)" by madison k

Tue, 23 Sep 2008 18:15:30 -0700

im stink

"Typo Installation (Shared cPanel Servers)" by dmitri

Tue, 23 Sep 2008 18:14:57 -0700

you suck

"Typo Installation (Shared cPanel Servers)" by amin

Tue, 23 Sep 2008 18:14:12 -0700

"Typo Installation (Shared cPanel Servers)" by Dmitri

Sun, 14 Sep 2008 11:21:32 -0700

I answered my own question! Yes, the hour has to be in Pacific time, I would imagine either PDT or PST depending on time of year. For your international users, the time can be found here: http://time.gov/timezone.cgi?Pacific/d/-8/java

"Typo Installation (Shared cPanel Servers)" by Dmitri

Sun, 14 Sep 2008 11:18:39 -0700

I have a question about running the commands as cron jobs. Do I need to convert my local time into Lunarpages local time? I imagine that Lunarpages uses Pacific time, but I can't seem to find a way to figure out the actual server time.

"Typo Installation (Shared cPanel Servers)" by lucy

Wed, 16 May 2007 19:35:49 -0700

Thank you for your instruction, worked very well, very happy to see the app up and running in 20 minutes. (probably less time needed, I was watching tv at the same time)

"Typo Installation (Shared cPanel Servers)" by oDesk

Tue, 01 May 2007 07:55:10 -0700

step by step installation guide, it could be used for other rails applications too. very nice, Thanks

"Typo Installation (Shared cPanel Servers)" by Thanks!

Tue, 13 Feb 2007 13:11:19 -0800

It worked like a charm, good write up, thanks!

"Typo Installation (Shared cPanel Servers)" by Miraenda

Thu, 05 Oct 2006 07:01:59 -0700

Hi budee,
Is your cPanel username actually bluedee and is the path to your public_html actually /home/bluedee/public_html ? If you aren't on cPanel, your path would be different. I have an account with Lunarpages with username daniel4 that is path /home/daniel4/public_html to my public_html folder. Most Lunarpages accounts have a number in the username, so if you are with Lunarpages, bluedee is likely not your cPanel username. Without knowing your actual path, username or whether you are on cPanel or not, I can't say what your path would be. If you aren't sure the path, you can always contact support for your host (if Lunarpages that would be support@lunarpages.com) to have the host tell you the path.

Have a Blessed Day

"Typo Installation (Shared cPanel Servers)" by budee

Wed, 04 Oct 2006 23:36:18 -0700

Hello Miraenda, When I were following your tutorial, I was stucked in symlink process. It didn't work as it should be. I didn't have any typo folder in my public_html. I set this in my cron cd /home/bluedee/public_html && ln -s ../typo/public typo I had waited for about 10 minutes like you said. But, nothing changed.

Ruby Asylum: Typo Installation (Shared cPanel Servers)

Typo Installation (Shared cPanel Servers)

"Typo Installation (Shared cPanel Servers)" by madison k

"Typo Installation (Shared cPanel Servers)" by dmitri

"Typo Installation (Shared cPanel Servers)" by amin

"Typo Installation (Shared cPanel Servers)" by Dmitri

"Typo Installation (Shared cPanel Servers)" by Dmitri

"Typo Installation (Shared cPanel Servers)" by lucy

"Typo Installation (Shared cPanel Servers)" by oDesk

"Typo Installation (Shared cPanel Servers)" by Thanks!

"Typo Installation (Shared cPanel Servers)" by Miraenda

"Typo Installation (Shared cPanel Servers)" by budee