Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 1 | type=page |
| 2 | status=published |
| 3 | title=import-sync-bundle |
| 4 | next=install-node.html |
| 5 | prev=get-health.html |
| 6 | ~~~~~~ |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 7 | |
David Matějček | dbccabf | 2021-12-20 14:06:31 +0100 | [diff] [blame] | 8 | = import-sync-bundle |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 9 | |
| 10 | [[import-sync-bundle-1]][[GSRFM00142]][[import-sync-bundle]] |
| 11 | |
David Matějček | dbccabf | 2021-12-20 14:06:31 +0100 | [diff] [blame] | 12 | == import-sync-bundle |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 13 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 14 | Imports the configuration data of a clustered instance or standalone |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 15 | instance from an archive file |
| 16 | |
| 17 | [[sthref1243]] |
| 18 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 19 | === Synopsis |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 20 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 21 | [source] |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 22 | ---- |
| 23 | asadmin [asadmin-options] import-sync-bundle [--help] |
David Matějček | 9d73d04 | 2021-12-20 13:03:32 +0100 | [diff] [blame] | 24 | --instance instance-name |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 25 | [--nodedir node-dir] [--node node-name] |
| 26 | file-name |
| 27 | ---- |
| 28 | |
| 29 | [[sthref1244]] |
| 30 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 31 | === Description |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 32 | |
| 33 | The `import-sync-bundle` subcommand imports the configuration data of a |
| 34 | clustered instance or standalone instance from an archive file that was |
| 35 | created by the |
| 36 | link:export-sync-bundle.html#export-sync-bundle-1[`export-sync-bundle`(1)] |
| 37 | subcommand. |
| 38 | |
| 39 | You must run this subcommand on the host where the instance resides. To |
| 40 | contact the domain administration server (DAS), this subcommand requires |
| 41 | the name of the host where the DAS is running. If a nondefault port is |
| 42 | used for administration, this subcommand also requires the port number. |
| 43 | You must provide this information through the `--host` option and the |
| 44 | `--port` option of the link:asadmin.html#asadmin-1m[`asadmin`(1M)] |
| 45 | utility. |
| 46 | |
| 47 | Importing an instance's configuration data transfers the data to a host |
| 48 | for an instance without the need for the instance to be able to |
| 49 | communicate with the DAS. Importing an instance's configuration data is |
| 50 | typically required for the following reasons: |
| 51 | |
| 52 | * To reestablish the instance after an upgrade |
| 53 | * To synchronize the instance manually with the domain administration |
| 54 | server (DAS) when the instance cannot contact the DAS |
| 55 | |
| 56 | The subcommand imports an instance's configuration data by performing |
| 57 | the following operations: |
| 58 | |
| 59 | * Creating or updating the instance's files and directories |
| 60 | * Attempting to register the instance with the DAS |
| 61 | |
| 62 | If the attempt to register the instance with the DAS fails, the |
| 63 | subcommand does not fail. Instead, the subcommand displays a warning |
| 64 | that the attempt failed. The warning contains the command to run to |
| 65 | register the instance with the DAS. |
| 66 | |
| 67 | The `import-sync-bundle` subcommand does not contact the DAS to |
| 68 | determine the node on which the instance resides. If the node is not |
| 69 | specified as an option of the subcommand, the subcommand determines the |
| 70 | node from the DAS configuration in the archive file. |
| 71 | |
| 72 | This subcommand is supported in local mode only. |
| 73 | |
| 74 | [[sthref1245]] |
| 75 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 76 | === Options |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 77 | |
| 78 | asadmin-options:: |
| 79 | Options for the `asadmin` utility. For information about these |
| 80 | options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page. |
| 81 | `--help`:: |
| 82 | `-?`:: |
| 83 | Displays the help text for the subcommand. |
| 84 | `--instance`:: |
| 85 | The instance for which configuration data is being imported. The |
| 86 | instance must already exist in the DAS configuration. The archive file |
| 87 | from which the data is being imported must contain data for the |
| 88 | specified instance. |
| 89 | `--nodedir`:: |
| 90 | The directory that contains the instance's node directory. The |
| 91 | instance's files are stored in the instance's node directory. The |
David Matějček | 6c58c14 | 2021-12-20 20:22:31 +0100 | [diff] [blame] | 92 | default is as-install``/nodes``. |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 93 | `--node`:: |
| 94 | The node on which the instance resides. If this option is omitted, the |
| 95 | subcommand determines the node from the DAS configuration in the |
| 96 | archive file. |
| 97 | |
| 98 | [[sthref1246]] |
| 99 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 100 | === Operands |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 101 | |
| 102 | file-name:: |
| 103 | The name of the file, including the path, that contains the archive |
| 104 | file to import. This operand is required. |
| 105 | |
| 106 | [[sthref1247]] |
| 107 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 108 | === Examples |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 109 | |
| 110 | [[GSRFM624]][[sthref1248]] |
| 111 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 112 | ==== Example 1 Importing Configuration Data for a Clustered Instance |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 113 | |
| 114 | This example imports the configuration for the clustered instance |
| 115 | `ymli2` on the node `sj02` from the archive file |
David Matějček | 65f2092 | 2021-12-19 19:44:29 +0100 | [diff] [blame] | 116 | `/export/glassfish7/glassfish/domains/domain1/sync/ymlcluster-sync-bundle.zip`. |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 117 | |
| 118 | The command is run on the host `sj02`, which is the host that the node |
| 119 | `sj02` represents. The DAS is running on the host `sr04` and uses the |
| 120 | default HTTP port for administration. |
| 121 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 122 | [source] |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 123 | ---- |
David Matějček | 9d73d04 | 2021-12-20 13:03:32 +0100 | [diff] [blame] | 124 | sj02# asadmin --host sr04 import-sync-bundle --node sj02 --instance ymli2 |
David Matějček | 65f2092 | 2021-12-19 19:44:29 +0100 | [diff] [blame] | 125 | /export/glassfish7/glassfish/domains/domain1/sync/ymlcluster-sync-bundle.zip |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 126 | Command import-sync-bundle executed successfully. |
| 127 | ---- |
| 128 | |
| 129 | [[sthref1249]] |
| 130 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 131 | === Exit Status |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 132 | |
| 133 | 0:: |
| 134 | command executed successfully |
| 135 | 1:: |
| 136 | error in executing the command |
| 137 | |
| 138 | [[sthref1250]] |
| 139 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 140 | === See Also |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 141 | |
| 142 | link:asadmin.html#asadmin-1m[`asadmin`(1M)] |
| 143 | |
| 144 | link:export-sync-bundle.html#export-sync-bundle-1[`export-sync-bundle`(1)] |
| 145 | |
| 146 | |