767
edits
Changes
Jump to navigation
Jump to search
Line 14:
Line 14: − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Tribal Altium Knowledge (view source)
Revision as of 11:07, 18 October 2017
, 11:07, 18 October 2017→Migrating from SVN pre-October 2017 to post-October 2017: added a lot of content
===How do I move?===
===How do I move?===
A large number of people were automatically given SVN credentials. If you did not, join {{slack-channel|altium}} and message {{slack-user|svn-admin}} requesting them. You will need to enter your username and very long and complicated password the first time you try to download an SVN but it will then be saved on your computer. Thanks to HTTPS/SSL, your password is never transmitted or stored in plain form, including when its checked on the server.
A large number of people were automatically given SVN credentials. If you did not, message {{slack-user|svn-admin}} in {{slack-channel|altium}} requesting them. You will need to enter your username and very long and complicated password the first time you try to download an SVN but it will then be saved on your computer. Thanks to HTTPS/SSL, your password is never transmitted or stored in plain form, including when its checked on the server or in Slack (which is encrypted).
[[File:root-folder.png|200px|thumb|Your root folder will look like this inside]]
[[File:SVNCheckout.png|thumb|200px|right|Make sure you're right clicking on the folder you just created.]]
====If you already have the Altium SVN on your computer====
# If you have Altium open on your computer, close it.
# Find the root folder of your Altium SVN repo (see right).
# Take note of the root folder's name, and then rename that folder to something else (i.e. add "-backup" to the name).
# Create a new folder with the same name as the old root folder you just renamed. We will refer to this new folder as ''altium-core'', the name of the repository you'll be syncing into it.
# Right click on ''altium-core'' and <nowiki>SVN Checkout...</nowiki> the new Altium repository, the URL of which is {{altium-url}} (see right).
# Hit OK on the window that comes up and wait while the repository downloads. This should take a minute or less. Report unusually long download times to {{slack-channel|altium}}.
# When complete, open Altium, and [[How to Install and Configure Altium#Open SSI Integrated Library|recompile the SSI Altium Library]].
# Verify that your capacitor and resistor database libraries are still installed, and [[How to Install and Configure Altium#Installing Resistor and Capacitor Database Libraries|reinstall them if necessary]]
You've successfully ported to the new Altium SVN! You can now also sync board files as described [[#Syncing board files|below]].
====If you did not have the Altium SVN on your computer====
You don't actually need to do anything. Follow the instructions in the [[How to Install and Configure Altium|installation guide]] normally. They have been updated to reflect the change in SVN hosting.
====Syncing board files====
[[File:badSVN.png|200px|thumb|Don't do this]]
[[File:goodSVN.png|200px|thumb|Do this instead]]
Board files (and other SVN-controlled files) are no longer stored in the same repository as the core Altium libraries, dramatically improving repository size. To sync a new repository, find its URL [[List of SVN Repositories|here]], create a new folder on your computer, and right click --> <nowiki>SVN Checkout...</nowiki> the new folder and copy in the relevant URL. '''DO NOT''' make the new folder inside of your ''altium-core'' folder, and, generally, do not put any SVN repository inside any other (see right).
You can sync any number of individual repositories onto your computer by checking them out as described in the above paragraph. Each repository needs its own folder. For organization, you're encouraged to make a new ''ssi-svn'' folder next to your ''altium-core'' folder, and then to make a subfolder in ''ssi-svn'' for each new repository. This is shown below.
Recommended Directory Structure:
<nowiki>
somewhere easy to access (Desktop, Documents, etc)
--> altium-core
--> libraries
--> README
--> ssi-svn
--> satellites-altium
--> project files
--> balloons-altium
--> project files
...</nowiki>
===Why did this migration happen at all?===
===Why did this migration happen at all?===