Page tree
Skip to end of metadata
Go to start of metadata




One of the methods of implementing LOG Plus is Virtual Appliance (VA) – a complete virtual disk image containing the operating system, database and configured LOG Plus application.

Watch the tutorial in which we go through the entire path of running LOG Plus in the Virtual Appliance model: Go to the recording >







Step 1 – Prepare the server


To run LOG Plus VA, you need to prepare the server – physical or virtual, e.g. using the MS Azure or AWS platforms. The server should have an operating system (Linux or Windows Server).


 View server technical requirements

Server technical requirements

The level of requirements

Number of agents

RAM [GB]

HDD [GB]*

CPU Core

CPU [GHz]

NET [Mb/s]

Minimal

10 – 200

2

10

1

2.1+

80

Recommended


10 – 200

4

20

2

2.5+

100

Minimal

201 – 1000

4

80

2

2.1+

100


201 – 1000

6

100

4

2.5+

1024

Minimal

1001 – 5000

16

200

6

2.1+

1024

Recommended

1001 – 5000

16

300

8

2.5+

1024

Minimal

5001 – 50 000

16

400

16

2.1+

10240

Recommended

5001 – 50 000

32

800

32

2.5+

10240

* the requirements do not include the amount of disk space needed to install the server system; the space required depends on consumption, e.g. the number and weight of attachments to be uploaded.

Port configuration

The ports are correctly configured in the Virtual Appliance package.

Network bandwidth

  1. Minimum required network bandwidth (less than 5,000 computer resources or less than 100 operators / agents): 1 Gbps
  2. Recommended network bandwidth (over 5000 computer resources or over 100 operators/agents): 10 Gbps

Technical requirements for LOG Plus Agent

  1. 1GB of free RAM,
  2. 0.1GB of free space on the hard disk (partition C),
  3. at least 1 CPU core,
  4. minimum 1.0GHz CPU,
  5. .NET Framework version 3.5 and .NET Framework 4.5.2 installed,
  6. computer specification compliant with the requirements of the operating system running on 
  7. a network card or other network interface that allows data to be sent to the server,
  8. Windows Vista operating system or newer.





Step 2 – Download Virtual Appliance


The implementation of LOG Plus using the Virtual Appliance method is performed with the use of an exported virtual disk file with the .VHD or .VMDK extension. 

It is also possible to run Virtual Appliance from a full .OVA or .OVF virtual machine image.

The latest version for download can be found at this address: https://logsystem.pl/logplus-va/

(The .zip file must be unpacked)


 CoWhat does Virtual Appliance LOG Plus include?

LOG Plus VA:

  • Operating system:
    • Ubuntu (18.04 LTS x64)
  • Database:
    • PostgreSQL (v10.12)
    • you can replace your own database, e.g MS SQL Server
  • Framework and other:
    • ASP.NET Core Runtime (v3.1)
    • DotNet Runtime (v3.1)
    • Open-ssh pack(SSH access)
  • LOG Plus system
    • LOG Plus Portal
    • LOG Plus Server
    • LOG Plus database
    • LOG Plus Agent





Step 3  – Launch Virtual Appliance 

On the previously prepared server, download and install a virtualization tool, e.g. free Oracle VM VirtualBox https://www.virtualbox.org for your server’s operating system.

