SOS常用操作举例v1.1

SOS常用操作举例v1.1
SOS 常用操作举例（基于SOS GUI）
创建SOS项目的本地copy目录并启动SOS GUI
> cd /projects/LW8001A/username/r0p0 #进入要创建SOS项目的本地copy的目录>sos #启动SOS GUI （或者使用命令>bsub –Is sos）
如果没有license，输入命令：>module unload lic
>module load lic
>bsub –Is sos
创建新的Work Area
注意需要选中Links to Smart Cache！
Create File/Directory
1.首先执行Tree→populate
文件第一次加入SOS版本库的时候要进行Create操作，下图是点完GUI上的create按钮以后弹出的对话框，请注意红圈标注的部分：Group：指定文件所属的SOS group，建议都选到all_my_groups
Read Access/Write Access: 可以指定是owner/group/all有读写权限。

建议默认选all。

这样整个项目的人不管属于哪个group都能看。

如果只想本group的人能看到，可以选择group的读写权限。

Description：养成写Description的好习惯。

SOS里的文件在修改之前需要先checkout。

首先选中要checkout的文件，然后点击Chk Out 按钮。

下图是点击Chk Out按钮后弹出的对话框。

注意红圈标注的选项：Enable concurrent checkout：允许在别人已经checkout的同时checkout
Do NOT lock file: 在checkout的时候不lock文件，选中该选项其他人看不到文件已经被checkout。

下图是在checkout以后文件上的标志。

正常checkout后的文件会有一个黄色叶子的标志。

如果checkout的时候选中了“Do NOT Lock file”，checkout后的文件会是一个灰色叶子的标志。

文件修改完后需要check in到SOS仓库中。

首先选中需要check in的文件，然后点击Chk In 按钮。

下图是点击Chk In按钮之后弹出的对话框。

请注意养成check in时写log的好习惯。

下图是Check In之后的效果：（注意红圈标注的部分，Check in 之后test.v多了一个版本2）
Discard Check Out
如果需要解除对文件的Check Out，需要运行Discard Check Out命令。

选中要Discard的文件，然后点击Discard按钮。

下图是点击Discard按钮以后弹出的对话框。

注意红圈标注的部分：默认情况下”Do not discard if modified”选项是选中的，保证在本地有改动的情况下，不解除check out。

如果想放弃本地的改动，强制Discard，需要把该选项去掉。

设置和使用Tag
SOS使用Tag标识和管理特定版本。

使用Tag之前需要首先定义Tag。

具体方法如下图：
定义好Tag以后可以选择应用Tag，首先要选中要应用Tag的文件，然后点击Tag按钮。

下图是点击完Tag按钮以后弹出的对话框：（左下角的红圈标识的是应用完Tag的效果，test_tag 应用在了test 这个文件夹的版本2上）
EDIT&DIFF
在SOS GUI中可以直接调用EDIT和DIFF工具进行查看，编辑和比较。

用户可以根据自己的喜好设置EDIT和DIFF的工具。

具体方法如下图所示：(File->Preferences)
设置好EDIT和DIFF的工具之后就可以进行编辑和比较的工作了。

编辑的时候先选中要编辑的文件，默认是选中本地最新文件，用户也可以选中具体的版本来查看。

然后点击Edit按钮。

弹出的要编辑的文件如下图：(以gvim为例)
比较的时候要选中要比较的版本(图中左下角选中的是版本1和版本2进行比较)，然后点击Diff按钮。

弹出的DIFF结果如下图：(以gvimdiff为例)
Update
通过Update命令，可以把本地的文件更新到最新或者某一特定的版本。

下图是点击Update 按钮后弹出的对话框。

注意其中的选项：At Time：可以指定Now（表示版本库中当前最新的版本）或者Specified Time（表示版本库中某个时间点的版本）
Update: Changed Files ONLY :只更新改变的文件，不更新改变的目录。

Changed Files and Dirs:既更新改变的文件，也更新改变的目录。

Flags & Attributes ONLY: 只更新文件的标志和属性，不更新实际的文件和目录。

这个选项在用户只需要查看本地版本和SOS上的版本的区别，又不想改变本地
的文件的版本时非常有用。

Delete
如果某个文件没有用了，可以从版本库中删除。

具体操作如下：
(选中要删除的文件，然后选择Tree-> Delete)
删除后的效果如下图。

会发现test.v没有了，但是test目录多了一个版本2。

实际上虽然文件删除了，但是文件的信息还是在版本库中存在着。

删除的时候文件夹会自动增加一个版本，用户可以通过回退文件夹的版本来找回原来删除的文件。

Use Revision改变本地文件的版本
如果想把本地的某个文件切换到特定版本，需要使用use revision 命令。

具体操作如下图：(需要先选中要切换回的版本，然后选择Revision->Use Revision。

左下角是test.v切换到版本1之后的效果)
Revert Revision 回退版本
如果发现check in的版本有问题，需要回退到之前的版本，可以使用Revert Revision命令。

具体操作如下图：(首先要选中要回退到的版本，如本例中的test.v的版本1，然后选择
Revision->Revert Revision。

图中左下角是Revert之后的效果。

会发现test.v多了一个版本3，其是由版本1 revert之后产生的)
Select files
Select是一个非常有用的文件菜单，通过里面的不同选择方式，用户可以精确并且方便的选中想要选中的文件，然后进行后续的操作。

具体操作方式如下图：
Modify Attributes
如果需要改变已经Check in的文件的某一版本的属性，可以使用Modify Attributes命令。

具体操作如下图：(首先选中需要改变的文件的版本，然后选择Modify Attrs-> Source File/Directory) 可以改变的属性包括：Owner/Group/Read Access/Write Access/Description
Virtuoso下使用sos
在工作目录下（例如/proj/lw8001A/ana/s8005/r0p0）
执行一下/Edatools/clio/sos_7.04.p1_linux64/bin/cds_ci_initail.pl ./ 然后再启动virtuoso
Learn More
更多关于SOS的使用文档，请参考Cliosoft SOS官方文档。

soscmd ci/co …。