1 Star 0 Fork 63

张泰威 / openFoamUserManual

forked from poplee / openFoamUserManual 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
4.Updating_the_repository_release_of_OpenFOAM.md 9.47 KB
一键复制 编辑 原始数据 按行查看 历史
poplee 提交于 2020-09-09 17:52 . chapter 4 completed

4 更新OpenFOAM仓库版本

4.1 版本管理

OpenFOAM以两种不同的方式分发。 一种方式是使用Git仓库下载的仓库版本。 仓库版本的版本号由附加的x标记,例如 OpenFOAM2.1.x。该版本会经常更新,并在某种程度上是开发版本。 这个版本的更改和更新发布很快,但是,此版本中出现错误的可能性也更大。由于此发行版经常更新,因此在一个系统上安装的2.1.x版本的内容和另一个系统上安装的2.1.x版本可能会不同。因此,每个安装都有附加的信息来标记不同版本的OpenFOAM。版本号随附一个哈希码,以唯一地标识仓库版本的各个内部版本,请参见列表9。每当更新并重新编译OpenFOAM时,此哈希码都会更改。 如果内部版本相同,则两个OpenFOAM安装处于相同级别。

Build : 2.1. x -9 d344f6ac6af

列表 9: 仓库版本的完整版本标识

除了仓库版之外,还有软件包版本。 与仓库版本相比,这些更新的间隔时间更长。 软件包发行版的版本号不包含x,例如OpenFOAM 2.1.1。与仓库版相反,所有相同版本号的安装都是相同的。由于发行周期较长,因此认为发行包不太容易出现软件错误。

这些软件版本有几种不同的类型。这些是针对广泛使用的Linux发行版(Ubuntu,SuSE和Fedora)的预编译软件包,也是一个源码包。可以将源代码包安装在可编译源代码的任何系统上(通常是运行Linux的各种计算机,例如高性能计算集群,甚至运行其他操作系统的计算机)。例如Mac OSX甚至是Windows).

4.2 检查更新

如果从仓库版本安装了OpenFOAM,则更新非常简单。要更新OpenFOAM时,只需使用Git来检查是否有更新的源文件。在终端中切换到OpenFOAM安装的根目录,然后执行git pull。

如果仓库中有较新的文件,Git会下载它们并显示已更改文件的摘要。如列表10所示。

user@host :∼$ cd $FOAM_INST_DIR
user@host :∼/ OpenFOAM$ cd OpenFOAM -2.1. x
user@host :∼/ OpenFOAM / OpenFOAM -2.1. x$ git pull
remote : Counting objects : 67 , done .
remote : Compressing objects : 100% (13/13) , done .
remote : Total 44 ( delta 32) , reused 43 ( delta 31)
Unpacking objects : 100% (44/44) , done .
From git :// github . com / OpenFOAM / OpenFOAM -2.1. x
72 f00f7 ..21 ed37f master -> origin / master
Updating 72 f00f7 ..21 ed37f
Fast - forward
.../ extrude / extrudeToRegionMesh / createShellMesh .C | 10 +-
.../ extrude / extrudeToRegionMesh / createShellMesh .H | 7 +-
.../ extrudeToRegionMesh / extrudeToRegionMesh .C | 157 ++++++++ - - - - -
.../ Templates / KinematicCloud / KinematicCloud .H | 6 +-
.../ Templates / KinematicCloud / KinematicCloudI .H | 7 +
.../ baseClasses / kinematicCloud / kinematicCloud . H | 47 ++++++ -
6 files changed , 193 insertions (+) , 41 deletions ( -)

列表 10: 有可用的更新

如果OpenFOAM是最新的,则Git也将输出相应的消息,如列表11:

user@host :∼/ OpenFOAM / OpenFOAM -2.1. x$ git pull
Already up -to - date .

列表 11: OpenFOAM是最新的

4.3 仅检查更新

如果您只想检查更新而没有实际进行更新,则可以使用特殊选项来调用Git(请参见列表12和13)。在这种情况下,Git仅检查仓库并显示其发现的结果,而不会实际进行任何更改。负责此操作的选项是--dry-run。注意,这里调用了git fetch而不是git pull。git pull调用git fetch下载远程文件,然后调用git merge将检索到的文件与本地文件合并。因此,检查更新实际上是通过git fetch完成的。

user@host :∼$ cd OpenFOAM / OpenFOAM -2.0. x/
user@host :∼/ OpenFOAM / OpenFOAM -2.0. x$ git fetch --dry - run -v
remote : Counting objects : 189 , done .
remote : Compressing objects : 100% (57/57) , done .
remote : Total 120 ( delta 89) , reused 93 ( delta 62)
Receiving objects : 100% (120/120) , 17.05 KiB , done .
Resolving deltas : 100% (89/89) , completed with 56 local objects .
From git :// github . com / OpenFOAM / OpenFOAM -2.0. x
5 ae2802 ..97 cf67d master -> origin / master
user@host :∼/ OpenFOAM / OpenFOAM -2.0. x$

列表 12: 仅检查更新–可用更新

