ナレッジベースを名前を変えてコピーする方法


ナレッジベースのコピーは、基本的な機能としては無く、少々面倒な手順が必要です。

新しいプロジェクトのために新規ナレッジベースを用意する際に、過去のナレッジベースから開発をスタートさせたい場合は良くあります。
それ以外でも、他者にナレッジベースを渡したい場合にも使えますので、覚えておいて頂くと何かと役に立ちます。

ちなみにGeneXusServerがあると簡単に実施できますが、今回は、GeneXusServerが無い場合の手順を掲載します。
※以下の手順はGeneXus16U2ですが、GeneXus15 Ev1から同じ手順で行えます。

１．GeneXusを終了する


GeneXusが起動していると行えない処理があるため、必ず終了しましょう。


２．SQLServerから元のKBをデタッチ


1)SQLServerのManagement Studioを起動して、
　ナレッジベースが格納されているデータベースをデタッチします。


2)システムDBも併せてコピーする場合はそれもデタッチします。
　※システムDBがSQLServer以外の場合は、ダンプ／バックアップ 等


３．KBフォルダをコピー


1)KBフォルダをコピーします。


2)フォルダ名を新しいKB名に変更します。


４．KBフォルダ内の不要ファイルを削除、ファイル名を変更


1)以下のファイルを残して、削除します。
　・GX_KB_TestKB_WWP_16U2.mdf　（ナレッジベース格納DB）
　・GX_KB_TestKB_WWP_16U2_log.ldf　（ナレッジベース格納DBのログ）
　・knowledgebase.connection　（ナレッジベース格納DBがどこにあるかを示すファイル）
　・TestKB_WWP_16U2.gxw　（GeneXus起動用のショートカット）
　・TestKB_WWP_16U2_DB.mdf　（システムDB）
　・TestKB_WWP_16U2_DB_log.ldf　（システムDBのログ）



2)ファイル名を新しいKB名に合わせて変更します。

　TestKB_WWP_16U2　→　TestKB_WWP_16U2_COPY

　・GX_KB_TestKB_WWP_16U2_COPY.mdf
　・GX_KB_TestKB_WWP_16U2_COPY_log.ldf
　・TestKB_WWP_16U2_COPY.gxw
　・TestKB_WWP_16U2_COPY_DB.mdf
　・TestKB_WWP_16U2_COPY_DB_log.ldf

５．mdfファイル、ldfファイルのセキュリティ権限を変更


mdfファイル、ldfファイルを右クリックでプロパティを開く
セキュリティタブで、Everyoneユーザーにフルコントロール権限を追加します。
（4ファイルすべてに対して行います）



※この手順を行わなかった場合、次のmdfファイルのアタッチで、
　「アクセスが拒否されました」とエラーが発生します。


６．mdfファイルを名前を変えてアタッチ


1)SQLServerのManagement Studioから、名前を変えたmdfファイルをアタッチします。



2)名前を変えてアタッチするために、次の設定を行います。

・上段枠の「次の名前でアタッチ」の個所を、新しい名前に変更
・下段枠の「現在のファイルパス」を新しい名前のmdfファイルに指定しなおし
・下段枠の「現在のファイルパス」を新しい名前のldfファイルに指定しなおし



3)OKをクリック

※ldfファイルが無い場合は、下段枠のldfの個所を削除すれば、アタッチの際に、新規で作成されます。

4)アタッチして作成されたDBのプロパティを開く

5)DBの論理名が元の名前になっているので、新しい名前に変更する




７．knowledgebase.connectionの編集


knowledgebase.connectionファイルをテキストで開いて、
元の名前になっている箇所を、新しい名前に変更して保存する

<ConnectionInformation>
<DBName>GX_KB_TestKB_WWP_16U2</DBName>
<IntegratedSecurity>True</IntegratedSecurity>
<ServerInstance>SYUSA-IIPC\SQL2012</ServerInstance>
<CreateDbInKbFolder>True</CreateDbInKbFolder>
<Directory>C:\knowlage_base\gx16\TestKB_WWP_16U2</Directory>
<DataFile>GX_KB_TestKB_WWP_16U2.mdf</DataFile>
<LogFile>GX_KB_TestKB_WWP_16U2_log.ldf</LogFile>
<HostName>SYUSA-IIPC</HostName>
</ConnectionInformation>

↓↓↓

