|
Frequently
Asked Questions about
StarTeam
|
Moving a StarTeam Repository
Send
this document to a colleague
Information in this Brief applies to:
-
StarTeam Server 3.x, 4.x
-
MS SQL 6.6, 70
-
MS Access
|
Summary
Moving a StarTeam project repository from one machine to
another requires a few steps of special setup to ensure that the new
machine to receive the StarTeam repository has the correct cipher phrase
and DSN created. In order to perform the move successfully, the
following conditions must be met:
-
You will need to know the Cipher key for the Repository.
-
You will need to install StarTeam VirtualTeam Server on
new Computer where the repository will be located.
-
Know the back end database you are using with the
repository.
-
Be aware of any foreign archives that the repository is
using.
-
Make certain that if the StarTeam VirtualTeam Server
configuration is currently running as a service, to first change it back
to run as an application. You can do this by going into the
Control Panel - Services applet, choose the StarTeam server
configuration, click "Stop", after the StarTeam server service has
stopped startup the StarTeam Virtual Server application, choose that
configuration and click the "Remove Service" button. Do not start
the StarTeam server configuration at this point, but make certain that
after moving the repository that it will startup first as an
application, then you can set it as a service once again by clicking the
"Set Service" button in the StarTeam VirtualTeam Server application.
More Information
Moving the .scg and cph files:
-
Stop the StarTeam server on the old machine.
-
Copy the repository directory to the new computer or
hard drive. Try to maintain the same same directory structure.
If the directory structure has changed for the repository on the new
machine, you will have to update the StarTeam .scg before running the
StarTeam server. See Running the server for the first time.
-
Copy the configuration file and cipher file in the
StarTeam Virtual Team Server Config Files directory to the new StarTeam
Virtual Team Server Config Files directory.
Ex.
C:\Program Files\StarTeam VirtualTeam Server 4.0\Config
Files\DEMO.SCG
C:\Program Files\StarTeam VirtualTeam Server 4.0\Config
Files\DEMO.CPH
Manually recreating the ODBC connection:
-
Start the StarTeam Virtual Team Server.
-
Select the repository you wish to start.
-
Click on the Properties button.
-
To the right of the Cipher name box click on the Verify
Button.
-
Re-enter the cipher key phrase that was used to create
the repository.
-
Click on the Database tab.
-
Highlight the entry in the DSN box.
-
Hold the Ctrl key and hit the C key on the keyboard.
This will copy the name entry to the clipboard.
-
Click on the Ok button.
-
Click on the Windows Start button at the bottom lower
left of the desktop.
-
Click on the Settings menu and select the Control Panel.
-
From the Control Panel select the select the ODBC icon.
-
In the ODBC controls select the System DSN tab.
-
In the ODBC System DSN tab click on the Add button.
-
Scroll down the list of Create New Database source and
select the appropriate database driver. Click on the Finish button.
-
Move your pointer to Data Source Name box and click.
Hold the CTRL key down and hit the V key on the keyboard this should
paste the DSN name from step 9 and 10.
-
You can enter any useful information in the description
box if you wish.
If your StarTeam backend database is MS SQL, follow
these additional steps:
a. Select SQL Server.
b. Ctrl+V in the DNS Name box.
c. Enter the description for the System DSN.
d. Select the SQL Server where you created the SQL database.
e. Leave the Network Address and Library box as (Default).
f. Click on the Option button.
g. In the Database name box Select the SQL database for StarTeam and
Click on the OK button.
h. Also place a check mark in the box on the following items:
"Use ANSI quoted Identifiers"
"Use ANSI nulls, padding, and
warnings"
Note: If your ODBC MS SQL driver does not support "Use ANSI quoted
Identifiers" or "Use ANSI nulls, padding, and warning" please update the
MS SQL ODBC drivers.
If your StarTeam backend database is MS Access,
follow these additional steps, and then skip to step :
a. Click on the Select button in the Database box.
b. In the Select Database dialog box find the repository directory that
you have moved.
c. Select the Database folder under the repository folder.
d. Select the Database file *.mdb.
-
In the ODBC Data Source Administrator click on the OK
button.
-
Move your pointer on the Red box in the System Tray,
select server configuration Menu appears.
Running the server for the first time:
If you have move the repository to a different directory or hard drive
letter other than the original creation setting please use the following
steps:
-
Click on the StarTeam VirtualTeam server icon and launch
the "select server configuration" dialog box.
-
Select the server configuration you would like to start,
and select the properties button.
-
Set the new path for the Server startup log path.
-
Select the check box "View server configuration before
server starts", and then click OK.
-
Start the StarTeam server configuration.
-
Enter user logon and password.
-
In the StarTeam VirtualTeam Server Configuration dialog
box on the General Tab in the Attachments Box make sure that the path is
pointing to the new locations.
-
In the StarTeam VirtualTeam Server Configuration dialog
box on the Vault Tab make the sure that the following item are pointing
to the correct directory:
-
Vault Path
-
Disk Cache Path
-
Archive Path
|