Académique Documents
Professionnel Documents
Culture Documents
Legal Notices.................................................................................................................4
1 Replication Overview..................................................................................................7
2 Setting Up Replication................................................................................................9
Setting Up the Primary Vault.............................................................................................................10
Installing the Enterprise PDM Software at the Remote Office...........................................................11
Setting Up Replication on the Main Server.......................................................................................12
Initiating Replication..........................................................................................................................14
Replication Settings Dialog Box........................................................................................................15
Testing Replication Connections.......................................................................................................17
Connection Test Failures.............................................................................................................17
Changing the Source Server Address...............................................................................................19
Configuring Replication Retries.........................................................................................................20
3 On-Demand Replication...........................................................................................21
What Are File Archives......................................................................................................................21
How On-demand Replication Works.................................................................................................22
4 Scheduled Replication..............................................................................................24
Defining Replication..........................................................................................................................24
New Replication Schema Dialog Box..........................................................................................26
Advanced Schema Settings Dialog Box......................................................................................28
2
Contents
3
Legal Notices
1995-2014, Dassault Systmes SolidWorks Corporation, a Dassault Systmes S.A. company,
175 Wyman Street, Waltham, Mass. 02451 USA. All Rights Reserved.
The information and the software discussed in this document are subject to change without
notice and are not commitments by Dassault Systmes SolidWorks Corporation (DS SolidWorks).
No material may be reproduced or transmitted in any form or by any means, electronically or
manually, for any purpose without the express written permission of DS SolidWorks.
The software discussed in this document is furnished under a license and may be used or
copied only in accordance with the terms of the license. All warranties given by DS SolidWorks
as to the software and documentation are set forth in the license agreement, and nothing
stated in, or implied by, this document or its contents shall be considered or deemed a
modification or amendment of any terms, including warranties, in the license agreement.
Patent Notices
SolidWorks 3D mechanical CAD software is protected by U.S. Patents 5,815,154; 6,219,049;
6,219,055; 6,611,725; 6,844,877; 6,898,560; 6,906,712; 7,079,990; 7,477,262; 7,558,705;
7,571,079; 7,590,497; 7,643,027; 7,672,822; 7,688,318; 7,694,238; 7,853,940; 8,305,376;
8,581,902; 8,817,028, and foreign patents, (e.g., EP 1,116,190 B1 and JP 3,517,643).
eDrawings software is protected by U.S. Patent 7,184,044; U.S. Patent 7,502,027; and
Canadian Patent 2,318,706.
U.S. and foreign patents pending.
4
consistent with the policies set forth in 48 C.F.R. 227.7202-1 (JUN 1995) and 227.7202-4 (JUN
1995).
In the event that you receive a request from any agency of the U.S. Government to provide
Software with rights beyond those set forth above, you will notify DS SolidWorks of the scope
of the request and DS SolidWorks will have five (5) business days to, in its sole discretion,
accept or reject such request. Contractor/Manufacturer: Dassault Systmes SolidWorks
Corporation, 175 Wyman Street, Waltham, Massachusetts 02451 USA.
5
Portions of this software 1998-2001 3Dconnexion.
Portions of this software 1998-2014 Open Design Alliance. All rights reserved.
Portions of this software 1995-2012 Spatial Corporation.
The eDrawings for Windows software is based in part on the work of the Independent JPEG
Group.
Portions of eDrawings for iPad copyright 1996-1999 Silicon Graphics Systems, Inc.
Portions of eDrawings for iPad copyright 2003 2005 Apple Computer Inc.
6
1
Replication Overview
Clients connect to an Enterprise PDM vault through their local vault view. When they browse
for files or items, view data cards, or search for files, Enterprise PDM retrieves data from the
database server. When clients use the Get or Check out commands to retrieve physical files
(such as drawings and documents) to the local vault view (cache), the software retrieves the
files from the archive server.
The time it takes to transfer these files depends on the size and speed of the network.
In a LAN environment, the files are normally transferred quickly since the archive server resides
locally to the clients.
In a WAN environment, an Enterprise PDM vault that is shared between multiple offices relies
heavily on the speed of the connection.
In the following not-replicated Enterprise PDM WAN environment, two remote offices
communicate with a central Enterprise PDM database server and archive server located at the
Main office.
7
Replication Overview
The information from both the database server and the physical archive server is transferred
over the WAN. Calls to the database server are speedy because only small packets of data are
sent. File requests can take anywhere from seconds to hours depending on the file size.
You can use Enterprise PDM vault replication to balance the amount of data that is transferred
over a slow WAN connection by providing each office with a local archive server that hosts a
replicated copy of the vault archive. When remote clients work in the vault, they still receive
database information from the central database server, but the physical files are now retrieved
from the closest archive server with a copy of the archived file.
In the following replicated Enterprise PDM environment, each office communicates with the
central database server. In addition, each office has a local archive server hosting a replicated
copy of the file archive.
If the file archive has already been replicated, the file is retrieved from the local archive server
in the WAN office. If the file has been added to an archive server in another office and has not
yet been replicated to the local archive server, the file archive is automatically replicated when
it is initially retrieved by a client so that the archived file is then accessible on the local archive
server to all other clients in the same office.
8
2
Setting Up Replication
To set up replication:
1. In the main office, install SQL Server and the Enterprise PDM database and archive servers,
and create the primary vault.
2. In a remote location, install only an Enterprise PDM archive server.
3. On the main office archive server, set up replication by creating a vault that replicates the
remote vault. This also replicates the primary vault on the remote archive server.
The communications between the sites must meet these prerequisites:
The SQL server hosting the vault database must be accessible from clients in both offices.
If the offices are connected over a WAN, the default TCP port 1433 for SQL communication
must be fully opened both ways through any firewalls, preferably using a VPN connection
for security.
Each office must have a server (or workstation) with a hard drive large enough to install
the Enterprise PDM archive server and store all or some of the replicated vault archive.
If you use WAN communication, open the default TCP port 3030 between each archive server
system and the default TCP port 1433 to the SQL server.
If you use a named SQL instance instead of the default instance, MSSQLSERVER, the TPC
port for SQL communication may use a different port, typically port 1434.
If you use Windows login for the vault, both offices must have access to the domain users.
This is not required if you set up a domain trust so that the local Windows domain users
are correctly defined on the local domain controller. See the Microsoft TechNet library for
configuration information.
In the following procedures, the main office hosts the SQL server, database server, and archive
server (Archiveserver). A remote office hosts only a second archive server (Server2).
9
Setting Up Replication
1. Install the SQL server, the Enterprise PDM database server, and the Enterprise PDM
archive server software.
See the Solidworks Enterprise PDM Installation Guide.
2. Install one or more Enterprise PDM client workstations.
10
Setting Up Replication
3. From an Enterprise PDM client, use the Administration tool to connect to the archive
server and create and configure a new vault:
a) Open the Administration tool by doing one of the following:
On Windows 7 and Windows Server systems prior to Windows Server 2012, click
Start > All Programs > SolidWorks Enterprise PDM > Administration.
On Windows 8 and Windows Server 2012 or later, on the Apps screen, under
SolidWorks Enterprise PDM, click Administration.
b) In the top left corner of the SolidWorks Enterprise PDM Administration dialog box,
right-click the archive server and click Create new vault.
c) Complete the Create New Vault wizard.
The new vault is added under the archive server.
4. On the remaining clients that connect to the main office archive server, create a local
vault view of the new vault on the archive server:
a) Open the View Setup Wizard by doing one of the following:
On Windows 7 and Windows Server systems prior to Windows Server 2012, click
Start > All Programs > SolidWorks Enterprise PDM > View Setup.
On Windows 8 and Windows Server 2012 or later, on the Apps screen, under
SolidWorks Enterprise PDM, click View Setup.
b) Complete the wizard screens.
1. Install the Enterprise PDM archive server, using the settings that were used to install
the archive server in the main office.
For example:
11
Setting Up Replication
Use the SQL user name and password that are used on the SQL server installed in
the main office.
If you use the Windows login type on the primary archive server, all other archive
servers should use the same login type.
2. Install one or more Enterprise PDM client workstations.
Do not create vault views on the clients in the remote office until the vault has
been replicated.
A replicated vault uses only one centrally shared SQL database, so both vault nodes are
identical and you can administer either one. The only difference is that the replicated
vault uses the login/security settings of the source vault.
Before beginning:
Ensure that communications between the offices are set up.
The remote server is running.
TCP port 3030 is open.
The archive server service is started.
Obtain the login information of a user account with Attach access or Administrative
access in the remote archive server security settings.
The local administrator on the remote archive server system has this access by
default.
12
Setting Up Replication
1. On an Enterprise PDM client attached to the main office archive server, open the
Administration tool by doing one of the following:
On Windows 7 and Windows Server systems prior to Windows Server 2012, click
Start > All Programs > SolidWorks Enterprise PDM > Administration.
On Windows 8 and Windows Server 2012 or later, on the Apps screen, under
SolidWorks Enterprise PDM, click Administration.
If the remote server is not running or the connection is blocked, you receive an
error message that Enterprise PDM could not connect to the archive server.
Ensure that the prerequisites are met and begin the procedure again.
4. Click OK.
5. When prompted, log in using a Windows user account with Attach or Administrative
access in the remote archive server security settings.
The remote server is listed in the left pane of the Administration tool.
6. Right-click the remote server name and click Add replicated vault.
7. If prompted, log in as a Windows user with administrative access.
8. When the replication wizard starts, click Next.
9. On the Select archive server source screen, for Archive Server, select the main
office archive server that currently hosts the file vault archive, and click Next.
In a WAN environment, use the IP address. Otherwise, use the DNS name to avoid
problems later if the IP address cannot be resolved to the correct server name.
10. On the Select source vault screen, select the vault to replicate and click Next.
11. If prompted, log in to the vault as the Enterprise PDM Admin user or as a user with
permission to replicate vaults.
12. On the Select destination folder screen, select a root folder on the remote server
where the replicated vault archive should be placed.
If the archive server was installed using defaults, the root folder is Archives.
13. Click Finish.
The replication wizard creates settings and archive folders on the remote server.
The created folders are empty because files in the source vault are not yet
replicated.
The replicated vault appears under both servers in the Administration tool. If you do
not see it, right-click the server and click Refresh.
13
Setting Up Replication
The Replication settings dialog box for the remote archive server tries to open.
14. If a login screen appears, log in as a user with permission to manage vault replication.
The Admin user has this permission by default.
This login triggers replication of vault-specific security settings such as the admin
password and login type from the main office archive server to the remote archive
server.
The Replication settings dialog box appears, showing the connections between the
two systems. By default, the archive server names are used as connection addresses.
You can use this dialog box to test the connections. See Testing Replication
Connections on page 17.
Initiating Replication
This procedure configures the main office and remote office servers for on-demand
replication. This means that a file added by a client attached to the main office archive
server can be retrieved by a client attached to the remote archive server. When the file
is retrieved, the archive is replicated to the remote server.
14
Setting Up Replication
To initiate replication:
1. On an Enterprise PDM client connected to the main office archive server, in the
Administration tool, click the replicated vault for the remote archive server.
2. If a vault login appears, log in as a user with permission to manage vault replication.
The initial login replicates vault-specific security settings, such as admin password
and login type, from the main office archive server to the remote archive server.
3. If you see a message that you need to run the replication settings command on the
source server:
a) Click OK.
b) Close and reopen the Administration tool.
4. Log in to the vault on the main office archive server.
5. Double-click Replication settings .
The Replication settings dialog box lists the local and remote servers and lets you
test the connections.
6. In the Test column, check a target/source server pair and click Test.
7. In the Test Connections dialog box, view the connection Status.
8. If the status is not Succeeded, click Test.
9. If the connection still does not succeed, save the test results to a .csv file by clicking
Save.
10. Click Exit.
Connections
Lists source and target replication servers.
Target Server Specifies the server where files are replicated to.
Source Server Specifies the server where files are replicated from.
Source Server Address The DNS system name or IP address that the Target Server
uses to communicate with the Source Server.
15
Setting Up Replication
Test Opens the Test Connections dialog box, where you can test
the connection from the Source Server to the Target Server.
This button is only enabled when the Test check box for a
target/source server pair is checked.
Selected connection
IP address or DNS The IP address or DNS name of the selected source server.
name
In a WAN environment, use the IP address.
The archive servers communicate over TCP port 3030. Make
sure that port is fully opened in any firewall between the
servers.
Replication schemas
Lists the replication schemas defined and the folders that are replicated for each schema.
New Schema Opens the New Replication Schema dialog box, where you can
select the folders to be replicated, the connections to replicate,
and replication intervals.
Edit Schema Opens the Edit Replication Schema dialog box for the selected
schema.
16
Setting Up Replication
1. Expand the vault you want to test and double-click Replication settings.
2. In the Replication settings dialog box, in the Test column, select the target/source
server pair to test.
3. Click Test.
The button is unavailable if you have unsaved settings. Click Save , and then
reselect the connection to test.
If you change the source server address, wait a short time for the connection to be
updated before testing it. See Changing the Source Server Address on page 19.
4. In the Test Connections dialog box, click Test.
If the connection is configured correctly, the result column returns Test successful.
If the replication connections are blocked or not working, the test can take some
time to complete or time out. Wait until you get a result.
If a connection returns a failed test result, no file archives can be replicated from the
source server to the target server for that specific connection.
The most common reasons a replication connection fails between two systems are:
Blocked TCP port 3030 on the source server
Verify the archive server port is open.
Failed DNS name lookup from the target server to the source server using the source
server address
Verify that the server can be reached by ping command.
Database server service not running
Verify that the database server service is started and can reach the target servers by
name over TCP port 3030.
17
Setting Up Replication
Changes to the source server address in the replication settings do not take effect if
the database server service is not working correctly. Restart the archive server service
on the target server to force a reload of the updated address.
The following table lists some of the warnings that are shown in the Results column of
the Test Connections dialog box when a replication test fails.
18
Setting Up Replication
1. Expand the vault where you want to make the change and double-click Replication
Settings.
2. Click the connection with the Source Server Address you are changing.
3. Under Selected connection, type the new source server DNS name or IP address.
In a WAN environment, use the IP address. In other environments, use the DNS name
to avoid problems later if the IP address cannot be resolved to the correct server
name.
4. In the Administration tool toolbar, click Save .
5. After waiting a short time for the changed address to be updated on the target server,
test the connection by selecting it and clicking Test.
See Testing Replication Connections on page 17.
6. If your changes do not take effect, verify that the database server service is working
correctly and can connect to the target server.
If the database server service is not working, restart the archive server service on
the target server to force a reload of the updated source server name.
19
Setting Up Replication
20
3
On-Demand Replication
On-demand replication is always in effect, allowing a file archive that is not yet replicated to
the archive server to be replicated when the file is requested by a client connected to that
archive server. The on-demand replication always allows clients to retrieve files, whether its
file archive is available on the local archive server or not.
21
On-Demand Replication
*.img For files that support thumbnails, a thumbnail image is stored for
each version created.
Index.xml The archive's index file contains information on each version of the
file and (in most cases) the filename.
State/Action Result
Non-replicated One archive server hosts all physical files and versions that
environment. are placed in the vault.
The file archives are stored in the vault archive folder on the
first archive server. The archive root folder on the second
server does not contain any file archives.
The vault is replicated to The second archive server also hosts a copy of the vault
a second server. archives.
The vault archive folders are available in the archive root
folder of both servers.
Archives added on the first archive server can be replicated
to the second archive server.
Archives added to the second server can be replicated to
the first server.
A client that is attached to The physical file (and all versions of the file) are initially
the first archive server stored in the file archive of the first archive server.
adds a file in the local
The file archive folder on the first server contains all versions
vault view.
of the file. The file archive folder and its contents have not
yet been replicated to the second server and therefore do
not exist on the second server.
22
On-Demand Replication
State/Action Result
A client that is attached to the second The second archive server tries to send the file
archive server retrieves a version of the from its file archive folder to the client.
newly-added file to the local vault view.
If the specified file version does not yet exist
Even if the archive server that the in the second server's file archive folder, an
client is attached to does not yet have on-demand replication is triggered and the
a replicated copy of the file archive, specified version is replicated from one of the
the client sees the file when browsing other archive servers that has the specified file
in the vault view because the archive.
information about the file comes from After the replication of the file is complete, any
the database server. The archive additional clients attached to the second
server only maintains the physical file archive server can retrieve that file version
content. directly from the second server's archive folder.
A client that is attached to the second The new version of the file is created in the file
archive server creates a new version of archive on the second archive server.
the file.
The new version is stored on the second
archive server until it is requested by a client
triggering an on-demand replication back to
the first archive server.
23
4
Scheduled Replication
The default method for replication in Enterprise PDM is on-demand replication. When a client
requests a file that has not yet been replicated, the client triggers a replication of the archive.
See How On-demand Replication Works on page 22.
To automate the replication process, you can set up replication schemas that run on selected
parts of the file vault, between specified archive servers that host the replicated vault archive,
at set intervals. With scheduled replication, a client always has speedy access to the files on
the local archive server the client is attached to.
You can define any number of replication schemas to balance the network load.
The database server service updates the replication schedules to each archive server. Before
you define replication schemas, ensure that the service is installed and running on the SQL
server system by checking the services for the SolidWorks Enterprise PDM database server.
Defining Replication
Defining Replication
1. In the Enterprise PDM Administration tool, expand the tree of a replicated vault.
2. Double-click Replication settings.
The Replication settings dialog box is displayed, listing all archive servers that replicate
the vault archive.
3. To create a new replication schedule, under Replication schemas, click New
Schema.
4. In the New Replication Schema dialog box, for Schema name, type a name for the
new replication schema.
5. Click Add Folder to select the parts of the vault to include in the replication schema.
6. In the Select Folder dialog box, do one of the following:
To replicate all files in the vault, select the top vault name.
All files, including subfolders, are scheduled for replication.
Ensure that you have sufficient storage space on each archive server in the schema
to host the full replicated archive.
24
Scheduled Replication
If the vault you are replicating contains many existing files, the initial replication
process might take a while since all archives are replicated to the defined archive
servers.
To replicate only parts of the vault (for example, a specific folder), select that
folder in the tree.
All files in that folder and its subfolders are scheduled for replication.
This is recommended with large file vaults where folders with frequently updated
files are replicated on a schedule. For folders that are accessed less often, files
can be replicated on an as-needed basis by using on-demand replication.
Repeat steps 5 and 6 to add other specific folders.
7. To limit the files in the specified folders that should replicate when the schedule is
run, click Advanced and select one or more of the options described in the Advanced
Schema Settings Dialog Box on page 28.
8. Under Connections to replicate, select the servers between which replication should
be scheduled.
File archives are replicated to the Target Server from the Source Server.
You can set the same interval for multiple connections by pressing CTRL while
selecting connections.
9. For Predefined interval, select when replication should run between the source and
target servers.
You can select from several predefined schedules in the list or assign your own specific
schedule by selecting User defined schedule.
10. If you select a user-defined schedule, you must type an Interval string that defines
the times when replication should occur.
The format for the string contains three sections: Minute Hour Weekday
Minute 0 through 59 (0 is on the hour)
Hour 0 through 23 (0 is midnight)
Weekday 1 through 7 (1 is Monday)
The sections can contain a single number (1), a range of numbers (1-7), or a list of
numbers (0,15,30,45). Separate each section with a space. You may use an asterisk
(*) as a wildcard for the entire number range.
Examples of predefined schedule strings:
25
Scheduled Replication
0 6-18 1-5 Run every full hour between 6:00 a.m. and 6:00 p.m., Monday
through Friday
11. Under Connections to replicate, select the other server direction listed and set up
the schedule for when replication should occur.
For example, you might want to balance the network load so that replication between
the main office to the second office runs at midnight, and any new files created on
the archive server in the second office are replicated back to the main office at 1:00
a.m.
Replication is triggered at the times you specify based on the local server time of
the target server. For example, if the target server is located in the United States
and the source server is located in Sweden and you set the schedule to start at
midnight, replication will occur at midnight United States time.
The new replication schema is now listed and will run at the defined intervals.
26
Scheduled Replication
Add Folder Displays the Select Folder dialog box, where you select the parts
of the vault to include in this replication schema.
To schedule all files in the vault for replication, select the top
vault name. Ensure that you have sufficient storage space on
each archive server in the schema to host the full replicated
archive. If the vault being replicated contains many files, the
initial replication process might take a while because all archives
are replicated to the defined archive servers.
To replicate only parts of the vault such as the projects folder,
select that folder in the tree. All files in the folder and its
subfolders are scheduled for replication. Use this method for
large vaults: schedule replication for folders in which files are
often updated and use on-demand replication for less frequently
accessed folders.
Predefined interval Schedule when replication should run between the selected
source and target servers. You can select a predefined schedule
or assign your own schedule by selecting User defined
schedule.
Advanced Displays the Advanced Schema Settings dialog box, where you
limit the files in a folder that are replicated when the schedule
is run.
27
Scheduled Replication
Replicate only the latest Replicates only the most recent version if a file has
version multiple versions that are not yet replicated to a
server.
For example, if versions 5 through 10 are not yet
replicated to server B, enabling this option replicates
only version 10. Without this option enabled, versions
5 thru 10 are replicated when the schedule runs.
Replicate only files with Replicates the file versions that have an Enterprise
revisions PDM revision assigned.
For example, if version 4 has revision A and version
7 has revision B, enabling this option only replicates
versions 4 and 7 when the schedule runs.
Include children when By default, only files stored under the specified folders
replicating set up in the schema are replicated by the schedule.
Any files not under the specified folders are not
replicated automatically.
With this option enabled, the schedule also includes
all referenced files to a file stored under the specified
folder of the schema.
For example, consider a schema that is set to replicate
only files under \Projects folder. The vault contains
an assembly file that references two part files under
the \Library folder. With this option enabled, those
two part files will also be replicated when the schema
is run, even though the \Library folder is not part of
the replication schema.
Only replicate files in the Includes only files that are currently in the specified
following states workflow states.
Select a workflow and state in the drop-down list and
click Add. Any file versions not in the specified state
are not replicated.
28
Scheduled Replication
29
5
Controlling Replication Performance
By default, when file archives are transferred using a scheduled replication, up to 10 files are
transferred at the same time between the source and target servers. If this setting is too high
or too low and causes bandwidth issues, you can change the default setting to a number
between 1 and 64 using a registry value. The setting affects how many files the target server
receives at the same time from each source server.
To set the number of files transferred at the same time between source and target
servers:
30
6
Determining Archive Replication
Status
From the Enterprise PDM Administration tool, you can use the Archive Status feature to:
Open the Archive Status dialog box, which shows totals and percentages of files that have
been replicated.
Create a list of files that have not yet been replicated.
In Windows Explorer, you can select a vault file and view the Version tab to see which server
has a replicated copy of the selected version.
The file vault is replicated: Indicates whether the file vault is replicated.
Total number of files available The number of file versions that exist in the vault.
in this file vault
Number of files not yet The number of file versions that are not yet
replicated to this server replicated to the selected archive server. For
example, the vault may have five versions and the
archive server three versions.
31
Determining Archive Replication Status
Percent of files not yet The percentage of the total number of file versions
replicated to this server not yet replicated.
Existing files
Files that are available to users in the vault.
Deleted files
Files that have been deleted (but not yet purged)
in the vault. The Deleted Files tab under folder
properties still lists the files.
System files
Archives of system files in the vault such as card
images and add-ins.
1. In the Administration tool, right-click Archive Status and click Show Missing Files.
2. When prompted, choose whether to limit the returned data to the first 99 files.
A comma-separated list opens, showing the files and versions that have not been
replicated.
The list includes the following information:
Type of data (usually File)
Name and path of file
Missing version
Latest version
Server the files are missing on
Whether the file has been Deleted
The internal ID of the files
32
7
Enabling Archive Server Login
Selection
This procedure requires access to the SolidWorks Enterprise PDM group policy. Before you
begin, insert the installation DVD, and copy \Support\Policies\PDMWorks Enterprise.adm
to a location on your system.
Typically a client is attached to the local archive server as defined when creating the local
vault view. If a vault is replicated and you want to have an option of which archive server to
connect to, you can enable this using the SolidWorks Enterprise PDM policy. This is useful if
you are using a laptop and working in both replicated locations.
1. In the SolidWorks Enterprise PDM Administration tool, expand Local Settings, right-click
Group Policies, and click Open.
2. In the Group Policy dialog box, under User Configuration, right-click Administrative
Templates, and click Add/Remove Templates.
3. In the Add/Remove Templates dialog box, click Add.
4. In the Policy Templates dialog box, navigate to the location where you copied PDMWorks
Enterprise.adm, select it, and click Open.
5. Click Close.
A new node, SolidWorks Enterprise PDM Settings, is added under Administrative
Templates.
6. Expand SolidWorks Enterprise PDM Settings and click Login Manager.
7. In the Login Manager dialog box, right-click Enable Alternate Servers and click
Properties.
8. In the Enable Alternate Server Properties dialog box, on the Settings tab, select Enabled,
and click OK.
9. Close the Group Policy dialog box.
When you log in, the login dialog box shows an Archive Server list containing the names of
the available archive servers hosting the replicated vault.
If automatic login is in use on the vault, the login dialog does not show. To disable automatic
login:
1. In the SolidWorks Enterprise PDM Administration tool, under Local Settings, right-click
Settings, and click Open.
2. In the Settings dialog box, for Vault, select the replicated vault.
3. Clear all check boxes, and click OK.
33
8
Troubleshooting the Replication
Setup
The three most common reasons that vault replication fails are:
System name lookup failure
By default, in a replicated environment the replicated archive servers contact each other
via the system name. It is very important that the DNS name lookup works 100% of the
time. In a WAN environment, the DNS lookup does not usually work.
Ensure that each server can ping the other servers, including the SQL server system, by
name and IP address. It is recommended that you update the local HOSTS file on each
server with the DNS names and IP addresses of the other servers.
TCP port blocking
The file archive replication process between archive servers uses TCP port 3030. Ensure
that there are no firewalls, routers, switches etc. blocking this port. Port 3030 must be
opened fully between servers and clients.
Enterprise PDM Database server not running
For changes to a replication schedule to take effect and trigger scheduled replication, the
Enterprise PDM Database server service must be running and correctly configured.
If it is not running, you must manually restart the archive server service on each server
after you create or modify a replication schedule.
34
Troubleshooting the Replication Setup
Operating System:
System Name:
IP Address:
Operating System:
System Name:
IP Address:
Operating System:
System Name:
35
Troubleshooting the Replication Setup
IP Address:
36
Troubleshooting the Replication Setup
d) Paste the copied log to a folder and rename it to the server name for easy
identification.
e) Repeat for any additional servers that replicate to the archive server.
You can also view the archive server log files in the event viewer on each server.
1. Run regedit
2. Expand the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\SolidWorks\Applications\PDMWorks Enterprise\
ArchiveServer\
3. Right-click ArchiveServer and click New > DWORD Value.
4. For the DWORD Name, type EventLogLevel.
5. Right-click EventLogLevel and click Modify.
6. In the Edit DWORD Value dialog box:
a) For Value data, type FFFF.
b) For Base, select Hexadecimal.
c) Click OK.
Event logging now shows all events on the archive server.
To return to the normal level of event logging, remove the value of the EventLogLevel
DWORD.
1. On the failing archive server, open the SolidWorks Enterprise PDM Archive Server
dialog box by doing one of the following:
37
Troubleshooting the Replication Setup
On Windows 7 and Windows Server systems prior to Windows Server 2012, click
Start > All Programs > SolidWorks Enterprise PDM > Archive Server
Configuration.
On Windows 8 and Windows Server 2012 or later, on the Apps screen, under
SolidWorks Enterprise PDM, click Archive Server Configuration.
The password field is always shown empty, even if there is a password set.
c) Click OK.
5. Click OK to close the Default Settings dialog box.
6. To check the vault-specific properties, select the vault.
7. In the right pane, right-click the file vault name and click Properties.
8. In the Properties dialog box:
a) On the Login tab, review the SQL login section.
Use default SQL login must be selected for the initial replication to work.
b) If it is not, select it or click Change and provide the SQL user name and password
you specified in step 4.
c) Click OK.
38
Troubleshooting the Replication Setup
If the Telnet command fails, replication might fail. Check the following:
If the window shows Connection closed by foreign host, then the port is likely open,
but will not communicate with you.
It is also possible that the port on a firewall is open but the port on the internal machine
is closed.
If the window shows Connection refused, then the port is likely closed. Check the
firewall settings.
If it hangs forever, the port is likely closed. Check the firewall settings.
39
Troubleshooting the Replication Setup
8. If you configured the setup to use IP-address-only communication (see the installation
guide), verify the name in the archive server registry:
a) Run regedit.
b) In the Registry Editor, expand the following registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\SolidWorks\Applications\PDMWorks
Enterprise\ArchiveServer
c) Right-click ServerName and click Modify.
d) Ensure that the ServerName Value data field contains the correct IP-address:
e) Close the Registry Editor.
Ping on IP Address
1. Open a command prompt window.
2. Type PING IP_address_of_other_archive_server.
3. Verify that the other archive server replies.
4. Type PING IP_address_of_SQL_server.
5. Verify that the SQL Server replies.
If one server does not reply, replication might fail as the current server cannot reach
the other server.
6. Verify the network setup.
40
Troubleshooting the Replication Setup
41
Troubleshooting the Replication Setup
42
Troubleshooting the Replication Setup
You could try updating the Server value in the registry to a valid IP address instead
and retest ODBC using the IP address instead.
That the archive server has current MDAC drivers: version 2.7 or later, which you can
obtain from download.microsoft.com.
That you are supplying the correct SQL user and password authentication.
Most ODBC errors show an error code. Go to support.microsoft.com and search the
Knowledge base for a detailed explanation of the error.
43