The syncbi command (Linux)

Run the syncbi.sh command to set up connections to Hadoop Distributed File Systems in IBM® InfoSphere® BigInsights®.

The syncbi.sh command connects to the InfoSphere BigInsights computer and collects files and information that InfoSphere Data Click needs to access the HDFS.

You run the syncbi.sh command in the following circumstances:

To initially connect to InfoSphere BigInsights.
If a patch or fix pack has been installed to InfoSphere BigInsights.
If the underlying Hadoop property files or configuration files on the InfoSphere BigInsights computer have been changed.
If the host name or port number for InfoSphere BigInsights were changed, for example when moving from test into production.

Procedure

On the IBM InfoSphere Information Server engine tier computer, shut down the engine and node agents as either the root user or the DataStage® administrator user. (The DataStage administrator user is dsadm if you accepted the default name during installation). For example, issue these commands:
```
cd <IS_install_path>/Server/DSEngine
. ./dsenv
./bin/uv -admin -stop
cd ../../ASBNode/bin
./NodeAgents.sh stop
```
If you intend to run the next step as the DataStage administrator user, first delete the/tmp/ibm_is_logs folder as the root user:
```
su - root
cd /tmp
rm -rf ibm_is_logs
```
Run the syncbi.sh command as either the root user or the DataStage administrator user. For example, issue the following command, which includes all of the required parameters:
```
cd <IS_install_path>/Server/biginsights/tools
./syncbi.sh -biurl protocol://bihost:biport -biuser username -bipassword 
password -ishost hostname -isport portnumber
```

Restart the engine and node agents by issuing these commands as the DataStage administrator user:

su - dsadm
cd <IS_install_path>/Server/DSEngine
. ./dsenv
./bin/uv -admin -start
cd ../../ASBNode/bin
./NodeAgents.sh start

Command syntax

<IS_install_path>/Server/biginsights/tools/syncbi.sh
  -help |
  -biurl value
  -biuser value
  -bipassword value
  -ishost value
  -isport value
  [-{verbose | v}]

Parameters

-help |

Displays command usage information.

-biurl protocol://hostname:port

Specifies the URL of the InfoSphere BigInsights computer.

protocol: Can be either https or http, depending on whether you want to connect to the InfoSphere BigInsights computer with or without SSL.
hostname: The host name of the InfoSphere BigInsights computer or master node. If the protocol is https, specify the host name exactly as it is specified in the InfoSphere BigInsights SSL certificate.
port: The InfoSphere BigInsights port number to use for the specified protocol.

-biuser username

Specifies the InfoSphere BigInsights administrator user name.

-bipassword password

Specifies the password for the InfoSphere BigInsights administrator user.

-ishost hostname

Specifies the host name of the IBM InfoSphere Information Server services tier computer.

-isport portnumber

Specifies the port number for the IBM InfoSphere Information Server services tier computer, for example, 9443 if the default installation port is used.

[-{verbose | v}]

Optional: Displays detailed information throughout the operation.