1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_repl_server_rename">
<refmeta>
<refentrytitle>repl_server_rename</refentrytitle>
<refmiscinfo>repl</refmiscinfo>
</refmeta>
<refnamediv>
<refname>repl_server_rename</refname>
<refpurpose>rename the publishing server instance</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_repl_server_rename">
<funcprototype id="fproto_repl_server_rename">
<funcdef><function>repl_server_rename</function></funcdef>
<paramdef>in <parameter>old_name</parameter>varchar</paramdef>
<paramdef>in <parameter>new_name</parameter>varchar</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_repl_server_rename"><title>Description</title>
<para>
This function is useful to rename the publishing servers data (that stored
in to the replication tables) after renaming the server in virtuoso.ini file.
The call of the procedure will associate the all data belong to the old server
name to the current server name. It will also set the appropriate transaction
levels. In case of duplicate publications (publications with the same name
exists in old and new server definitions) it will reject the operation.</para>
</refsect1>
<refsect1 id="params_repl_server_rename"><title>Parameters</title>
<refsect2><title>old_name</title>
<para>The old name of the publishing server.</para></refsect2>
<refsect2><title>new_name</title>
<para>The new name of the publishing server (must be the same as ServerName from Replication section of INI file).</para></refsect2>
</refsect1>
<!-- 3019
This function has no return value
Errors:
42000 TR057 The new name must be the same as in the ServerName (from INI file)
42000 TR059 The current name of server cannot be altered.
42000 TR060 The name of new server used from another publishing server.
42000 TR061 The publication on "[new_name]" exists with the same name a on "[old_name]". The rename operation can not be performed
42000 TR058 General error, publication records can't be updated
-->
<refsect1 id="examples_repl_server_rename"><title>Example</title>
<example id="ex_repl_server_rename_1"><title>Renaming of the existing publisher server</title>
<para>An existing publisher 'demo-pub' server is renamed to the 'working-pub'.
In order to update the subscriber descriptions we MUST issue the following:</para>
<screen>
SQL> DB.DBA.REPL_SERVER_RENAME ('demo-pub', 'working-pub');
</screen>
</example>
</refsect1>
<refsect1 id="seealso_repl_server_rename"><title>See Also</title>
<para><link linkend="fn_sub_schedule"><function>sub_schedule()</function></link></para>
<para><link linkend="fn_repl_disconnect"><function>repl_disconnect()</function></link></para>
<para><link linkend="fn_repl_grant"><function>repl_grant()</function></link></para>
<para><link linkend="fn_repl_init_copy"><function>repl_init_copy()</function></link></para>
<para><link linkend="fn_repl_new_log"><function>repl_new_log()</function></link></para>
<para><link linkend="fn_repl_pub_add"><function>repl_pub_add()</function></link></para>
<para><link linkend="fn_repl_pub_init_image"><function>repl_pub_init_image()</function></link></para>
<para><link linkend="fn_repl_pub_remove"><function>repl_pub_remove()</function></link></para>
<para><link linkend="fn_repl_publish"><function>repl_publish()</function></link></para>
<para><link linkend="fn_repl_revoke"><function>repl_revoke()</function></link></para>
<para><link linkend="fn_repl_sched_init"><function>repl_sched_init()</function></link></para>
<para><link linkend="fn_repl_server"><function>repl_server()</function></link></para>
<para><link linkend="fn_repl_stat"><function>repl_stat()</function></link></para>
<para><link linkend="fn_repl_status"><function>repl_status()</function></link></para>
<para><link linkend="fn_repl_subscribe"><function>repl_subscribe()</function></link></para>
<para><link linkend="fn_repl_sync"><function>repl_sync()</function></link></para>
<para><link linkend="fn_repl_sync_all"><function>repl_sync_all()</function></link></para>
<para><link linkend="fn_repl_text"><function>repl_text()</function></link></para>
<para><link linkend="fn_repl_this_server"><function>repl_this_server()</function></link></para>
<para><link linkend="fn_repl_unpublish"><function>repl_unpublish()</function></link></para>
<para><link linkend="fn_repl_unsubscribe"><function>repl_unsubscribe()</function></link></para>
</refsect1>
</refentry>
|
