4.1.1 Selecting the Server Configuration File to Read . . . . . . . . . . . . 104
4.2 Working With Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . 104
4.2.1 Editing the Configuration Files Using SOS Manager . . . . . . . . . 104
4.2.2 Configuration File Locations . . . . . . . . . . . . . . . . . . . . . . 105
4.2.3 Configuration File Format . . . . . . . . . . . . . . . . . . . . . . . . 106
4.2.4 Configuration File Templates . . . . . . . . . . . . . . . . . . . . . . 106
4.2.5 Customizing Configuration Files with SOS Manager . . . . . . . . . 108
4.3 Setting Project Access Controls . . . . . . . . . . . . . . . . . . . . . . . . . 109
4.3.1 Host-Based Access Control in SOSAdmin . . . . . . . . . . . . . . . 110
4.3.2 Configuration File Example for Access Control . . . . . . . . . . . . 111
4.3.3 Global and Default Access Controls . . . . . . . . . . . . . . . . . . 115
4.3.4 Access Control Best Practices for Virtuoso Data . . . . . . . . . . . . 116
4.3.5 Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
4.3.6 Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
4.3.7 Managing umask and Linux Permissions . . . . . . . . . . . . . . . . 125
4.4 Setting the Default Revision Search Order, Populate, Root Directory,
Branch, and Work Area UMASK Options . . . . . . . . . . . . . . . . . . . . 126
4.4.1 Revision Search Order . . . . . . . . . . . . . . . . . . . . . . . . . . 126
4.4.2 Populating Directories . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.4.3 Work Area Root Directory . . . . . . . . . . . . . . . . . . . . . . . . 127
4.4.4 Branch Options for Files and Directories . . . . . . . . . . . . . . . . 128
4.4.5 UMASK Settings for Work Areas . . . . . . . . . . . . . . . . . . . . 129
4.5 Server-side Tcl Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.6 Defining Reference Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
4.6.1 Setting Up Projects for Referencing . . . . . . . . . . . . . . . . . . 132
4.6.2 Adding References . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.6.3 Specifying the RSO for a Reference . . . . . . . . . . . . . . . . . . 134
4.6.4 Generating a “Who Uses” Report for a Reference Project . . . . . . 135
4.6.5 Syntax of the REFERENCE_PROJECT Block . . . . . . . . . . . . . . 135
4.7 Supporting external references to third party SCM/DM systems . . . . . . . 137
4.7.1 Adding SCM/DM References . . . . . . . . . . . . . . . . . . . . . . 139
4.7.2 Adding SCM/DM references for sparsely populated directories . . . 142
4.7.3 Using soscmd command line for third party SCM/DM references . . 143
4.8 Defining and Using Project Views . . . . . . . . . . . . . . . . . . . . . . . . 146
4.8.1 Using the Revision Search Order in Project Views . . . . . . . . . . . 148
4.8.2 Creating a Project View . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.8.3 Using a Project View . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
4.9 Creating Writable Work Areas and Specifying Work Area Types . . . . . . . 150
4.10 Integrating SOS Projects with Change Request Tracking Systems . . . . . . 151
4.11 Modifying sosd.cfg file from the command line interface . . . . . . . . . . 152
4.12 Using aliases to uniquify project names . . . . . . . . . . . . . . . . . . . . 152
4.13 Creating and Managing Sparse Workarea . . . . . . . . . . . . . . . . . . . 153
4.13.1 Creating Sparse Workareas at the Cache . . . . . . . . . . . . . . . 154
4.13.2 Viewing/Editing Sparse Workareas at the Cache . . . . . . . . . . . 155
4.14 Workarea Configuration for RSO and Preferences . . . . . . . . . . . . . . . 157
iii
