Installation guide

Definitions

In this article we reference client and server computers. A server computer the computer on which the shared database and related software executes. A client computer is one used by an individual user. The software installed on the client computer communicates with the server software over the network.

Before you start

The server address can be predefined in the licence database. Doing so simplifies the setup procedure. Check with the responsible IT department to find the server address; and liaise with the licence provider to have this address associated with the licenses.

Client software must be able to connect to the server software. By default this is on TCP/IP port 5053. Check with the responsible IT department to ensure that any firewall rules are set to allow this incoming traffic on the server.

A working direct internet connection (not via a proxy) is required during the installation process.

Downloading the software

The software is installed using the Armida Product Manager. This can be downloaded from the following location. Armida Product Manager

Installing server components

The server software must be installed before installing clients. Download Armida Product Manager from the link above and extract and execute amfsetup.exe from the zip file. After installing the Armida Product Manager, open the start menu, for example on Windows 10 press the Windows button. Locate and click the “Install Product” option.

The registration key entry dialog will be shown.

Paste the server licence only into the input field and click the check mark button. The server software will be downloaded and installed.

Installing client components

The procedure for installing the client software is the same as that for installing the server software up to the point of entering licence keys.

Licence keys for a client are supplied in a block to represent all the features to be enabled. It is important to paste in all the licence keys for a client in one operation. It is also important to ensure that the first client installation includes a cisadmin licence.

After entering the licence details you will be prompted to enter the server connection information (address and optionally the port). If this was preset as described at before you start; this will be filled in for you.

Click the test button; the server connection will be checked and if okay the installation proceeds.

After installing the first client, system permissions should be set as described at initial permissions

After installing each client the server licence should be refreshed. Start the cisadmin tool from the start menu.

The licence tab should be selected and the “Refresh License” button clicked.

Troubleshooting

Connection issues

A normally working client will show the connection information in the status bar as shown here.

If there is a connection issue the disconnected icon is shown.

Check that the server process (cis.exe) is executing on the server using task manager.

Check that a connection can be made to the server software by executing telnet on the server.

Check that a connection can be made from the client to the server software by executing telnet on the client.

A successful connection will show a blank prompt. Type CTRL+] and quit to exit

Note telnet is not enabled by default; it can be en/disabled with the following commands.

Check that the port settings for the server are correct at %ALLUSERSPROFILE%\cis-1\cis.ini

Note: %ALLUSERSPROFILE% is a folder location that varies from computer to computer. Entering the file path into the Windows explorer search bar as shown here will open the file.

Check that the port settings for the client are correct at %LOCALAPPDATA%\program-1\program.ini; where program is the name of the client component (bomarchitect, cisadmin,pilot,qa etc).

Check that the firewall rules allow the connection

Manual licence refresh

If for any reason cisadmin is not available available, the server service can be restarted after deleting the licence file. The licence file will be refreshed on the restart. Example