CSSCurrent en:Installation

Aus Cryptshare Documentation
Version vom 5. Juni 2024, 11:54 Uhr von Frorathm (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche

Virtual appliance

A virtual appliance can be created at any time using the VM Build Service. The appliance will be sent to you via Cryptshare.

Please note the article Security Audit.

Scope of delivery of the VM Build Service

The following files are shipped to you by the VM Build Service

  • The virtual appliance (.VMDK file)
  • The configuration file for the virtual appliance (.OVF file)
  • The required passwords (.TXT file)
  • The information about required product manuals (.TXT file)

Supported host versions

Cryptshare virtual appliances will be deliverred in the version 4 of the virtual machine. This version is compatible with VMware ESX Server Version 3.0 and higher. If you use a newer ESX version, please upgrade the virtual hardware version as follows:

65669631.png

Additionaly set the Guest OS settings to the newest version of SUSE Linux Enterprise 64bit provided by your vSphere

65669623.png

65669624.png

65669625.png

ESXi Server 4.x and higher

  • Open your vSphere Client
  • Right click to a cluster
  • Select Deploy OVF Template
    65669630.png
  • Click Browse and navigate to the storage location of your virtual appliance
  • Open the configuration file (.OVF) and the virtual disk (.VMDK)
    65669629.png
  • Follow the instructions on the screen

Installation without ovf configuration file

If the configuration file (.OVF) is not available or the import is not working, a new virtual machine can be set up alternatively. Use the received .VMDK file as the virtual disk for the new machine when setting up the new virtual machine. It is recommended to use SUSE Linux Enterprise Server 12 (64bit) or higher as guest operating system. For all further options the default option selected by the wizard can be used.

Extend available disk space for Cryptshare transfers

By default the available disk space for uploads is limited to approx. 15-16GB. Therefore it is recommended to add an additional virtual disk with the preferred size to the appliance.

65669628.png

To configure the additional virtual disk as upload directory, proceed as follows on the Linux console:

  • Log in as root on the console
  • Change into the folder /opt/csappliance using the command cd /opt/csappliance
  • Run the script attachHDD.sh using the command ./attachHDD.sh

The script will attach the new disk to the system and configure it as new upload directory. Rebooting the appliance is not required.

Setting the Temporary Upload Directory
Please note that it might be necessary to also modify the setting for the temporary upload directory (the patch is /var/opt/cryptshare-3/tmp). For detailed instructions please refer to System Startup Settings - Temporary Folder.

Self-Installed Systems

Installers
Please note that the installers are only designed to perform a first-time installation of a Cryptshare Server, not to perform updates. If you want to update an existing Cryptshare Server, please use the update routine from the Administration Interface.

Windows

Run cryptshare-<version>-setup.exe and follow the instructions of the installer.

Cryptshare as Windows Service

The Windows installer sets up and starts the Windows System Service CryptshareService on your computer. By default the start-up setting for this service is automatically. You can change this setting at any time in the Windows Services Settings.

openSUSE

Install the RPM package as root:

zypper install cryptshare-<version>.rpm

During the installation, the user csuser and the group csgroup are created and an init script is set up. After the installation, complete the installation of the service:

systemctl daemon-reload
systemctl start cryptshare

Other Linux Distributions

  1. Create the user csuser (without home folder) and group csgroup on your Linux server
    useradd -M csuser
    groupadd csgroup
    usermod -a -G csgroup csuser
  2. Log into the customer portal or partner portal
  3. Download the latest available 'cryptshare-<version>.'tar.gz package
  4. Copy the downloaded package to your Linux server, e.g. to folder /root
  5. Unpack the package
    tar xvfz cryptshare-<version>.tar.gz
  6. Move the folder cryptshare-<version> to the folder /opt and rename it to cryptshare
    mv cryptshare-<version> /opt/cryptshare
  7. Change the owner of the copied folder to csuser:csgroup
    chown -R csuser:csgroup /opt/cryptshare
  8. Change the permissions for java
    chmod 755 /opt/cryptshare/jre/ -R
  9. Copy the attached script Cryptshare.sh to /etc/init.d on your Linux server, change the name to 'cryptshare' (lowercase) and change the permissions for it
    chmod 755 /etc/init.d/cryptshare
  10. Copy the attached script Cryptshare.service to the folder /etc/systemd/system and take care of the lowercase notation
  11. Enable the Cryptshare service for autostart
    systemctl enable cryptshare
  12. Start the Cryptshare service
    systemctl start cryptshare
Hint
Please use the following syntax, to start, stop or check the status of the Cryptshare service
systemctl <start|stop|status> cryptshare