<ConnectionInformation>
<DBName>GX_KB_TestKB_WWP_16U2_COPY</DBName>
<IntegratedSecurity>True</IntegratedSecurity>
<ServerInstance>SYUSA-IIPC\SQL2012</ServerInstance>
<CreateDbInKbFolder>True</CreateDbInKbFolder>
<Directory>C:\knowlage_base\gx16\TestKB_WWP_16U2_COPY</Directory>
<DataFile>GX_KB_TestKB_WWP_16U2_COPY.mdf</DataFile>
<LogFile>GX_KB_TestKB_WWP_16U2_COPY_log.ldf</LogFile>
<HostName>SYUSA-IIPC</HostName>
</ConnectionInformation>

※「IntegratedSecurity」はKBを開く際にWindows認証かどうかの設定です。
　Falseとなっていても問題ありません。


８．GeneXusからKBを開く


1)GeneXusを起動する

2)[ファイル][開く]から、新しいKBファルダのTestKB_WWP_16U2_COPY.gxwを
　選択すると、ナレッジベースが展開されます。

3)エラーパターンA


Windows認証では無い場合には、ユーザーIDとパスワードを新たに求めています。
SQLServerに接続できるIDとパスワードを入力してください。


4)エラーパターンB


knowledgebase.connectionファイルの内容が誤っていますので、内容をよく確認してください。


９．KB名を変更


KB名が元の名前になっていますので、新しい名前に変更します。



１０．すべてリビルド


すべてリビルドを行って、完了です。


補足事項

・ナレッジベースをmdfファイルでコピーした場合は、コピー元とそっくり同じ状態となります。
　例えば、修正してビルドしていないオブジェクトがあった場合も、同じ状態
　オブジェクトの変更履歴も同じ、GeneXusServerとの接続情報も同じ状態です。


・応用の手法として、システムが大きくリビルドに時間が掛かる場合には、
　誰かがリビルドを実施して、そのKBをmdfファイル毎コピーすれば、ビルド後の状態を受け渡すことができます。
　但し、その場合は、手順４．の不要ファイルの削除は行いません。
　さらにTomcat配下の実行モジュールも併せて、他者にコピーする必要があります。


＜参考情報＞
.MDF からナレッジベースを作成する方法

GeneXus FAQ: ナレッジベースをバックアップする方法

コメント

コメントを投稿

このブログの人気の投稿

IVS文字・サロゲートペア文字の注意

システムの中で文字数を取得する際には IVS文字・サロゲートペア文字 に注意が必要です。 IVD/IVSとは | 文字情報基盤整備事業 https://mojikiban.ipa.go.jp/1292.html サロゲートペア入門：CodeZine（コードジン） https://codezine.jp/article/detail/1592 例えば、エラーチェックで指定した「文字数」で固定する場合 最大「文字数」を超えているかチェックする場合 GeneXusでは&変数.Length()か、またはLen(&変数)で文字数を取得することが出来ます。 但し、上記のIVS文字・サロゲートペア文字の場合は、 見た目の１文字が１文字として算出されません。 試した環境：GeneXus15U10 通常文字　：辻 ＩＶＳ文字：辻の点が１つの文字 このLengthを求めると、以下の結果となります。 通常文字　：１文字 ＩＶＳ文字：３文字 --------- 通常文字　　　　　：叱 サロゲートペア文字：叱（環境依存） このLengthを求めると、以下の結果となります。 通常文字　　　　　：１文字 サロゲートペア文字：２文字 ※IVS文字とサロゲートペア文字を試したい場合は、Windowsの設定を変更する必要があります。 　Microsoft IMEの場合 　　・IMEのプロパティから[詳細設定] 　　・[変換]タブの[詳細設定] 　　・変換文字制限に 　　　　　変換文字制限をしない 　　　　　IVSを含む文字を制限する 　　　　　サロゲートペアを含む文字を制限する 　　　といった候補が出ますので、[変換文字制限をしない]をチェックしてください。 　　　これで変換候補にIVS文字とサロゲートペア文字が出てきます。 　　※※※ 　　　　試した後は、戻しておいた方が良いです。 　　　　メールなどで送ってしまうと相手に迷惑ですので。 ちなみにBytecount()を使用してバイト数（文字コードはUTF-8）を取得すると 以下の結果となります。 通常文字　：辻 ＩＶＳ文字：辻の点が１つの文字 ↓↓↓ 通常文字　：３バイト ＩＶＳ文字：７バイト ---------...
Read more »

