Difference between revisions of "Porting Sites to CARMA"

From TMM Wiki
Jump to navigationJump to search
m
 
 
Line 3: Line 3:
 
}}  
 
}}  
  
The first step of porting an existing membership site to CARMA is
+
If you wish to port an existing membership site to [[CARMA]], you should first set up a test site. This test site will allow you to continue using your preexisting site until your CARMA-powered site is ready.
setting up a test site. This lets you continue using your existing site
 
until your CARMA-powered site is ready. Choose a domain name for your
 
test site. For example, testsite.example.com. Have your host setup
 
testsite.example.com on the same server as your actual site, [[Add Site|add the site]] in CARMA, and configure the new site.
 
  
While configuring your new site, try to use relative URLs, not absolute URLs. You will need to update any absolute URLs when you go live. For example:
+
Choose a domain name for your test site-- for example, testsite.example.com. Then, have your host set up testsite.example.com as your actual site, [[Add Site|add the site]] in CARMA, and configure your new site.
 +
 
 +
When you are configuring your new site in [[CARMA]], try to use relative URLs as opposed to absolute URLs. If you use absolute URLs, you will have to update your URLs when you go live. The following is an example of an absolute URL and a relative URL:
  
 
* Absolute URL: <nowiki>http://testsite.example.com/test.html</nowiki>
 
* Absolute URL: <nowiki>http://testsite.example.com/test.html</nowiki>
 
* Relative URL: <nowiki>/test.html</nowiki>
 
* Relative URL: <nowiki>/test.html</nowiki>
  
Note: because relative URLs are shorter, they take up less space.  You save disk space and bandwidth, and your members can download pages faster.
+
'''Note''': because relative URLs are shorter, they take up less space.  You save disk space and bandwidth, and your members can download pages faster.
  
 
== Going Live ==
 
== Going Live ==
After the site is looking and working the way you want, make your Apache
+
After you have configured your site, and it is looking and working the way you want, you will have to configure your Apache settings. Make the Apache configuration for your actual site point to the same server directory as your ''testsite.example.com''.
configuration for your actual site point to the same server directory as
 
your testsite.example.com
 
  
For example, the following Apache site configuration,
+
For example, the following Apache site configuration:
  
 
<pre>
 
<pre>
Line 28: Line 24:
 
</pre>
 
</pre>
  
should be changed to:
+
Should be changed to:
  
 
<pre>
 
<pre>
Line 35: Line 31:
 
</pre>
 
</pre>
  
Your configuration might be slightly different but the general concept
+
Although your configuration may slightly vary from the example, the general concept remains the same. Once the necessary changes have been made, restart Apache in order to apply your changes.
remains the same. Once the changes are made, restart Apache to apply the
+
 
changes. Finally, you must replace the testsite.example.com hostname
+
Finally, replace the ''testsite.example.com'' hostname in with the actual site's hostname, which can be found in the CARMA's [[CARMA Sites Admin|Sites Admin]]. For example, replace ''<nowiki>http://testsite.example.com</nowiki>'' with ''<nowiki>http://actualsite.example.com</nowiki>''.
with the actual site hostname in CARMA's [[Site Admin]]. If the
+
 
hostnames are wrong, CARMA can't load the correct site.  For example,
+
If the hostnames you have provided are incorrect, [[CARMA]] will not be able to load the correct site. Once you have finished configuring all of the above steps, the only thing left to do is update any remaining absolute URLs that you have configured.
replace http://testsite.example.com with http://actualsite.example.com.
 
  
After that is done the only thing you have to do is update any remaining absolute URLs.
+
If you have any problems porting your membership site to [[CARMA]], please [http://clients.toomuchmedia.com submit a support ticket].

Latest revision as of 17:12, 24 September 2010

CARMA
Setup
Setting Up CARMA
MySQL Settings
Add Site
Porting Sites to CARMA
Moving CARMA

If you wish to port an existing membership site to CARMA, you should first set up a test site. This test site will allow you to continue using your preexisting site until your CARMA-powered site is ready.

Choose a domain name for your test site-- for example, testsite.example.com. Then, have your host set up testsite.example.com as your actual site, add the site in CARMA, and configure your new site.

When you are configuring your new site in CARMA, try to use relative URLs as opposed to absolute URLs. If you use absolute URLs, you will have to update your URLs when you go live. The following is an example of an absolute URL and a relative URL:

  • Absolute URL: http://testsite.example.com/test.html
  • Relative URL: /test.html

Note: because relative URLs are shorter, they take up less space. You save disk space and bandwidth, and your members can download pages faster.

Going Live

After you have configured your site, and it is looking and working the way you want, you will have to configure your Apache settings. Make the Apache configuration for your actual site point to the same server directory as your testsite.example.com.

For example, the following Apache site configuration:

ServerName testsite.example.com
DocumentRoot /path/to/members.yoursite.com

Should be changed to:

ServerName actualsite.example.com
DocumentRoot /path/to/members2.yoursite.com

Although your configuration may slightly vary from the example, the general concept remains the same. Once the necessary changes have been made, restart Apache in order to apply your changes.

Finally, replace the testsite.example.com hostname in with the actual site's hostname, which can be found in the CARMA's Sites Admin. For example, replace http://testsite.example.com with http://actualsite.example.com.

If the hostnames you have provided are incorrect, CARMA will not be able to load the correct site. Once you have finished configuring all of the above steps, the only thing left to do is update any remaining absolute URLs that you have configured.

If you have any problems porting your membership site to CARMA, please submit a support ticket.