user@host :∼$ cd OpenFOAM / OpenFOAM -2.1. x/
user@host :∼/ OpenFOAM / OpenFOAM -2.1. x$ git fetch --dry - run -v
From git :// github . com / OpenFOAM / OpenFOAM -2.1. x
= [ up to date ] master -> origin / master
user@host :∼/ OpenFOAM / OpenFOAM -2.1. x$

列表 13: 仅检查更新–最新

4.4 安装更新

在通过git pull下载更新后,需要编译更改的源文件才能更新可执行文件。 这与安装OpenFOAM时所执行的方法相同。 只需调用./Allwmake进行编译。该脚本可以识别更改,因此不会再次编译未更改的文件。因此,更新后进行编译所需的时间少于安装OpenFOAM时所需的时间。

4.4.1 工作流程

清单14显示了更新现有OpenFOAM安装所需的命令。 但这仅适用于仓库版本(例如OpenFOAM-2.1.x)的更新。点版本(OpenFOAM的版本号中没有x)的更新方式与仓库版本的更新方式不同。为简单起见,可以将Point Release(OpenFOAM-2.1.0→OpenFOAM-2.1.1)的更新视为全新安装,请参见第3.6节。

将清单14中的前两个命令更改为OpenFOAM安装目录。 然后,通过调用git pull下载最新的源文件。

wclean all这一句可以省略。但是,如果编译以某些错误结束,则此命令通常可以解决问题,请参见第4.5.2节。最后一条语句会编译源文件。如果以前未调用wclean all,则仅编译发生更改的文件。如果调用了wclean all,则将编译所有内容。这可能将花费更长的时间。

如果有足够的时间进行更新(例如整夜),则应在编译之前调用wclean all。在大多数情况下,这将确保更新源的成功编译。

cd $FOAM_INST_DIR
cd OpenFOAM -2.1. x
git pull
wclean all (可以省略)
./ Allwmake

列表 14: 更新现有的OpenFOAM安装的完整的工作流程

4.4.2 问题排查

如果编译报告了一些错误,则再次调用./Allwmake会很有帮助。这大大减少了成功操作的输出(译者注:成功编译的源文件将不再显示,只会在出错的位置显示错误信息),因此更容易找到编译器的实际错误消息。

4.5 更新问题

4.5.1 缺少安装包

如果对操作系统进行了升级,则可能会发生确实安装包的情况,这意味着在更新过程中已删除了一些相关的软件包(例如,如果需要这些软件包来编译OpenFOAM,但操作系统“认为”这些软件包不是必需的)。因此,如果在操作系统升级后重新编译OpenFOAM失败,则可能是缺少软件包的原因。

4.5.2 库的更新

库更新后,必须重新编译它们。否则,求解器将调用尚未编译的库函数。为了避免此问题,必须重新编译相应的库。

wclean all

列表 15: 使用wclean准备重新编译

一个更暴力的方式是重新编译整个OpenFOAM,而不是重新编译更新的库。

4.5.3 更新的源无法编译

在某些情况下,例如当源文件的组织发生变化时,源文件将无法立即编译。又或者,如果有其他未知原因导致无法编译源代码,则可以选择完全重新编译OpenFOAM。尽管编译OpenFOAM需要花费时间,但与跟踪所有错误相比,这可能花费的时间更少。

要重新编译OpenFOAM,需要重置源。有一个简单的命令可以解决此问题,而不是删除OpenFOAM并重新安装。如列表16所示:

git clean - dfx

列表 16: 使用git重置源

列表16中列出的命令使Git擦除没有跟踪的所有文件。这意味着所有不属于git-repository的文件都将被删除。在这种情况下,将重置为OpenFOAM的官方git仓库版本。git clean从当前目录开始递归删除所有不受版本控制的文件。选项-d表示还删除了未跟踪的文件夹。

执行列表16中的命令后,必须按照3.3节中的说明重新编译源。

4.5.4 自有代码无法运行

更新您的OpenFOAM的仓库版本会产生有趣的效果。当OpenFOAM的库更新时,它们的实现可能会更改。即使更新的代码与先前的代码完全兼容,更新后的编译库看起来也可能不同。因此,即使更新保持了代码的兼容性,更新也可能破坏二进制兼容性。因此,需要在基础OpenFOAM安装更新之后重新编译您自己的代码。

更新OpenFOAM之后加载丢失了二进制兼容性的库时会导致分段错误。发生这种情况是因为我们自己的求解器在启动时会动态加载所需的OpenFOAM库,但是库更新之后该库某些对象的内存布局已更改了。

有关此主题的更多信息,请参见以下资源:

失去二进制兼容性不会在每次更新后发生,并且并非在每个库中都发生。因此,在更新以及成功使用其他自己创建的求解器和库的很长一段时间之后,您可能才会遇到此类问题。因此,用户可能无法立即清楚这些问题的根源。如果您的代码突然由于没有原因的无法正常运行了,请重新编译并查看会发生什么。

1
https://gitee.com/roychang/openFoamUserManual.git
git@gitee.com:roychang/openFoamUserManual.git
roychang
openFoamUserManual
openFoamUserManual
master

搜索帮助