Concept
- The network configuration is designed to allow the project administrator to use both company standards resources and project specific resources.
- The network configuration is independent from a local MicroStation install that can be updated without interference with active projects.
- Each user is identified by his or her Windows login name.
- The setup is controlled by three configuration files, atflocal.cfg, tflocal.cfg and startup.cfg, as follows:
- A shortcut on each user's desktop points to the server's atflocal.cfg.
- Atflocal.cfg points to tflocal.cfg.
- Tflocal.cfg points to startup.cfg.
- Startup.cfg points to individual user.ucf's and to individual project.pcf's.
Typical Files Organization
Files are usually organized in two main directories on the same or on different drives:
- Standards folder is used for configuration files and company datasets (CAD Standards).
- Projects folder is used to store project specific datasets and project data.
An Example of the Project Directories on the Server
Let's first take a look at the server directories. At the root level they should look something like this:
*.cfg files:
All the *.cfg files are placed under the config directory:
*.ucf Files:
All User *.ucf files are saved under standards/config/users (individual folders for each user).
You will need to create the user files with names matching the participants' log-in names (windows login) (YourFirm_UserA in the example below).
When started, Bentley Architecture will automatically create the user *.upf and copy the needed resource files in the appropriate folder.
*.pcf Files:
You will need to create a *.pcf file for each active project under Projects/Examples/
Procedures
- Creating a Shortcut:
First, create a new Architecture desktop shortcut by copying the delivered one and renaming it (Example: YourFirm Architecture).
- Edit the shortcut properties by right clicking on it and modify the Target argument as shown below, where the -wc* (* represents your shared drive letter and workspace) (-wc represents workspace change) and add the custom name of the atflocal.cfg after config\
Note: Do not place " \ " at the end of the string.
- Editing the atflocal cfg file:
After copying the delivered atflocal.cfg to your shared server folder, the only modification needed is that which is in bold below:
The purpose of this file is to start up Bentley Architecture and to include the TriForma configurations.
#=========================================
#YourFirm_atflocal.cfg - Bentley Architecture Local Configuration File
#==========================================
# Copyright 2002, Bentley Systems, Inc.
#
# Limited permission is hereby granted to reproduce and modify this
# copyrighted material provided that the resulting code is used only in
# conjunction with Bentley Systems products under the terms of the
# license agreement provided therein, and that this notice is retained
# in its entirety in any such reproduction or modification.
#
#----------------------------------------------------------------------
#
_USTN_ECAPPL = $(_USTN_TFROOT)program/triforma/Architecture/config/appl/
#----------------------------------------------------------------------
# The following lines are added during installation. TF_DATASETNAME
# is based on user selection of reference dataset(s).
#----------------------------------------------------------------------
TF_DATASETNAME : atf_imperial
#_USTN_PROJECTNAME = YourFirm_Project1
%include yourfirm_tflocal.cfg
- Editing the tflocal.cfg:
The following adjustments are needed after copying the delivered tflocal.cfg to the server:
- The project configuration file name.
- Include the server startup configuration file.
#===================================
===============
#YourFirm_tflocal.cfg - TriForma Local Configuration File
#===============================================
# Copyright 2001, Bentley Systems, Inc.
#
# Limited permission is hereby granted to reproduce and modify this
# copyrighted material provided that the resulting code is used only in
# conjunction with Bentley Systems products under the terms of the
# license agreement provided therein, and that this notice is retained
# in its entirety in any such reproduction or modification.
#
#----------------------------------------------------------------------
_USTN_TFROOT =$(_USTN_BENTLEYROOT)
#----------------------------------------------------------------------
# Define location of MS Engineering Configuration config files; note
# that these config files are not actually included until msconfig.cfg.
# Set with the : operator here so TF-based apps can overwrite.
#----------------------------------------------------------------------
_USTN_ECAPPL:$(_USTN_TFROOT)Program/triforma/config/appl/
#----------------------------------------------------------------------
# Below lines are added during installation, and record the locations where
# MicroStation and TriForma are installed.
# TF_DATASETNAME is written at install based on user choice of reference
# dataset(s) to install.
#----------------------------------------------------------------------
_USTN_USERNAME=YourFirm_UserA
TF_DATASETNAME: tf_imperial
_USTN_PROJECT = $(_USTN_PROJECTSROOT)examples/
_USTN_PROJECTNAME:YourFirm_Project1
#Include Firm Startup Config
%include YourFirm_startup.cfg
#----------------------------------------------------------------------
#
MSDIR=D:/MS8000732/Program/MicroStation/
%include $(MSDIR)config/msconfig.cfg
#----------------------------------------------------------------------
- Creating the startup.cfg file:
Specify the drive location for workspace and projects as indicated below. In a different scenario, standards and projects could be on separate drives.
#===================================
# YourFirm_startup.cfg
#===========================================
# Config variables that drive the firm's location for projects,
# workspace files, etc.
#----------------------------------------------------------------------
_USTN_SYSTEMROOT = $(_USTN_BENTLEYROOT)workspace/system/
%lock _USTN_SYSTEMROOT
_USTN_WORKSPACEROOT = H:/Server/
%lock _USTN_WORKSPACEROOT
_USTN_PROJECTSROOT = H:/Server/Projects/Examples/
%lock _USTN_PROJECTSROOT
_USTN_SITE = $(_USTN_WORKSPACEROOT)/
%lock _USTN_SITE
_USTN_PROJECTDATA = $(_USTN_PROJECTSROOT)$(_USTN_PROJECTNAME)/
%lock _USTN_PROJECTDATA
#_USTN_LICENSING = $(_USTN_WORKSPACEROOT)config/licensing/
#%lock _USTN_LICENSING
#----------------------------------------------------------------------
# Config variables that drive the options in MicroStation Manager
#----------------------------------------------------------------------
_USTN_USER = $(_USTN_WORKSPACEROOT)Standards/users/
%lock _USTN_USER
_USTN_PROJECT = $(_USTN_WORKSPACEROOT)projects/examples/
%lock _USTN_PROJECT
_USTN_USERINT = $(_USTN_WORKSPACEROOT)Standards/interfaces/microstation/
%lock _USTN_USERINT
The variable in bold below will recognize the Windows log-in name as your user name and will allow any authorized users to work from any workstation.
#----------------------------------------------------------------------
# Set location for application preferences if not set elsewhere.
# Note: you may wish to set this at the site level.
#----------------------------------------------------------------------
# Set default user = Windows logon name, if exists
_USTN_USERNAME = $(USERNAME)
# Allows system administrator to override Windows logon by setting a system environment
# variable.
# This is useful also when you have 1 person using multiple machines, and you want them to
# have different *.ucf files for each session.
# Note: If using this method, you need to reboot after setting the system
# environment variable.
%if defined (MS_USERNAME)
_USTN_USERNAME = $(MS_USERNAME)
%endif
#----------------------------------------------------------------------
# Allows system administrator to override Windows logon by setting up a #local user config.
# NOTE: If using this method, you should do this at the site level.
# %if exists ($(USTN_BENTLEYROOT)home/prefs/SetUser.cfg)
# %include $(USTN_BENTLEYROOT)home/prefs/SetUser.cfg
# %endif
# Set user preferences (tfprefs.rsc, *upf, etc.)to folder unique to the user.
_USTN_HOMEPREFS = $(_USTN_USER)$(_USTN_USERNAME)/
- Editing the project.pcf file:
Start by copying the Architecture4TF.pcf file and editing it to specify the project description and the TriForma default dataset name as shown below. You could also modify the general search paths if needed to point to project specific data, such as, dgn.libs, etc.
#----------------------------------------------------------------------
#
# Current Revision:
# $RCSfile: YourFirm_Project1,v $
# $Revision: 1.13 $
# $Date: 2002/10/28 18:58:56 $
#
# Copyright 2002, Bentley Systems, Inc.
#
# Limited permission is hereby granted to reproduce and modify this
# copyrighted material provided that the resulting code is used only in
# conjunction with Bentley Systems products under the terms of the
# license agreement provided therein, and that this notice is retained
# in its entirety in any such reproduction or modification.
#
#----------------------------------------------------------------------
#===========================================
# Project Configuration File
#===========================================
# Project Description as it will appear in Workspace menu > About Workspace
_USTN_PROJECTDESCR = YourFirm_Project1
#----------------------------------------------------------------------
# Set general search paths.
#----------------------------------------------------------------------
# Main location for *.dgn files
MS_DEF = $(_USTN_PROJECTDATA)models/
# Location of Drawing Extractions (can be over-written in the Drawing Definition).
# Note that this variable is included in the search path for MS_RFDIR,
# in the triforma.cfg configuration file.
TF_DRAWINGS = $(_USTN_PROJECTDATA)extractions/
# Following is an example of how you can setup the extraction directory
# to be unique to each user, based on their logon name
# TF_DRAWINGS = $(_USTN_PROJECTDATA)extractions/$(_USTN_USERNAME)/
# Establish additional search paths for reference files
MS_RFDIR > $(_USTN_PROJECTDATA)models_building/
MS_RFDIR > $(_USTN_PROJECTDATA)models_scheme/
MS_RFDIR > $(_USTN_PROJECTDATA)models_working/
#----------------------------------------------------------------------
# TriForma-specific variables that user may wish to set at project level.
# See comments in triforma.cfg for more information about each variable
# Uncomment and define as necessary
# Note: These are just some examples, you can add to this list
# Note: if you set TF_DATASETNAME here, you must include the arch_roles file.
#----------------------------------------------------------------------
TF_DATASETNAME = YourFirm_Project1
%if exists ($(TFDIR)arch_roles.cfg)
%include $(TFDIR)arch_roles.cfg
%endif
MS_DESIGNSEED = atfmodelseed.dgn
%lock MS_DESIGNSEED
TFBXS_DEFNAME = PlanSeed
TF_DRAWSEED = atfdrawseed.dgn
# TFCAT_MENUFILE = $(TFCAT_MENU)tfmaster.cmf
# TFDIR_TEXT = $(TFDIR)text/
TF_DRAWINGS_EXTENSION = dgn
STRUCTURAL_SHAPES = us.stf
No changes are needed here. This is where the prepend sign "<" allows you to search first for project specific data if it exists (cells, parts, etc.) Note: for Parts and Cparts you need to first create the .xml file in the folder for Bentley Architecture to use it.
#----------------------------------------------------------------------
# Prepend search path for any project-level portions of the TriForma Dataset,
# including materials
#----------------------------------------------------------------------
PROJ_DATASET = $(_USTN_PROJECTDATA)dataset/
TFDIR_PART < $(PROJ_DATASET)part/
TFDIR_CELL < $(PROJ_DATASET)cell/
TFDIR_COMP < $(PROJ_DATASET)comp/
TFDIR_CPART < $(PROJ_DATASET)cpart/
MS_MATERIAL < $(PROJ_DATASET)part/
MS_BACKUP < $(PROJ_DATASET)bak/
MS_PATTERN < $(PROJ_DATASET)materials/pattern/
MS_BUMP < $(PROJ_DATASET)materials/bump/
#----------------------------------------------------------------------
# Append search path for other project-level files
# Uncomment and define as necessary; these are just some examples.
# Note that variables for cells are not included, as these will be picked up
# by TFDIR_CELL, which is appended to MS_CELL, etc., in the triforma.cfg
#----------------------------------------------------------------------
# MS_CELL
# MS_CELLOUT
# MS_CELLLIST
# MS_CELLSELECTORDIR
# MS_GLOSSARY < $(PROJ_DATASET)data/*.gls
# MS_SYMBRSRC > $(PROJ_DATASET)data/*.rsc
# MS_SEEDFILES > $(PROJ_DATASET)seed/*.rsc
# MS_SETTINGS
# MS_SETTINGSDIR
# MS_SETTINGSOUTDIR
# MS_DGNLIBLIST = $(TFDIR)dgn/Modeling_Levels.dgnlib
- Editing the user.ucf file:
No manual modification is needed here. TriForma will automatically write the selected user name and project name derived from the log-in name and project selection in MicroStation Manager.
#===================================
# YourFirm_UserA.ucf - User configuration file for using example workspaces.
#==========================================
# $RCSfile: examples.ucf,v $
# $Revision: 1.7 $
# $Date: 2002/03/14 19:05:57 $
#
# Copyright 1998, Bentley Systems, Inc.
#
# Limited permission is hereby granted to reproduce and modify this
# copyrighted material provided that the resulting code is used only in
# conjunction with Bentley Systems products under the terms of the
# license agreement provided therein, and that this notice is retained
# in its entirety in any such reproduction or modification.
#
#----------------------------------------------------------------------
_USTN_USERDESCR = YourFirm_UserA Workspace
#----------------------------------------------------------------------
# Reset the project directory to the "examples" subtree.
#----------------------------------------------------------------------
_USTN_PROJECT = $(_USTN_PROJECTSROOT)
_USTN_PROJECTNAME = YourFirm_Project1
#----------------------------------------------------------------------
#Set the archroles configuration variable to search the server projects directory.
#----------------------------------------------------------------------
ATFDIR_ARCHROLES = H:/Server/Projects/Examples/YourFirm_Project1/dataset/arch_roles.cfg
_USTN_DISPLAYALLCFGVARS = 1
_USTN_HOMEPREFS < H:/server/standards/users/
_USTN_HOMEROOT < H:/server/standards/users/
_USTN_HOMEPREFS < H:/server/standards/users/YourFirm_UserA/