Tomcatの設定３：8080ポート以外で動作させる

Tomcatで運用する場合で、いくつか考慮した方が良い設定・情報を記載します。 Tomcatのデフォルトではポート8080で動作します。 URLがhttp://localhost:8080/xxxxx/servlet/xxxxxという形になりますね。 こちらをポート80（http）で動作するようにすると、 URLからポートの記述を省略することができます。 http://localhost:8080/xxxxx/servlet/xxxxx ↓↓↓ http://localhost/xxxxx/servlet/xxxxx http://localhost:80/xxxxx/servlet/xxxxx と同じ 同じように、SSLを使ってhttpsにする場合はTomcatのデフォルトは8443ですが、 443（https）ポートで動作するようにすると、こちらも省略できます。 https://localhost:8443/xxxxx/servlet/xxxxx ↓↓↓ https://localhost/xxxxx/servlet/xxxxx https://localhost:443/xxxxx/servlet/xxxxx と同じ ＜設定方法＞ ※Apacheと連携する場合はApacheが80ポートで動作しますので、 以下の設定方法は、”Tomcatのみ”で動作させる場合の設定方法となります。 Tomcat\conf\server.xmlを修正します。 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> ↓↓↓ <Connector port=" 80 " protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> 以上です。 SSL（https）を設定済みの場合は8443と記載の個所を443に変...
Read more »

GeneXusのオプション設定、起動時オプション

イメージ
GeneXusをインストールした後に、私が 必ず行う設定 を紹介します。 GeneXusの[ツール][オプション] ①KBエクスプローラーにディスクリプションを表示 これが こうなる ②ダイアグラムにディスクリプションを表示 これが こうなる ③ビルドオプション ・インスタンスの同時生成 ・インスタンスの同時分析 これはビルド時にCPUを何コア使うかの設定です。 良いPCを使っている場合は、こちらの設定を確認した方が良いです。 GeneXusは基本1オブジェクトが1ソースとなります。 1ソースに割り当たるコアは一つだけです。 なので、1オブジェクトが大きい場合のビルド時間はCPUの個数ではなく速さに依存します。 ただ、複数オブジェクトをビルドする場合やリビルドする場合には 並列で処理が行われるので、かなりの差が出てきます。 ビルドは分析（Specify）と生成（Build）に分かれており、分析は割と早く終わります。 これに割り当てるのが「インスタンスの同時分析」です。 生成（Build）が実際のJavaソースや.NETのソースの生成です。 物理的にファイルを作るので時間が掛かります。 これに割り当てるのが「インスタンスの同時分析」で、時間が掛かる場合は大体こちらです。 全部のCPUコアをあててしまうとOSが止まるでしょうから、最適な数値を設定するのが良いでしょう。 複数の同時生成処理と分析処理のインスタンス http://wiki.genexus.jp/hwiki.aspx?%E8%A4%87%E6%95%B0%E3%81%AE%E5%90%8C%E6%99%82%E7%94%9F%E6%88%90%E5%87%A6%E7%90%86%E3%81%A8%E5%88%86%E6%9E%90%E5%87%A6%E7%90%86%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%82%BF%E3%83%B3%E3%82%B9, ・ナビゲーション詳細 こちらをTrueにすると、トランザクション画面をビルドした後のナビゲーションで Rulesに指定した内容の実行順序が出てきます。 トランザクション画面を利用...
Read more »

Tomcatの設定５：メモリ調整と起動モード

