Adms 2008 Implementationguide
Adms 2008 Implementationguide
Implementation Guide
Autodesk Trademarks
The following are registered trademarks of Autodesk, Inc., in the USA and other countries: 3DEC (design/logo), 3December, 3December.com,
3D Studio, 3D Studio MAX, 3D Studio VIZ, 3ds Max, ActiveShapes, Actrix, ADI, AEC-X, Alias, Alias (swirl design/logo), Alias|Wavefront (design/logo),
ATC, AUGI, AutoCAD, AutoCAD LT, Autodesk, Autodesk Envision, Autodesk Inventor, Autodesk Map, Autodesk MapGuide, Autodesk Streamline,
Autodesk WalkThrough, Autodesk World, AutoLISP, AutoSketch, Backdraft, Bringing information down to earth, Buzzsaw, CAD Overlay, Can
You Imagine, Character Studio, Cinepak, Cinepak (logo), Civil 3D, Cleaner, Combustion, Create>what’s>Next (design/logo), Design Studio,
Design|Studio (design/logo), Design Your World, Design Your World (design/logo), EditDV, Education by Design, FBX, Filmbox, Gmax, Heidi,
HOOPS, i-drop, IntroDV, Kaydara, Kaydara (design/logo), Lustre, Maya, Mechanical Desktop, ObjectARX, Open Reality, PortfolioWall, Powered
with Autodesk Technology (logo), ProjectPoint, RadioRay, Reactor, Revit, SketchBook, Visual, Visual Construction, Visual Drainage, Visual Hydro,
Visual Landscape, Visual Roads, Visual Survey, Visual Toolbox, Visual Tugboat, Visual LISP, Voice Reality, Volo, WHIP!, and WHIP! (logo).
The following are trademarks of Autodesk, Inc., in the USA and other countries: AutoCAD Learning Assistance, AutoCAD Simulator, AutoCAD
SQL Extension, AutoCAD SQL Interface, AutoSnap, AutoTrack, Built with ObjectARX (logo), Burn, CAiCE, Cinestream, Cleaner Central, ClearScale,
Colour Warper, Content Explorer, Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids, DesignProf, DesignServer,
Design Web Format, DWF, DWFit, DWG Linking, DWG TrueConvert, DWG TrueView, DXF, Extending the Design Team, GDX Driver, Gmax
(logo), Gmax ready (logo), Heads-up Design, HumanIK, Incinerator, jobnet, LocationLogic, MotionBuilder, ObjectDBX, Plasma, PolarSnap,
Productstream, RealDWG, Real-time Roto, Render Queue, StudioTools, Topobase, Toxik, Visual Bridge, Visual Syllabus, and Wiretap.
GOVERNMENT USE
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer
Software-Restricted Rights) and DFAR 227.7202 (Rights in Technical Data and Computer Software), as applicable.Published By: Autodesk, Inc.
111 Mclnnis Parkway San Rafael, CA 94903, USA
1 2 3 4 5 6 7 8 9 10
Contents
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Key Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Understanding Vault Architecture . . . . . . . . . . . . . . . . . . . . .3
Autodesk Data Management Server . . . . . . . . . . . . . . . . . . . .4
Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
File Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Autodesk Vault Clients . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Autodesk Vault Explorer . . . . . . . . . . . . . . . . . . . . . . .6
Autodesk Vault Add-ins for Design Applications . . . . . . . . . .6
Microsoft Office Add-in . . . . . . . . . . . . . . . . . . . . . . .6
Autodesk Data Management Utilities . . . . . . . . . . . . . . . . . . .7
ADMS Console . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Autodesk Server Diagnostic Tool . . . . . . . . . . . . . . . . . . .7
iii
Microsoft Internet Information Services . . . . . . . . . . . . . . 14
System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Server Configurations . . . . . . . . . . . . . . . . . . . . . . . . 14
Maintenance Considerations . . . . . . . . . . . . . . . . . 15
Determining Vault Configurations . . . . . . . . . . . . . . 15
Working with Design Teams . . . . . . . . . . . . . . . . . 16
Working As a Single User . . . . . . . . . . . . . . . . . . . 18
Vault Configurations . . . . . . . . . . . . . . . . . . . . . 18
SQL Server Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . 19
Microsoft Windows XP SP2 Firewall . . . . . . . . . . . . . . . . 20
Advanced Configurations . . . . . . . . . . . . . . . . . . . . . . 21
Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Local or Remote SQL? . . . . . . . . . . . . . . . . . . . . . . . . 22
Server Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Pre-installation Checks . . . . . . . . . . . . . . . . . . . . 23
View Pre-installation Reports . . . . . . . . . . . . . . . . . 23
Repeat Pre-installation Checks . . . . . . . . . . . . . . . . 24
Finish Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Working with Microsoft Windows Vista . . . . . . . . . . . . . . . . . 24
Configure Internet Information Services (IIS) 7.0 . . . . . . . . . 25
User Account Control . . . . . . . . . . . . . . . . . . . . . . . . 25
iv | Contents
Creating Tape Backups . . . . . . . . . . . . . . . . . . . . . . . 43
Restoring Vaults from Back Ups . . . . . . . . . . . . . . . . . . . 44
Managing User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . 45
Adding or Editing User Accounts . . . . . . . . . . . . . . . . . . 45
Assigning Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Granting Vault Access . . . . . . . . . . . . . . . . . . . . . . . . 50
Disabling User Accounts . . . . . . . . . . . . . . . . . . . . . . 50
Managing Vaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Deleting Vaults . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Moving File Stores . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Attaching and Detaching Vaults . . . . . . . . . . . . . . . . . . 52
Purging Vault Data . . . . . . . . . . . . . . . . . . . . . . . . . 53
Re-Indexing the Server . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Adding New Properties . . . . . . . . . . . . . . . . . . . . . . . 55
Removing Unwanted Properties . . . . . . . . . . . . . . . . . . 55
Full Content Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Enabling Full Content Indexing . . . . . . . . . . . . . . . . . . 56
Microsoft Indexing Service . . . . . . . . . . . . . . . . . . . . . 56
Learning and Training . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Learning to Use Autodesk Vault . . . . . . . . . . . . . . . . . . 58
Getting Training . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Training Other Users . . . . . . . . . . . . . . . . . . . . . . . . 59
Contents | v
Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Disk Performance . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Appendix B Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Key Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Server Diagnostics Tool . . . . . . . . . . . . . . . . . . . . . . . . . . 86
View Diagnostic Log Files . . . . . . . . . . . . . . . . . . . . . . 89
Recheck Operating System Environments . . . . . . . . . . . . . 89
Advanced Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . 89
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
vi | Contents
Introduction
1
This document describes the best practices for implementing In this chapter
the Autodesk® Data Management Server. This document covers ■ Key Terms
■ Understanding Vault
the recommended methods for deploying Autodesk Data Architecture
Management Server. Although these are not the only methods ■ Autodesk Data
Management Server
for deploying the software, they are the most robust and easiest
■ Autodesk Vault Clients
to maintain. ■ Autodesk Data
Management Utilities
Use this guide as a starting point. You can always change the
document.
1
Key Terms
Term Definition
Autodesk® Web Server A Web server that can be used when one
computer will host both the Autodesk Data
Management Server and vault client in a
stand alone environment, such as an eval-
uation.
Microsoft® Internet Information Services A Microsoft® Web server necessary for do-
(IIS) ing a full implementation of the Autodesk
Data Management Server.
2 | Chapter 1 Introduction
Term Definition
■ Web server
■ Database server
■ File store
The server contains a single database instance that hosts both vaults and
Content Center libraries.
4 | Chapter 1 Introduction
Web Server
There are two different Web servers supported by the Autodesk Data
Management Server:
The Autodesk Web Server is a light-weight Web server intended for a single-user
environment. The AWS only works for configurations where the entire data
management environment is installed on a single computer, that is, server
and clients with CAD software on the same machine.
The Autodesk Data Management Server is actually a Web application that uses
services to manage the communication between the clients and the server via
Web services. The interaction between the clients and the server is similar to
the way a web browser communicates with a site on the Internet. The Web
services use standard HTTP methods, communicating over the Web server
port 80 by default. Microsoft IIS is required for multiple-user configurations.
Database Server
The database server keeps track of all the relationships between data. It acts
like a library card catalog, containing indexes and pointers of where to find
related information. By default, the Autodesk Data Management Server installs
Microsoft® SQL Server 2005 Express. Microsoft SQL Server 2005 Express can
be upgraded any time after the Autodesk Data Management Server components
have been installed. The SQL server can be upgraded to:
File Store
The file store and the database server work with each other. The database
provides the index information for where files are located and the file store
is the secure location on the server where the files are actually located.
Web Server | 5
Autodesk Vault Clients
A vault client is any stand alone application or integrated add-in that connects
to the Autodesk Data Management Server to access files and perform vault
operations.
An example is the AutoCAD Civil 3D add-in. When data is added to a vault
using the Civil 3D add-in, the complex relationships are preserved between
drawings and between objects such as alignments and surfaces.
6 | Chapter 1 Introduction
Autodesk Data Management Utilities
The Autodesk Data Management Server utilities are used to perform
maintenance, diagnostics, and batch file uploading.
ADMS Console
Autodesk Data Management Server Console (ADMS Console) includes tools
for maintaining users, vaults, and Content Center libraries. Use ADMS Console
to purge out-dated versions from a vault. You can schedule ADMS Console to
create routine back ups of vault data. ADMS Console is also used to maintain
replicated sites in a multi-site configuration.
a successful upgrade.
9
Setup Overview
Before installing, prepare the environment for the Autodesk Data Management
Server and client software.
■ Verify system requirements for the operating system, hardware and other
requirements, and Web services software
■ Determine the vault system configuration best suited for your use
NOTE It is important that you read the System Configuration section if you are
considering multiple vaults.
Installation Requirements
Previous versions of Autodesk Data Management Server installed Microsoft®
SQL Desktop Edition (MSDE) by default. If an existing version of MSDE or the
full SQL server is detected during installation, that SQL server may be used by
Autodesk Data Management Server. If no previous version of a SQL server is
detected or if you are not connecting to an existing remote SQL instance,
Microsoft® SQL Server 2005 Express is installed by default. When using MSDE,
Autodesk Data Management Server supports approximately 10 simultaneous
vault clients. Additional users can be supported using either Microsoft SQL
Server 2005 Express or the full version of Microsoft SQL Server 2005. You must
purchase the full Microsoft SQL Server 2005 software separately from
Microsoft® or a Microsoft reseller. Install Autodesk Data Management Server
with the default version first and then determine the need to upgrade to the
full SQL server.
Visit www.autodesk.com/vault for more information about system requirements,
or the Autodesk® Installation online Help.
NOTE If a database is detected that is not compatible with the new version of
ADMS, the existing database must be removed before the ADMS can be installed.
Hardware Requirements
The following are minimum, recommended, and preferred requirements for
running Autodesk Data Management Server. If possible, meet the preferred
requirements.
Other Requirements
■ Either a CD or DVD drive is required, depending on which media your
software is delivered.
NOTE If IIS is not installed on the computer that will host the server and you
require more than a single-user installation, you must install IIS before you install
Autodesk Data Management Server.
Other Requirements | 13
Microsoft Internet Information Services
Autodesk Data Management Server requires IIS for anything more than a
single-user installation. Before the server is installed, a check is performed to
verify the presence of IIS. If IIS is not detected, it must be installed prior to
installing the server.
NOTE You may need the original Microsoft Windows installation CD to complete
the IIS installation.
System Configuration
Autodesk recommends the server configuration described in this document.
If you believe your system is better suited to a different configuration, we
recommend that you consult with your Autodesk reseller for a professional
installation, and check the Autodesk Knowledge Base for any additional
information regarding the upgrade.
Server Configurations
There are many ways to set up a vault server and its related clients. The most
robust way is to install the Autodesk Data Management Server on a separate
NOTE A single, dedicated server means that other competing business applications
do not interfere with the operation of the Autodesk Data Management Server.
Other applications known to interfere are Microsoft® Exchange, using the computer
as either an Internet or intranet server, and other data management and document
management systems.
Maintenance Considerations
There are many other ways to configure and install Autodesk Data Management
Server; however, the single-server model is the solution recommended by
Autodesk for the following reasons:
Performance
Unless you have a very fast remote server and network, a single server hosting
a local file store results in the best overall performance.
Reliability
More complex deployments are possible; however, the more complex the
deployment, the more potential points of failure there are in your data
managment solution. The best data management deployment is a streamlined,
efficient configuration on which you can rely for dependable data retrieval
and maintenance.
■ A single user
Server Configurations | 15
■ Multiple remote sites sharing data
If you install a system that is too small, it can limit functionality or require
reconfiguration in the future. There are several key factors to help you
determine a scenario:
■ Availability of a network
After you choose the appropriate scenario for your situation, continue by
installing and configuring the software components.
■ Two to three design teams that work independently of one another, and
do not share files across teams.
To set up multiple design teams, use multiple instances of the scenario for a
single design team, or install the Autodesk Data Management Server
components on a server separate from the user workstations. Each team
member has the Autodesk Vault client components installed locally.
Server Configurations | 17
Working As a Single User
A single user working in a non-collaborative or isolated environment can
install and run Autodesk Data Management Server components and Autodesk
Vault client components on the same workstation.
Vault Configurations
Depending upon the requirements of your business, you can configure your
system with a single vault, or multiple vaults. The pros and cons of each are
discussed next.
Multiple Vaults
Autodesk Data Management Server can manage multiple vaults. A vault is a
separate storage repository, similar to having multiple hard drives on a
computer. The following section details benefits and downsides of using more
than one vault.
■ To provide training areas where users can feel free to experiment without
interfering with the main vault. It is possible to create a new vault for each
user for training purposes, deleting the extra vaults when they are finished.
■ To create additional vaults for test purposes, where users can test vault
procedures without affecting the main vault.
NOTE It is important to monitor the size of the SQL database files. If you find your
database approaching 2 GB using MSDE or 4 GB using Microsoft SQL Server 2005
Express, you should consider either purging old file versions from the vault,
removing unwanted properties from the system or plan to upgrade to the full
Microsoft SQL Server 2005. Information about purging old file versions and
removing unwanted properties is available in the ADMS Console Help.
There are two supported methods for upgrading or installing SQL Server for
use with Autodesk Data Management Server:
■ Upgrade from Microsoft SQL Server 2005 Express to full SQL Server 2005.
Both methods can be found in the Advanced Configuration Guide for Autodesk
Data Management Server 2008, accessible on the Autodesk Web site. Both
methods are supported; however, the recommended method is to upgrade
from SQL Server 2005 Express to full SQL Server.
3 In the Windows Firewall dialog box, click the Exceptions tab, and then
click Add Port.
6 Click OK.
Advanced Configurations
For more information about configuring Autodesk Data Management Server,
see the Advanced Configuration Guide for Autodesk Data Management Server 2008
available in the online knowledge base at www.autodesk.com. The Advanced
Configuration Guide for Autodesk Data Management Server 2008 covers advanced
topics such as:
Server Installation
1 Insert the Autodesk installation media into the computer that will host
the Autodesk Data Management Server and then follow the steps to begin
the guided installation process.
Advanced Configurations | 21
3 On the Review-Configure-Install page:
■ Click Install to install the Autodesk Data Management Server with
the default file locations and settings, or
6 Specify the location for the ADMS Console application and then click
Next.
Pre-installation Checks
Pre-installation checks run automatically to verify the requirements of the
host computer to which the server is being installed.
NOTE ADMS is not installed until all failed test conditions are corrected. If any of
the tests fail, you can continue installing other products, but ADMS will not be
installed.
The results are displayed by the installation wizard indicating which conditions
have passed, generated a warning, or failed. A text report, PreChecks.xml, is
written to your current TEMP directory. Typically, this is: C:\Documents and
Settings\[user]\Local Settings\Temp\EDMLog\Server. Should it be necessary to
seek assistance, the report can be forwarded to your IT staff or to Autodesk.
Server Checks | 23
Repeat Pre-installation Checks
If the pre-installation report indicates one or more warnings or failures
requiring corrective action, perform those actions and then run the
pre-installation checks again.
In the Autodesk Data Management setup, click Re-check. The conditions are
checked again and the report window is updated to reflect the new results. If
all of the checks pass or there are any warnings that can be ignored, click Next.
If any of the checks fail, make the necessary corrections and then click
Re-check.
Finish Installation
You are prompted to view the Readme file, view additional documentation,
and to launch ADMS Console. Make your selections, and then click Finish.
NOTE If you are upgrading from a previous version of Autodesk Data Management
Server, the existing database is migrated when you first launch ADMS Console. It
is recommended that you start ADMS Console before you proceed.
NOTE The following instructions are for Microsoft Windows Vista only.
3 From the Programs and Features group, select Turn Windows features on
or off.
6 Turn on the check box for IIS Metabase and IIS 6 configuration
compatibility.
8 Turn on the check box for ASP.NET. Three other settings are automatically
turned on: .NET Extensibility, ISAPI Extensions, and ISAPI Filters.
9 Click OK.
NOTE The following settings affect the entire computer. All applications will run
without prompting for administrator approval.
2 In the Run dialog box, enter secpol.msc and then click OK.
3 You are prompted to allow the security policy application to run. Click
Continue.
5 Locate the policy User Account Control: Behavior of the elevation prompt
for administrators. Right-click the policy and then select Properties.
6 In the Properties dialog box, select Elevate without prompting and then
click OK.
7 Locate the policy User Account Control: Run all administrators in Admin
Approval Mode. Right-click the policy and then select Properties.
8 In the Properties dialog box, select Disable and then click OK.
27
Requirements
In this section, hardware and software requirements are listed in the form of
checklists with which you can catalog your current system configuration.
Additionally, a question and answer form is provided to help you assess your
business requirements.
Hardware
The Autodesk® data management products have a server component and can
support many client computers. Determine if the current computers meet the
system requirements for the new release.
Understand the distinction between minimum, recommended, and preferred
configurations. Minimum system requirements are suitable for testing or
evaluation. Strongly consider using hardware that meets the recommended
or preferred requirements for the planned system if you are supporting multiple
users or using the system in production work.
CPU
Memory
Software
If you are planning on using the new version of Autodesk® Vault with a
previous release of a CAD tool, then ensure that your client software is
supported. In general, the data management products support the current
CAD release and the previous CAD release. Check www.autodesk.com to make
sure that your specific CAD tools are supported.
AutoCAD®
Business Requirements
One of the most important factors in determining how you want to approach
upgrading your data management system is to understand the needs of your
organization.
Question Answer
Business Requirements | 29
Testing
After assessing the hardware and software, determine whether you need a test
environment. If you have any unanswered questions, or determine that the
data management system is critical to your business, consider setting up a test
environment before upgrading to the next release of Autodesk Vault.
Test Environment
If possible, perform a test upgrade of the data management server on a machine
that is similar to the one that is currently hosting the software. A test upgrade
provides confidence that the backup is valid and helps you identify any
potential pitfalls without impacting your production environment. It also
helps you to determine compatibility with other applications and environment
settings that your company uses.
Similar CPU, memory, disk space Provides an estimate of how long the mi-
gration might take. Gives insight in to any
migration settings such as time-out values
that need to be changed. Shows other
configuration settings that may require
changes.
Other applications that are installed on the Test for compatibility with various proxy
production server clients, firewalls, anti-virus programs, etc.
Migration
ADMS Console can migrate a vault from release 4 or 5 to work with Autodesk
Data Management Server 2008. If you currently have a vault database earlier
than release 4, migrate it first to release 4 and then use ADMS Console to
migrate it to work with Autodesk Data Management Server 2008.
Uninstall Components
Before uninstalling any components, back up existing vault data. Restore the
backed up data on a test environment to verify that it can be successfully
restored before proceeding.
NOTE Depending on your configuration, you may not find some of the
components listed below. If they do not appear in the Windows Add or Remove
Programs utility, skip the item.
■ Autodesk Vault 5 or earlier (if the server and clients are on the same
computer)
■ Autodesk Office Add-in (if the server and clients are on the same computer)
Migration | 31
NOTE Do NOT uninstall the SQL instance AUTODESKVAULT.
NOTE Vaults from Autodesk Data Management Server versions 1.0 and 1.3 cannot
be migrated. A vault from Autodesk Data Management Server version 3 must be
migrated to either version 4 or 5 before being migrated to version 6 or higher.
An Autodesk Productstream vault cannot be migrated for use with Autodesk Vault.
2 The unmigrated vault is indicated with a yellow warning sign. Select the
non-migrated vault.
33
Data Management Client Requirements
Autodesk Data Management clients that integrate with an Autodesk design
application require a licensed installation of the corresponding Autodesk®
application. Refer to the hardware and software requirements for each product.
The clients work in conjunction with the Autodesk Data Management Server.
The Autodesk Data Management Server must be installed and configured
before the clients can access the server.
NOTE The data management clients are not compatible with previous versions
of Autodesk Data Management Server. If you are upgrading to Autodesk Vault
2008, all server and client components must be upgraded.
Operating Systems
Recommended Hardware
NOTE Although the Autodesk Data Management clients can be installed on the
same computer with Autodesk Data Management Server, it is recommended to
install Autodesk Data Management Server on a dedicated computer.
Client Installation
The Autodesk Data Management clients are available on the product
installation media as well as on the Autodesk Vault 2008 media.
If the Autodesk Vault Add-in for Microsoft® Office was shipped with your
software and one or more of the following Microsoft products is installed and
registered on your machine, it will be automatically installed. Microsoft Office
2007 applications are not supported.
■ Excel® 2000/XP/2003
■ PowerPoint® 2000/XP/2003
NOTE To install the Autodesk Vault clients, you must have either Microsoft
Windows administrator privileges or power user privileges.
■ Insert the Autodesk design application’s installation media and follow the
instructions for the installation wizard.
■ Insert the application’s installation media and follow the instructions for
installing the software.
Client Installation | 35
Installing clients from the Autodesk Vault 2008 CD
2 Double-click setup.exe.
Add-in Integration
If a design application is already on the computer before the clients are
installed, the corresponding add-in clients automatically integrate with the
design applications when they are installed. However, if an application is
installed after the data management clients, go to the Control panel and
modify the data management application to install the missing add-in.
First Log In
When Autodesk Data Management Server is installed, a vault and a user
account are created. The name of the vault is “Vault”. The account name is
“administrator”. No password is assigned to the account and the name is not
case sensitive. The administrator account has full administrator privileges.
NOTE If a user account has already been created for you, log in using your user
name and password.
3 A default user ID, vault server, and database are set up for you to get
started using the vault right away. If a user account has already been
created for you, use your own account information. If a user account has
not been created for you, or the default values are not present, contact
your vault administrator.
4 Use either the default values or, if an account has been created for you,
use your own account information. The default values are:
6 Click OK.
8 NOTE You have the option to save the account information to automatically
log into the vault the next time.
First Log In | 37
38
Managing Autodesk Data
Management Server 5
This chapter contains the procedures for Autodesk®Data In this chapter
Management Server administration and management. ■ About ADMS Console
■ Performing Vault
Maintenance
■ Backing Up Vault Data
■ Managing User Accounts
■ Managing Vaults
■ Re-Indexing the Server
■ Full Content Indexing
■ Learning and Training
39
About ADMS Console
A vault consists of three primary components:
■ Vault database
■ File store
NOTE Never directly move, delete, or edit a file in the file store.
All database and file store maintenance should be performed using ADMS
Console. ADMS Console is the administrator’s interface for maintaining the
vault file stores and databases. Tasks include backing up and restoring data,
creating new vaults, and purging old data. The administration utilities in
ADMS Console are also available from the command line. You can use the
command line in conjunction with scripts to create custom schedules and
automated maintenance tasks.
NOTE A database consists of an .mdf file and an .ldf file. These two files must be
kept together for a vault to work correctly.
You must log into ADMS Console with a vault account that has been assigned
the Administrator role. In order to perform most vault maintenance, you must
also have SQL administrator privileges. For more information about vault
maintenance, command line options, and SQL administrator privileges, see
the ADMS Console Help.
2 In the Log In dialog box, enter the user name and password for the vault
administrator account.
3 Click OK.
■ Using the Windows Task Scheduler - this process uses the backup tools
included with ADMS Console as part of a standard Windows batch file.
■ Including the backup as part of a tape backup set - this process uses a tape
back up system to back up the vault directly or to use a method similar to
the Windows Task Scheduler.
The preferred and most reliable method for backing up a vault is to integrate
the ADMS Console backup tools into your tape backup plan.
With the ADMS Console command line options, you can create a script to
automate the backup process. The following script is intended for a default
Autodesk Data Management Server installation. Edit the backup paths and
installation paths as needed.
NOTE The following script is for performing full back ups ONLY. For more
command line options or to create a script for performing incremental back ups,
see the ADMS Console Help.
NOTE Autodesk does not recommend using backup software to back up the SQL
database and file store directly. This method increases the difficulty of migrating
to a new release of Autodesk Data Management Server or restoring a vault on a
new machine. In addition, never back up the SQL Server using the "live" backup
plug-ins that are available for major tape backup systems. You must ensure the
file store and SQL data are perfectly in sync with each other. Failure to do so may
render your data unusable.
1 Run the following script before your tape backup job starts:
@ECHO OFF
REM THIS WILL STOP THE WEB SERVER AND "CYCLE" THE SQL
SERVERREM PROVIDING THE BEST RESULTS FOR BACKING UP THE
VAULT
IISRESET /STOP
NET STOP MSSQL$AUTODESKVAULT
NET START MSSQL$AUTODESKVAULT
REM START THE BACKUP PROCESS (THIS IS ONE LINE OF TEXT)
“C:\Program Files\Autodesk\Data Management Server 2008\ADMS
Console\Connectivity.ADMSConsole.exe" -Obackup -B"C:\Backup\Vault\A"
-VUadministrator -VP
2 Run the following script after your tape backup job completes:
@ECHO OFF
REM DELETE THE BACKUP SET AFTER THE TAPE SET COMPLETES
RMDIR /Q/S C:\Backup\Vault\A"
REM START THE WEB SERVER
IISRESET /START
3 Restoring a vault deletes the current data sets and file store. This action
cannot be undone. You are prompted for confirmation before proceeding.
Click Yes.
5 In the Restore from directory field, specify the location of the backed up
data. To browse for a location, click ... and locate a directory using the
file browser.
8 Click OK.
NOTE Back up files created from the Autodesk Data Management Server installed
with using Autodesk® Productstream® cannot be restored to an Autodesk Data
Management Server installed with Autodesk Vault.
■ Last name
■ User name
■ Email address
6 Click Roles and assign one or more roles to the account. Roles determine
the level of access to the vault.
7 Click Vaults and select one or more vaults for the account to access.
8 Select the Enable User check box. Until the account is enabled, it is not
available for use and cannot access the vault
Repeat this process for each new user account needed. Each new user is granted
access to the selected vaults on the server.
2 In the User Profile dialog box, edit the information for the current user.
6 Click OK.
NOTE Each user logs into the vault with a unique user name and password. Restrict
access to the administrator account to only the assigned vault administrator.
Assigning Roles
Assign a role to a user account
3 To assign roles to a user for the first time, click New User.
4 In the New User dialog box, select one or more roles, and then click OK.
5 In the Add Roles dialog box, select one or more roles, and then click OK.
NOTE For users of AutoCAD Civil 3D, do not select the roles Content Center
Administrator, Content Center Editor, or Content Center Reviewer.
8 In the Add Roles dialog box, select or cancel the selection of one or more
roles.
9 Select the Enabled check box. Until the account is enabled, it is not
available for use and cannot access the vault.
10 Click OK.
More than one role can be assigned to a user account. The permissions are a
union of the assigned roles.
Assigning Roles | 49
Granting Vault Access
Grant user access to a vault
3 To grant a user access to one or more vaults for the first time, click New
User.
5 In the Add Vaults dialog box, select one or more vaults, and then click
OK.
8 In the Add Vaults dialog box, select or cancel the selection of one or more
vaults.
4 In the User Profile dialog box, clear the check box of the Enable User.
5 Click OK.
Managing Vaults
A vault is created automatically when Autodesk Data Management Server is
installed. Typically, use a single vault for holding all of the design data for a
■ test purposes so users can become familiar with vault procedures without
affecting the main vault
■ contractors may want to use multiple vaults to isolate data from completely
independent clients who each have separate libraries and shared content
Create a vault
3 Enter a name for the new vault. The name cannot contain certain special
characters.
4 The file store can be located in a default location, or a new location can
be specified. Click OK to create the new vault with the default file store
location or click Select File Store Location to specify a new location and
then click OK.
NOTE The default path for the file store is C:\Documents and Settings\All
Users\Application Data\Autodesk\VaultServer\FileStore.
Deleting Vaults
Vaults that are no longer in use can be deleted. Before deleting any vault, back
up the data.
Deleting Vaults | 51
Moving File Stores
While it is recommended to keep all of the Autodesk Data Management Server
components on a single machine, the file store can be moved from its existing
location to another location. To move a file store to a location on a remote
machine, see “Managing a Remote File Store” in the Advanced Configuration
Guide available in the appendix of this document, or on the online Vault
Knowledge Base.
■ Vault.mdf
■ Vault_log.ldf
After the vault is detached, you can move the two corresponding files. The
.mdf and .ldf files must be kept together. Attaching a vault reconnects the set
of vault files that were moved to the database engine.
NOTE After re-attaching the database, the Autodesk Data Management Server
user accounts must be edited to have access to the re-attached vault. To avoid
editing the user accounts, back up the database and restore it to a new location.
Detach a vault
1 Ensure that no users are accessing the vault and then stop the Web service.
1 Ensure that no users are accessing the vault and then stop the Web service.
NOTE You must detach all other databases before detaching the master vault.
Attach a vault
3 In the Attach Vault dialog box, enter the name of the data file (.mdf) or
click the browse button to locate the file.
4 Enter the name of the log file (.ldf) or click the browse button to locate
the transaction log file.
5 Enter the name of the file store or click the browse button to locate the
file store.
7 Click OK.
For more information on detaching and attaching vaults, see the Autodesk
Vault Help or visit the Autodesk Web site, www.autodesk.com, and search for
support document TS81609.
■ The latest version cannot be purged. To remove a file and all of its versions
from a vault, use Delete.
4 In the Vault Version Purge dialog box, turn on the check box next to
each of the selection rules to determine the data to be purged:
Versions except Specify how many file versions to leave in the vault.
latest
Versions older than Specify how old the files to purge should be.
days
Exclude versions Enter a text string contained within the Comments
where comment field of the files in the vault. Any files containing
contains: this string will be excluded from the purge process.
5 Click OK.
■ Add new properties to the vault that were previously unknown to the
system.
■ Remove unwanted properties from the vault that are no longer needed,
in turn saving space in the SQL Sever database.
■ AutoCAD®.dwg
■ Autodesk®Inventor™
■ 3D Studio Max
■ Microsoft® Office
NOTE Some iFilters create actual properties that are searchable and can be
displayed as columns in the vault. Others only index file contents which are
searchable, but cannot be displayed as a column. For more information on
searching file contents, see the next section Full Content Indexing (page 56).
3 In the Content Indexing Service dialog box, select Yes, enable Content
Indexing Service.
4 You are prompted to stop the Web service for this operation. Click Yes.
When you enable the full content indexing for a vault, a new catalog is created
in the Index Server prefixed with ADSK. This is the repository for indexed
contents.
The Microsoft Indexing Service is implemented as a shared server, There is no
degraded performance with check-in times nor will the database size increase.
However, a full content search will take slightly longer to return results when
compared to a more simple property based search.
NOTE ADMS Console manages the Indexing Service under normal operation.
As a first step to learning to use Autodesk Vault, refer to the tutorials that are
included in with the Autodesk Vault Help. There is a tutorial for each of the
design application add-ins. These tutorials are accessible from the respective
Help menus in the design application.
More online information about Autodesk Data Management Server and client
applications:
Getting Training
Be more productive with Autodesk software. Get trained at an Autodesk
Authorized Training Center (ATC) with hands-on, instructor-led classes to
help you get the most from your Autodesk products. Enhance your productivity
with proven training from over 1,400 ATC sites in more than 75 countries.
For more information about Autodesk Authorized Training Centers, contact
[email protected] or visit the online ATC locator at
www.autodesk.com/atc.
Getting Training | 59
60
Setting Up a Multiple
Site Environment 6
Multiple remote sites can be configured to access the same In this chapter
vault data. A site is comprised of a dedicated Autodesk Data ■ About Multiple Sites
■ Install Autodesk Data
Management Server and a file store. Each site accesses a shared
Management Server on the
First Site
AUTODESKVAULT SQL instance.
■ Configure Microsoft SQL
Server 2005 for Remote
Access
■ Create a Shared Network
Folder
■ Install Autodesk
Productstream Replicator
2008
■ Install Autodesk Data
Management Server on
Additional Sites
■ Managing Sites
61
About Multiple Sites
Setting up a multi-site environment requires:
■ Installing Autodesk Data Management Server on the initial site and running
Autodesk Productstream Replicator 2008
NOTE The remote SQL database configuration is for use in a multiple site
environment. Autodesk Productstream Replicator 2008 requires using a remote
SQL instance. Configuring ADMS to use remote SQL is done using Autodesk
Productstream Replicator 2008.
3 From the Select the Products to Install page, select Autodesk Data
Management Server 2008 and then click Next.
NOTE You can install the data management clients on the server as well, but
it is not a requirement.
5 On the User and Product Information page, provide your first name, last
name, and the name of your organization and then click Next.
8 Click Browse to select the installation location for Microsoft SQL Server.
NOTE The disk space requirements are displayed below the selected
installation folders.
11 The default location for the file store is C:\Documents and Settings\All
Users\Application Data\Autodesk.
NOTE The default location for the file store in Microsoft Windows Vista is
C:\ProgramData\Autodesk.
13 Click Install.
2 In the SQL Server Configuration Manager dialog box, expand SQL Server
2005 Network Configuration and then select Protocols for
AUTODESKVAULT.
6 In the SQL Server Surface Area Configuration dialog box, select Surface
Area Configuration for Services and Connections.
8 Click OK.
15 In the SQL Server Browser Properties (Local Computer) dialog box, change
the startup type to be Automatic and then click OK.
2 Right-click on the new folder and then select Sharing and Security.
6 Click Permissions.
7 In the Permissions dialog box, click Add. Add the user account under
which ADMS is running. By default, this is a local administrator account
on the ADMS server called Autodesk®Vault.
8 Add the Windows account under which the SQL Server service is running.
4 Click Next.
6 On the Accept the License Agreement page, click I Accept and then click
Next.
NOTE Before other sites can be added, at least one vault must be enabled
on the first site. If you installed Autodesk Productstream Replicator on.
NOTE If the Autodesk Data Management Server installed on the first site is
the ADMS installed with Autodesk Vault, the subsequent sites must also use
the ADMS installed with Autodesk Vault.
3 From the Select the Products to Install page, select Autodesk Data
Management Server 2008 and then click Next.
NOTE You can install the data management clients on the server as well, but
it is not a requirement.
NOTE Do not include \\ in front of the server name. A SQL instance named
'AUTODESKVAULT' must exist at the specified location.
NOTE Both the user account under which the Autodesk Data Management
Server is running as well as the user account under which the SQL instance
is operating need full control access to the shared network folder.
10 Click Install.
NOTE Once the server is installed, follow the instructions in Install Autodesk
Productstream Replicator 2008. Repeat this process for each additional site.
Managing Sites
Sites are managed and maintained using ADMS Console. For more information
and additional site management features, see ADMS Console Help.
■ Server Name
■ Description
■ Vault Name
■ Replication Type
■ Last Replication
■ Next Replication
■ Site Status
2 Right-click on the Description field for the site and then select Edit
Description.
3 In the Description dialog box, enter a new description for the site and
then click OK.
Replicate Data
Replicating data at a site compares the local file store to the file store at each
other site and retrieves any missing files from the other sites. Once replicated,
a fie and its history are available at the replicated site. Individual vaults can
be replicated, or all of the enabled vaults on a site can be replicated. Replication
can also be scheduled.
NOTE The Replication command synchronizes data only at the site at which it is
initiated. Each site is responsible for its own replication.
■ Frequency – Specify a start time and then select how often the
replication is performed.
■ Click OK.
71
Key Terms
Term Definition
Performance Tuning Monitoring and analyzing the performance of a system and adjusting its config-
uration to obtain optimum performance.
Operating System The software that the rest of the software depends on to make the computer
functional. On most PCs this is Windows or the Macintosh OS.
Disk Defragmentation A utility included with the Windows operating system that coalesces files on
the hard drive, freeing up disk space.
Anti-virus Program A program that searches for viruses and removes any virus that it finds.
Proxy Server Existing between a client Web browser and a real server, a computer that caches
common and often requested Web pages and holds them for easier access by
users.
Customize View A command in Vault Explorer to customize the information shown in the display
grid.
Server Memory
In order to determine whether the server has enough available memory, some
key factors must be considered: the size of your data and the number of users
concurrently accessing the Vault Server. If Productstream is being used, the
number of users concurrently accessing the Item Master should be considered
as well.
Operating System | 73
74 | Appendix A Performance Tuning
If the Commit Charge Total regularly exceeds the total amount of physical
memory, it is likely that many of the programs and processes on the server
are using the disk-based swap file excessively. Using the swap file is much
slower than using physical memory. Windows uses the swap file for many
tasks, so a small amount of swap file usage will not cause any problems.
Server Memory | 75
Initial memory usage by Autodesk Data Management Server.
In general, SQL Server memory will grow over time. This is because the database
server is using memory as fast cache buffers for frequently used queries. As
other programs request memory on the server, SQL Server releases memory
as needed. Similarly, the IIS Worker Process (w3wp.exe in Windows 2003 server)
reserves memory for caching as well. When the system starts running low on
physical memory, the operating system reclaims some of this memory. In
general, unless you have a large site with many users or large models, this will
not need to be changed.
Disk Performance
Using multiple disks will generally enhance system performance. There are
many types of disk technologies available, such as the Redundant Array of
Inexpensive Disks (RAID). Choosing which type of disk technologies depends
on the number of users, vault size, frequency of updates, and so on.
Disk Performance | 77
Disk fragmentation can also greatly affect Autodesk Data Management Server
performance. Most Windows editions provide a disk tool that measures how
the files on your computer are stored on disk.
Disk Performance | 79
Aggressive Anti-virus Programs
Some types of Anti-virus programs scan data coming from the network and
data being written to the file store. If your anti-virus software appears to be
engaged for too long on vault operations, such as uploads, adjusting the
scanner settings may help.
There is, of course, a trade-off between security and performance. Because of
this, performing some test cases and benchmarks on your own data and server
is recommended.
CPU
Faster or multiple CPUs can improve vault performance, but this is typically
a more expensive option than the others and should mainly be considered
after the other areas have been reviewed.
Network Configuration
Autodesk Data Management Server generally performs better when clients are
directly connected to them. Certain types of web setups which use proxy
servers or other similar Internet setups are usually of limited value in intranet
setups. Bypassing the proxy server for addresses inside your corporate network
is therefore recommended.
3 In the Local Area Network (LAN) Settings dialog box, if the option Use a
proxy server for your LAN is selected, it means a proxy server is located
in your environment. Consider enabling the Bypass proxy server for local
addresses by clicking this option.
You can also explicitly enter your server's Internet Protocol (IP) address
in the bypass column.
1 In the Local Area Network (LAN) Settings dialog box, if a proxy server is
specified in the Proxy server section. Click the Advanced button.
2 In the Proxy Settings dialog box enter your vault server address in the
Exceptions field.
Client Settings
Certain settings within the client application can affect performance not only
in the client, but in the Vault add-ins as well.
Memory
Add-ins for design applications will consume additional memory. They amount
of memory they consume is typically small. But, in certain circumstances, it
makes sense to review the memory usage on the client. The most common
Client Settings | 83
problems occur when the original client CAD model uses the majority of the
computer's available memory before introducing a vault into the workflow.
Please refer to the "Server Memory" section for additional instructions on how
to review the memory usage on your systems.
Disk Performance
Like the server, client computers can suffer from disk fragmentation as well.
The concept of analyzing disk fragmentation is the same for both clients and
servers.
85
Key Terms
Key Terms Definition
Autodesk Data Management Server Dia- A program that can performs a series of
gnostic Tool checks to identify possible Autodesk Data
Management Server problems and gather
system information to help diagnose the
problem.
86 | Appendix B Troubleshooting
2 In the Diagnostics Tool Setup dialog box, click Run Checks.
When Checking, all the results of the diagnostic tests will be displayed
in a list indicating which of the checks have passed successfully, have
generated a warning, or have failed.
■ If any of the checks fail, click the link displayed under the Action
Required list to learn more about the error.
3 When the diagnostics are complete, click Close and then click Open Log
Files to open the directory containing the log files.
■ In the Review Your Results list, click the error information under the Action
Required list. It is linked to the corresponding pages of Autodesk Data
Management Server Installation help.
88 | Appendix B Troubleshooting
View Diagnostic Log Files
The diagnostic log file lists the name of each condition that is checked along
with its information and test results. This includes the version of the operating
system, the IIS information, the firewall and any other related configuration
information. Other log files are also created during the installation. The log
files are stored in the EDMLog folder located in C:\Documents
andSettings\Administrator\Local Settings\Temp
■ In the Diagnostics Tool dialog box, click Open Log File. The EDMLog
directory containing all of the log files is opened. Select a log file to open.
■ Once you run the diagnostic checks, click View Log File to display the
diagnostic log file.
Should it be necessary to seek assistance, you can forward log files to your IT
personnel or to Autodesk Technical Support.
Advanced Troubleshooting
Additional troubleshooting resources for the Autodesk Data Management
System can be found online. They include a searchable Knowledge Base
available on the Autodesk support page. You can access the Autodesk
Knowledge Base online at www.autodesk.com.
I W
integrating add-ins 36 Web services 3
R
requirements for clients 34
91 | Index
92