Create a virtual machine and import the LOG Plus disk image based on the instructions for the selected tool:


 VMWare vSphere configuration
  1. We log in to our vSphere client.



  2. Click on the button Create/Register VM (1)



  3. Step 1 - Choose an option Create a new virtual machine (1)



  4. Step 2 - Complete the form using the same data shown in the screen 
    1. (1) - Name: LOGPlus
    2. (2) - Compatibility - ESXi 6.5 virtual machine
    3. (3) - Guest OS family - Linux
    4. (4) - Guest OS version - Ubuntu Linux (64-bit) 



  5. Step 3 - Choose the required datastore. If there is only one datastore, just go ahead without any changes.



  6. Step 4 - In the next step, we are facing the most changes.  
    1. After (1) - delete the existing, automatically created hard disk by clicking on the cross icon
    2. After (2) - select option Add hard disk thanks to which we will add an existing disk with a pre-installed application



      1. After selecting the above-mentioned option, click on Existing hard disk


         
    3. The next step is to upload the virtual disk file to our virtualization server.  
      1. Click on the button Upload (1) and select the previously unpacked .vmdk file.
      2. When the file upload progress bar reaches the end, click on the uploaded file (2) and select it with the button Select (3)


         
      3. Next, click: 



    4. The next step in configuring the settings is changing the parameter Controller location (1) for a previously uploaded file. Choose the settings for it: IDE controller 0 and Master 
    5. The next step is to set up the RAM allocated to the server. The suggested value is 4GB (2)



  7. After the process of adding the virtual machine has been successfully completed, we should be redirected to the main page of the vSphere client.

    Additionally, the following message should appear: Virtual machine LOGPlus was successfully created.





  8. The server is ready to run.


 Oracle VM VirtualBox configuration
  1. Open the Oracle VM VirtualBox manager, then select the options to create a new virtual machine.
    Machine > New...

  2. In the next screen, complete the sections according to the scheme: 
    1. Name: LOGPlus
    2. Type: Linux
    3. Version: Ubuntu (64-bit)



  3. In the next section, we set the amount of RAM allocated to the virtual machine. Suggested value: 4096 MB.



  4. The next section is for selecting a hard drive. Use the third option: Use an existing virtual hard disk file and we go to the file selection menu (1).



  5. In menu Hard Disk Selector click on the button Add (1) and select the previously unpacked file .vhd



  6. Finish creating the virtual machine with the button Create.
  7. After correctly going through all the above-mentioned steps, the virtual machine should be ready to use.


 Hyper-V configuration
  1. Open the Hyper-V manager, right-click on our server, select the options to create a new virtual machine.

    "Nazwa serwera" > New > Virtual Machine...



  2. In the section Specify Name and Location – in the field Name enter the suggested value: LOGPlus



  3. In the section Specify Generation, choose the first option: Generation 1



  4. In the section Assign Memory, in the field Startup memory enter the suggested value: 4096 MB



  5. Sections Configure Networking should be completed according to the scheme of our network (you can skip this stage at the moment and configure the network later).
  6. In step Connect Virtual Hard Disk – choose the second option Use an existing virtual hard disk and clicking on the button Browse select the previously unpacked file .vhd



  7. After correctly going through all the above-mentioned steps, the virtual machine should be ready to use.
 VMWare Workstation configuration
  1. Open the VMWare Workstation manager, then select the options to create a new virtual machine.
    Player > File > New Virtual Machine...



  2. In the next step, choose an option I will install the operating system later and click Next.
  3. Complete the next stage as follows:
    Guest operating system: Linux
    Version: Ubuntu



  4. The next step is to name your virtual machine. Suggested name: LOGPlus
  5. The next window configures the virtual disk. This step does not matter to us because we will be using a different drive than the default one. Just move on.
  6. The next step is a summary. Now click on the button Customize Hardware... (1).



  7. In this window, we can change the default hardware parameters for the new virtual machine.
    1. Suggested change:  RAM: 4096 MB (1, 2).
    2. An additional step to take is network configuration (3). This should be done according to your own preferences and network scheme in the organization, so that the services running within the virtual machine are accessible from the outside.



  8. We are finalizing the creation of the virtual machine.
  9. In the next stage, we should remove the default virtual disk and connect to the machine the one containing the LOG Plus application.  
    1. To do this, right-click on the name of our newly created virtual machine and select the option  Settings (1)



  10. Click the button at the bottom of the screen Add (1) and then select an option  Hard Disk (2).



  11. In the disk type selection section, use the options recommended by the program.
  12. In the next stage of disk selection, select the option Use an existing virtual disk.



  13. The next window should guide us through the file selection process.
    1. Click the button  Browse...
    2. Then in the lower right corner of the screen we get rid of the file type filtering by using the options  All files (*.*)



    3. Search for our previously unpacked file .vhd
  14. In the prompt asking for the action to be performed after the file selection process, use the options Keep Existing Format.



  15. Finally, we can safely remove the disk created in the virtual machine creation process.
    1. Click on the resource to be deleted (1).
    2. Then click on the button Remove (2).



  16. After correctly going through all the above-mentioned steps, the virtual machine should be ready to use.
     




Step 4  – Configure the network


Attention

The LOG Plus application is prepared under operation only in the local network where the server is located. For an agent on a computer outside the network to be able to communicate with LOG Plus, and for users to log into the portal, such a computer must be connected to the network via VPN or you must take care of routing on your own.

If there are any network problems with the correct configuration of the virtual machine network, the command should be run on the guest system (i.e. our system – Ubuntu 18.04):

dhclient

It will force the acquisition of a new IP address from the DHCP server.




Step 5  – Activate LOG Plus 


  1. Run the configured LOG Plus virtual machine in your virtualization tool.

  2. Check the machine’s IP address (command: ifconfig), if necessary, make changes according to your local network configuration.
  3. Check the correct operation of LOG Plus in the web browser while on the server by entering the address using the read IP address (e.g. http://192.168.0.101).
  4. Log in to LOG Plus by entering the login, password and license key received after registration. 
  5. You can use LOG Plus!


In the case of the message “Unable to connect to LOG CRM” after entering the activation key, check whether the server can communicate with the LOG CRM service at the address logcrm-api.logsystem.pl (HTTP request: port 443, address 195.201.5.172).

The most common sources of the problem are:

  1. no connection of the LOG Plus server to the Internet,
  2. DNS problems,
  3. blocked traffic on an external firewall,
  4. replaced SSL certificate (e.g. by hardware on the router) - LOG Plus considers it untrusted and blocks communication with LOG CRM.

No communication with logcrm-api.logsystem.pl will also cause no software and dictionary updates available.

Access data:

Linux administrator login data:

  • login: root
  • password: LpFirstRootPass

LOG Plus administrator login data:

  • login: admin
  • password
    • for customers with a LOG Plus FREE license: it will be sent by SMS to the telephone number provided in the application form
    • for customers with a commercial LOG Plus license: will be sent by e-mail by the sales representative

LOG Plus license key:

  • the key will be sent via email 

Step 6 (optional) – Configure SSL 


Additionally, you can configure an SSL certyficate for the LOG Plus site to avoid the security message by going to the application page.


  • No labels