Difference between revisions of "Porting Sites to CARMA"
m |
TMMStephenY (talk | contribs) |
||
Line 3: | Line 3: | ||
}} | }} | ||
− | + | 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. | |
− | |||
− | 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 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 | + | 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: | |
<pre> | <pre> | ||
Line 35: | Line 31: | ||
</pre> | </pre> | ||
− | + | 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 | + | |
− | changes. Finally, | + | 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 [[ | + | |
− | + | 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. | ||
− | + | If you have any problems porting your membership site to [[CARMA]], please [http://clients.toomuchmedia.com submit a support ticket]. |
Latest revision as of 16:12, 24 September 2010
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.