Source:FAQ - Installation and Configuration/en: Difference between revisions

From SEPsesam
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 50: Line 50:
=== {{anchor|new_server_name}}How do I change the IP address and the name of the SEP sesam Server? ===  
=== {{anchor|new_server_name}}How do I change the IP address and the name of the SEP sesam Server? ===  


Your license must first be [[Special:MyLanguage/FAQ#license_order|modified]] to match the new server name and/or IP address. Send the original license, the new server name, and the IP address to [mailto:info@sep.de info@sep.de].
Your license must first be [[Special:MyLanguage/4_4_3_Beefalo:FAQ#license_order|modified]] to match the new server name and/or IP address. Send the original license, the new server name, and the IP address to [mailto:info@sep.de info@sep.de].


When you receive the new license information, you can change the SEP sesam Server name using <tt>sm_setup</tt>.  
When you receive the new license information, you can change the SEP sesam Server name using <tt>sm_setup</tt>.  
<ol><li>Set the [[Special:MyLanguage/FAQ#profile_setting|SEP sesam profile]] and enter the following command:</li>
<ol><li>Set the [[Special:MyLanguage/4_4_3_Beefalo:FAQ#profile_setting|SEP sesam profile]] and enter the following command:</li>
  sm_setup change_servername <mynewserver>
  sm_setup change_servername <mynewserver>
<li>After executing the command, check the interfaces of the renamed SEP sesam Server: ''Main selection'' -> ''Components'' -> ''Clients'' -> double-click the server (Client) to open its properties. In the '''''Interfaces''''' field, manually remove the old interfaces and enter the new interfaces for ''http'' and ''https''.</li>
<li>After executing the command, check the interfaces of the renamed SEP sesam Server: ''Main selection'' -> ''Components'' -> ''Clients'' -> double-click the server (Client) to open its properties. In the '''''Interfaces''''' field, manually remove the old interfaces and enter the new interfaces for ''http'' and ''https''.</li>
Line 261: Line 261:
''Problem'': The connection between the SEP sesam Client and Server is not functioning.
''Problem'': The connection between the SEP sesam Client and Server is not functioning.


''Solution'': Check DNS resolution. SEP sesam recommends using the <tt>sm_setup check_resolution</tt> command, as described in [[Special:MyLanguage/How_to_check_DNS_configuration#tools|How to check DNS configuration]]. Make sure that you have set up a SEP sesam profile before running the command; for details, see [[Special:MyLanguage/FAQ#profile_setting|FAQ: What happens when I set a profile?]]
''Solution'': Check DNS resolution. SEP sesam recommends using the <tt>sm_setup check_resolution</tt> command, as described in [[Special:MyLanguage/How_to_check_DNS_configuration#tools|How to check DNS configuration]]. Make sure that you have set up a SEP sesam profile before running the command; for details, see [[Special:MyLanguage/4_4_3_Beefalo:FAQ#profile_setting|FAQ: What happens when I set a profile?]]


=== {{anchor|Nagios}}How do I use the Nagios plugin from Netway to query and monitor the SEP sesam database? ===  
=== {{anchor|Nagios}}How do I use the Nagios plugin from Netway to query and monitor the SEP sesam database? ===  

Revision as of 11:07, 20 September 2021

Other languages:

How do I install a Remote Device Server (RDS)?

You can simply install and configure RDS as follows:

  1. Depending on your operating system (Linux or Windows), download the relevant installation file from the SEP Download Center. For details on Linux/Windows installation, see SEP sesam Quick Install Guide.
  2. Add RDS as a SEP sesam Client to the SEP sesam environment. Make sure that the DNS names (between SEP sesam Server and RDS) are correctly resolved (forward and reverse DNS lookup). For details, see Configuring RDS.
  3. Add storage hardware (disk storage, tape libraries or single tape drives) to RDS.

For step-by-step procedure, see How to create a Remote Device Server (RDS).

How do I install the SEP sesam GUI on a Linux system?

To install a SEP sesam GUI on a Linux system, proceed as follows:

  1. Download a package for your Linux distribution from https://www.sep.de/downloadportal/linux/.
  2. Depending on your distribution, install the SEP sesam GUI, as described in SEP sesam Quick Install Guide.
  3. After installing, check that the SEP sesam Server is available by using the following command:
  4. nslookup <SEP sesam Server name> For details, see nslookup.
  5. Make a shortcut with the following path:
  6. /opt/sesam/bin/gui/sesam_gui -S <SEP sesam Server name>

What problems may occur after installing the SEP sesam RPM package?

The following message appears when starting the SEP sesam GUI:

The connection to the server sesamserver was denied.

The last message was:

 java.rmi.RemoteException: Connection refused to host: [SEP sesam-Server]; nested
 exeption is:
 java.net.Connect.Exception: Connection refused
  • Make sure that the SEP sesam RMI Server component is active and the correct port is being used.
  • The program is terminated.
  • If you get this error message, check the Java version with the following command:
  • /opt/sesam/bin/sesam/java -version In the Java v. < 1.7, you will need to update the Java files. For the list of supported Java versions, see Java Compatibility Matrix.

How do I change the IP address and the name of the SEP sesam Server?

Your license must first be modified to match the new server name and/or IP address. Send the original license, the new server name, and the IP address to info@sep.de.

When you receive the new license information, you can change the SEP sesam Server name using sm_setup.

  1. Set the SEP sesam profile and enter the following command:
  2. sm_setup change_servername <mynewserver>
  3. After executing the command, check the interfaces of the renamed SEP sesam Server: Main selection -> Components -> Clients -> double-click the server (Client) to open its properties. In the Interfaces field, manually remove the old interfaces and enter the new interfaces for http and https.
  4. RDS interfaces.jpg

How do I adjust SEP sesam limits?

The best way to adjust SEP sesam limits on the system is to create the Systemd override file. By using this file the settings are not overwritten during the update.

To adjust the SEP sesam limits, proceed as follows:

Example

>
> root@cefix:~# systemctl show sepsesam.service | grep ^LimitCORE=
> LimitCORE=2147483648

  1. Create the override file and adjust the value:
  2. > mkdir -p /etc/systemd/system/sepsesam.service.d/ > echo "[Service]" > > /etc/systemd/system/sepsesam.service.d/override.conf echo > "LimitCORE=infinity" >> > /etc/systemd/system/sepsesam.service.d/override.conf
  3. Reload the system by using the command:
  4. > root@cefix:~# systemctl daemon-reload
  5. Then specify:
  6. > root@cefix:~# systemctl show sepsesam.service | grep ^LimitCORE= > LimitCORE=infinity

What effect does an antivirus scanner have on SEP sesam?

Antivirus scanners may negatively impact your backup and restore operations:

  • The SEP sesam install process is very slow.
  • The GUI is slow or hangs for several seconds.
  • Backup and restore jobs are terminated abruptly.
  • Reduced data throughput and speed.
  • SEP sesam Server/Client is not available (Errorcode 10060).

To avoid such issues, use the antivirus exclusions rules for SEP sesam and exclude the following items from any virus scanning activities:

  • All SEP sesam installation directories on the SEP sesam Server, Client and Remote Device Server (RDS):
    • SESAM_BIN directory including all subfolders
    • SESAM_VAR directory including all subfolders
  • Data store and deduplication store on the SEP sesam Server and RDS:
    • Exclude all partitions on which the data stores are configured for backup.
  • All SEP sesam processes on the SEP sesam Server, Client and RDS:
    • Exclude all executable files from the following directories:
    • <SESAM_ROOT>/bin/sesam/*.* <SESAM_ROOT>/bin/sms/*.*
    • With some virus scanners, you can disable the Child Process Monitoring rule option. In this case, you only have to exclude the following SEP sesam processes:
    • On Windows: sm_main.exe sm_ctrld_main.exe sm_sshd.exe sm_db_main.exe sm_passd.exe sm_rmi_main.exe sm_sepuler.exe sm_sms_main.exe sm_data_server.exe sm_stpd_main.exe sbc.exe On Linux: sm_qm_main sm_ctrld_main sm_sshd sm_db_main sm_passd sm_rmi_main sm_sepuler sm_sms_main sm_data_server sm_stpd_main sbc

How do I calculate the data store capacity (free space calculation and license check)?

Data store volume sizing and capacity usage should be managed at the partition level. It is recommended that only SEP sesam data is stored on the respective volume. Note that it is possible to store non-SEP sesam data on the same partition as the data store without including it in the fill level calculation and thus the license check. For details, see Data store capacity.

When specifying the capacity value, a dedicated partition must have enough free space. The method for calculating the required disk space is:

space occupied by SEP sesam + free disk space = DS capacity

where DS capacity is the configured capacity value in the SEP sesam's data store configuration.

Information sign.png Note
SEP sesam expects the configured data store space to be available.
  • It is essential that the value of volume size of non-sesam data is always larger than the data store capacity value.
  • If the configured data store capacity is not completely available for SEP sesam (i.e., if the non-sesam data occupies more space), backup or migration tasks will fail even if there is enough free space on disk.

DatastorePositive.pngDatastoreNegative.png DatastorePositiveError2.png

Example:

Volume size:     10 TB
   Used by SEP sesam:    4 TB
   Used by non SEP sesam 3 TB
   Free disk space:  3 TB
   ======================
DS capacity:      6 TB
   4 TB + 3 TB     > 6 TB:  -> Backup can start
   ----------------------
   DS capcity:       8 TB
   4 TB + 3 TB     < 8 TB:  -> Backup will fail

For example, a data store reports the following error:

Not enough disk space could be freed to reach high water mark of -100GB for data store Data-Store. 
(Data store: Data-Store. Free space: 696GB . Freed: 3GB). 

Solution: You have to correct the capacity value of your data store.

How do I determine the number of SID for Oracle?

You can determine the number of SID for Oracle in the following ways:

  • View the list of the operating system's running processes.
  • If an Oracle instance is running, the system monitor will also be running. The name of the Oracle process always contains part of the instance name. The common form is ora_<process_name>_<sid> Example: oracle@myhost:/ ps -ef | grep smon oracle 23557 11596 0 Dec 19 ? 0:22 ora_smon_rac1 In this case, the SID is rac1.
  • Check the oratab.
  • Open the oratab in /var/opt/oracle. You will find the name of the instance and the Oracle home for automatically starting Oracle instances. Example: oracle@myhost:cat /var/opt/oracle/oratab rac1:/opt/app/oracle/product/10.2.0/db_1:N
  • View the parameter file.
  • In the Oracle home under dbs or database, you will find either init<sid>.ora or the relevant SP file. The parameters of the instance are stored here. The db_name and instance_name parameters provide information about the database name and SID.
  • Sign in on the instance as DBA and query the relevant views.
  • In SQL*Plus as DBA-User: SQL: 1. SHOW parameter db_name 2. SHOW parameter instance_name The following statements can be used from every tool: 1. SQL> SELECT instance_name FROM v$instance; 2. SQL> SELECT [name] FROM v$database;

How do I configure the SEP sesam profile to run automatically during login?

Create a link in the directory /etc/profile.d/ as follows:

ln -s /var/opt/sesam/var/ini/sesam2000.profile /etc/profile.d/sesam.sh

How do I set permissions for a GUI client?

In previous SEP sesam versions, you have to set client permissions via the command line. As of version 4.4.3 Grolar, you can simply set client permissions by configuring ACLs in the SEP sesam GUI. For details, see Using Access Control Lists.

Authentication permissions Beefalo V2.jpg

What problems may occur when adding a new client?

The following errors may appear when adding new clients to the SEP sesam Server.

Error message 1:

No Access for Computer pc2 - please enter for pc1

or

There is no SEP sesam installed on computer pc2, please install it.

The problem might be:

  • There is no SEP sesam Client software installed.
  • The wrong system name is specified in the SEP sesam GUI.
  • There is an active firewall between the two computers.

Solution:

  • Install the SEP sesam software on the target client.
  • If the name was entered incorrectly, delete it and then re-enter it.
  • Deactivate the firewalls or install the SEP sesam firewall option.

Error message 2:

Rights Restriction -  [pc1.domain.de system] in pc2:<SESAM_VAR>/var/ini/sm_ctrld.auth

Problem: The SEP sesam Server has no privileges to access the client.

Solution: Enter the value in the [___] into the client's <SESAM_VAR>/var/ini/sm_ctrld.auth.

Error message 3:

Test backup from pc2 does not restore to pc1 – please verify (ping, DNS, local STPD)

Problem: The connection between the SEP sesam Client and Server is not functioning.

Solution: Check DNS resolution. SEP sesam recommends using the sm_setup check_resolution command, as described in How to check DNS configuration. Make sure that you have set up a SEP sesam profile before running the command; for details, see FAQ: What happens when I set a profile?

How do I use the Nagios plugin from Netway to query and monitor the SEP sesam database?

SEP Warning.png Attention

Open source monitoring tools like Nagios are not part of, nor are they supported by, SEP AG and/or its partners and subsidiaries. Neither are other programs or scripts which query data from the SEP sesam DB or any other SEP sesam module that are not specifically distributed by SEP AG. SEP cannot and will not make any guarantees or warranties as to the usability or functionality of such scripts. Therefore, for obvious reasons, SEP cannot offer support for any of these customer and client designed and implemented tools or programs. Consequently, there is no support for the client specific programs.

NETWAYS GmbH has developed an open-source database query routine for SEP sesam – the Nagios plugin. In accordance with the OSF foundation rules, this is a free software package that comes with the standard disclaimers regarding warranty, usability, and functionality. In other words, use it for free at your own risk. You can download the plugin from SEP Download Center.

Demo scripts from projects

Various scripts have been written for specific projects to allow customers to query (retrieve information from) the SEP sesam DB. These scripts are very specific to the client environments and are in no way guaranteed to work in other environments. Sample scripts to query the SEP sesam database have been written illustrating the use of the Nagios methodology and are meant to be used for demonstration purposes only. They can be found at SEP Download Center.

How do I configure a command event?

You can configure the command events in the SEP sesam GUI. You might have to set permissions to execute the commands. For details, see Creating a Command Event.

How do I configure a follow-up event?

You can configure the follow-up events that are triggered on the SEP sesam Server once the initial event is completed. In the SEP sesam GUI, you can set up migration, saveset verify and other actions to be triggered immediately after the backup or other event is completed. For details on configuring such events, see Follow-up events.

Follow up events Beefalo V2.jpg

How do I change data size units?

You can change the default unit for data size by using the menu bar -> Configuration -> Defaults -> select the Display Format tab. The data size can be specified either with (KB, MB, GB, TB) or binary prefix (KiB, MiB, GiB, TiB).

Defaults data size Beefalo V2.jpg

You can also set a different data size unit for the individual table. For details, see Changing data size units.


Usage

This template is included in the FAQ and other sections describing GUI info.