イメージ
Tomcatで運用する場合で、いくつか考慮した方が良い設定・情報を記載します。 Tomcatのデフォルトでは初期メモリが128MB、最大が256MBとなっています。 市販のパソコンでもメモリは4GBや8GBは有りますので、初期値は非常に小さいです。 Linuxの場合は、Tomcatの起動オプションで、設定してください。 WindowsのTomcatの場合は設定コンソールから設定します。 サーバーのスペックや構成に合わせて必ず調整した方が良いものは以下の内容になります。 １．メモリ（ヒープ領域） -Xms ：Initial memory pool -Xmx ：Maximum memory pool Tomcat起動時に初期メモリが確保され、不足したら拡張を繰り返す形となります。（最大値まで） 個人的にはどうせ拡張するのであれば、初期メモリの時点である程度確保しておいた方が良いと考えてます。 その方が拡張の際の処理動作コストも軽減されますので。 どの位の設定が良いのかは一概には言えず、 私の経験則からの例ですが、総メモリが8GBで、TomcatとPostgreSQLが同居したサーバーの場合であれば、初期2GB、最大3GB位の設定にしますね。 ２．起動モード Tomcatには起動モードが2種類あり、「クライアントモード」と「サーバモード」があります。 ＜クライアントモード＞ 起動時間を短縮し、メモリサイズを縮小するように調整されている。 起動時に「-client」オプションを付けて実行する。 ＜サーバーモード＞ プログラム実行速度が最大になるように設計されている。 起動時に「-server」オプションを付けて実行する。 運用時にはサーバーモードで動作させるようにしましょう。 ３．メモリ（Permanent領域） -XX:PermSize ・・・ Permanent 領域の初期値 こちらは運用中の影響ではなく、Tomcatが起動できるかどうかという設定です。 プログラムが大量にある場合、Tomcat起動時にロードしきれずにエラーになったり、 起動が遅かったりしますので、その際には拡張した方が良いです。 サーバーモードの初期値は64MBです。 システムの規模がそこそ...
Read more »

Tomcatで画面表示の速度改善

イメージ
GeneXusのJavaでTomcatを利用している場合に、効果があった速度改善を記載します。 GeneXusはデフォルトで表示する画面のHTMLページを圧縮する設定になっています。 [Auto Compress Http Traffic] プロパティ http://wiki.genexus.jp/hwiki.aspx?%5BAuto+Compress+Http+Traffic%5D+プロパティ, HTMLページはGeneXusがやってくれますので、 JavaScriptやCSSをサーバー側の設定で圧縮することで更に改善することができます。 JavaScriptやCSSも全部合わせればかなりのサイズになりますので、 サーバーがクラウドなどで遠隔地にあり、転送速度がボトルネックとなっているシステムだとかなりの効果がでます。 社内LAN上のシステムの場合だとさほど効果はないかもしれませんが、試してみる価値はあると思います。 設定方法 ※Tomcat8.5で記載 Tomcat/conf/server.xmlを編集 <Connector port="8080" protocol="HTTP/1.1" の箇所に以下の設定値を追記 compression="on" compressionMinSize="2048" noCompressionUserAgents="" compressableMimeType="text/html,text/css,text/plain,text/javascript,application/javascript,application/json,image/svg+xml" useSendfile="false" 例： <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" compression="on" compressionMinSize="2048" noCompressionUserAge...
Read more »

Tomcatの設定１：データソースを使用する方法とメリット

イメージ
GeneXusに限った話ではないのですが、 ジェネレータにJavaを選んだ場合はTomcatを利用することが多いかと思いますので、 Tomcatで運用する場合で、いくつか考慮した方が良い設定・情報を記載します。 GeneXusのデフォルト設定だと、DBへの接続方法はJDBCで、 コネクションプーリングもアプリケーション側で実施する形となります。 [Enable Connection Pooling] プロパティ http://wiki.genexus.jp/hwiki.aspx?%5BEnable+Connection+Pooling%5D+プロパティ, このままでも特に問題は無いのですが、 私の経験上、Tomcatのデータソースを利用する方が安定性が少し上がります。 数年前の事例ですが、サーバーを起動したまま運用を続けていくと、 徐々にTomcatのメモリが蓄積されていき、数週間すると動きが悪くなってくる。という現象がありました。 サーバースペックや、利用人数、アプリ側の作り方など、色々と影響は考えられますが、 何か特定の処理や操作をした場合ではなく、少しづつゴミデータが蓄積されているような状況でした。 このシステムでTomcatのデータソースを利用するようにしたところ、 問題が解消され、メモリが綺麗に開放されるようになった。 という経験があります。 このことから、Tomcatのデータソースを利用した方が、安定性が良いのかと思う次第です。 やはり世界中の技術者に10年も20年も使い込まれたTomcatは性能や品質が良いのでしょうね。 ただ、まあ、運用計画的に1週間に1回位は再起動をした方が 何かと良いのではないかとも思いますけどね。 ＜設定方法＞ １．TomcatのcontextにDB情報を定義する Tomcat\conf\context.xmlか、 Tomcat\conf\catalina\localhost\<アプリケーション名>.xmlのどちらかに記述する 記述場所は<Context> ～ </Context>の間 <Resource name="jdbc/ 【任意のデータソース名】 " auth=...
Read more »