FishEye迁移到MS SQL Server

要将 FishEye/Crucible 迁移到 SQL Server database, 先安装 SQL Server 并按照下面的步骤操作. FishEye 与 Crucible 共享一个数据库

开始之前

检查SQL Server版本是否符合 FishEye迁移到MS SQL Server 的要求

已知 Java 1.6.0_29 及以上版本 (包括 Java 1.7.0) 有阻止连接的缺陷. 请参考 here. 解决方法。

步骤 1. 安装并创建 SQL Server 数据库

参考 SQL Server Online resources (MSDN) 了解如何安装何创建 SQL Server 数据库

请注意安装和创建SQL Server时的注意事项:

SQL Server JDBC jtds 驱动已经捆绑在 Crucible 中. 我们不建议使用 Microsoft 发布的 jdbc driver.
FishEye 数据库用户必须拥有连接数据库何创建数据表的权限
数据库用户无需是数据库所有者, 但应当是 db_owner 角色成员. (请参考 SQL Server Startup Errors .)
数据库字符集必须是 Latin1_General_CS_AS
数据库服务器必须配置业务隔离等级为使用快照模式. 要启用快照模式，运行下面代码:
```
ALTER DATABASE fisheye
   SET READ_COMMITTED_SNAPSHOT ON;
```
请注意，最好停止FishEye/Crucible后再运行上面的代码 (并且没有其他程序连接 SQL Server 数据库)。

On this page:

Related pages:

步骤 2. 配置FishEye/Crucible 与SQL Server的链接

为了迁移到不同的数据库，你必须先备份SQL数据, 配置数据库，然后再通过恢复操作导入数据. 这些操作可以通过 FishEye/Crucible administration console, 或通过 command line tool 实现. 后面将详细介绍这两种方法. The following resources may be of interest:

Backing up and restoring FishEye data

通过 FishEye/Crucible's 管理界面配置和迁移

开始之前:

注意, 迁移过程中 (可能会持续几分钟，取决于数据库大小和网络情况), FishEye/Crucible 将无法通过API客户端访问. 用户将会看到维护界面，通知他们正在进行数据维护
如果你要继续上次迁移失败的操作，必须删除所有数据表、索引然后再进行新的迁移操作
检查 jtds JDBC 驱动 .jar 文件再 classpath (将 .jar 文件复制到 inFISHEYE_INST/lib).
确保数据库用户可以通过FishEye/Crucible服务器访问并登录数据库服务器。

要配置 FishEye/Crucible 使用 SQL Server并通过管理界面迁移数据:

跳转到FishEye/Crucible管理界面的 Database 部分
要登录到管理界面，你可以:
- 点击页面底部的 Administration 链接
- 或前往 http://HOSTNAME:8060/admin/, HOSTNAME 是安装FishEye的服务器名称或ip
配置 FishEye/Crucible 使用SQL Server, 步骤如下:
- 点击 Edit -> Test Connection 检查FishEye/Crucible 可以链接数据库.
- 从 Type 下拉列表中选择 SQLServer
- 完成相关参数， URL (主机、端口和数据库名), User Name (用户名) 和 Password(密码)必填，
  注意: 默认 SQL 服务器端口号是 1433.
  例如 URL: jdbc:jtds:sqlserver://localhost:1433;databaseName= 这里填写数据库名;

请确保使用 SQL Server 用户登录数据库，而不是Windows用户帐号

点击 Test Connection 校验上述参数是否配置正确
点击 Save & Migrate Data 开始迁移。如果迁移失败, FishEye/Crucible 会切换切换到新数据库，并报告错误

Screenshots: Configuring FishEye/Crucible to use SQL Server and migrating data (click to view full-size images)

没有附加到此页面的图片。

通过命令行配置和迁移

要通过命令行配置 FishEye/Crucible 使用 SQL Server 并迁移数据:

备份 FishEye/Crucible 数据. 请参考 FishEye迁移到MS SQL Server \ FishEye迁移到MS SQL Server

在FishEye安装路径/bin下运行下面的命令:

$ ./fisheyectl.sh restore --sql \
        --file /path/to/backup.zip \
        --dbtype sqlserver2008 \
        --jdbcurl "jdbc:jtds:sqlserver://hostname:port;databaseName=dbName;" \
        --username crucible \
        --password password

当迁移成功, FishEye/Crucible 将启用 SQLServer数据库.

页面树结构