Multi-Instance Management

Information

Having downloaded, installed, licensed and implemented your baseline system, multiple-instances can be applied to segregate the system.
This is most commonally into LIVE and TEST, but can include TRAIN, DEV and so on ... as many as are required by the customer.
The following document how to add multiple instances on one V1 Server.
Although on the same server, each 'instance' has it's own seperate URL and are completely segregated from one another, allowing for seamless testing of new features, training of new starters or making changes prior to promoting to LIVE.

---

Pre-Requisites

SmartDeployServer (or manual installation) of the server components must have been ran to completion.
SmartDeployClient (or manual installation) of at least the DbLogin Admin Console (and its addons) must be installed and accessbile.
SmartDeployAddon (or manual installation) of the add-on components must have been ran to completion.
All steps of the Server Implementation must have been completed.
You have access to the database management tools and (credentials to access) you used to originally install / implement the baseline installation (such as pGAdmin (PostGRE) or SMSS (SQL).)

Do not continue unless the above have been satisfied, or it will result in lengthy and costly delays to the project to rectify.

---

Download the components you need

Click here to download ArchJson, uncompress the Msi to a temporary location. For our example, we will assume C:\V1Home\SoftwareDownloads.
Click here to download the V1NodeIntegrationServer, uncompress the Msi to a temporary location. For our example, we will assume C:\V1Home\SoftwareDownloads.

---

Install New Instance(s)

In our example, we will assume you want to add a TEST instance to your baseline.
Repeat the below changing the text in blue to any additional one's you require and where a number, increment by 1 each instance.

Open a CMD prompt as an adminstrator and CD to C:\V1Home\SoftwareDownloads

Install the ArchJSON instance
1. Copy / paste the below command:

msiexec /i ArchJsonSetup.msi MSINEWINSTANCE=1 TRANSFORMS=":I02"

2. Click Next
3. Confirm the DbLogin Server (127.0.0.1) and Port (32000), click Next
4. Confirm the Arch Json Server IP Address (127.0.0.1), click Next
5. Confirm the additional Arch Json Server Port for this instance, 32020, click Next
6. Confirm the name of this instance (no spaces), in this example, TEST, click Next
7. Confirm the path is beneath your baseline path of ArchJson, plus the name, so in our example, C:\V1Home\SmartSuite\ArchJsonServer\TEST, click Next
8. Finally, click install, allow to finish and close it when completed.

Install the V1NodeIntegrationServer instance
9. Back to your CMD prompt, copy / paste the below command:

msiexec /i NISSetup.msi MSINEWINSTANCE=1 TRANSFORMS=":I02"

10. Click Next
11. Confirm the Integration Server Name (127.0.0.1), click Next
12. Confirm the additional Integration Server Port 5003, click Next
13. Confirm the name of this instance (no spaces), in this example, TEST, click Next
14. Confirm the path is beneath your baseline path of IntegrationServer, plus the name, so in our example, C:\V1Home\SmartSuite\IntegrationServer\TEST, click Next
15. Finally, click install, allow to finish and close it when completed.

---

Create new Databases

Where PostGRE:

1. Open pGAdmin
2. Right click on the Server > Select Create Database ...
3. Where prompted, give it a name V1Documents_TEST
4. Click Save

Where SQL:

1. Open SQL Management Studio
2. Right click on the Server > Select New Database ...
3. Where prompted, give it a name V1Documents_TEST
4. Click OK

---

Licensing your new Instance(s)

Using the How to Apply Licenses as a guide, apply your licenses to your new Instance(s).

---

Implement your new Instance(s)

Using Server Implementation > Step 1 - SmartPortal as a guide, connect the smartportal to your additional instance(s).
Pay careful attention of the port numbers, paths and databases you're prompted for per instance(s).

---