ããã¯ããªã«ãããããŠæžãããã®ïŒ
Infinispan 10以éã®ServerNGã«ãªã£ãŠCLIã倧ããå€ãã£ãŠããã®ã§ããã1床ãã£ããèŠãŠã¿ããããªãšæããŸããŠã
ããã¥ã¡ã³ãçã«ã¯ããã¡ãã§ããã
Using the Infinispan Command Line Interface
ç°å¢
ä»åã¯ãInfinispan 11.0.1.Finalã䜿çšããŠããŸãã
$ bin/cli.sh version CLI: Infinispan 'Corona Extra' 11.0.1.Final
ã¹ã¯ãªãããšãã«ã
Infinispan Serverã®CLIã¯ããbin/cli.shããšãããã¡ã€ã«ã«ãªããŸãã
ãã£ããèŠãæã
- Infinispan Serverã«é¢ãããŠãŒã¶ãŒã®ç®¡ç
- Cacheã®ç®¡ç
- Counterã®ç®¡ç
- Taskã®å®è¡
- Infinispan Serverã®åæ¢
ããããã§ããããã§ãã
WildFlyããŒã¹ã ã£ãé ããããçŸæç¹ã§ã¯æ±ããç¯å²ãçãŸã£ãŠããæ°ã¯ããŸãã
EndpointãèªèšŒã«é¢ããèšå®ãªã©ã¯ãçŽæ¥èšå®ãã¡ã€ã«ãç·šéããããšã«ãªãããã§ããã
ãªãã·ã§ã³ãèŠãŠã¿ãŸãããã
$ bin/cli.sh -h Usage: cli [<options>] Options: -t, --truststore A truststore to use when connecting to SSL/TLS-enabled servers -s, --truststore-password The password for the truststore -v, --version Shows version information --trustall Whether to trust all certificates -f, --file File for batch mode -c, --connect A connection URL. Use '-' to connect to http://localhost:11222 -h, --help cli commands: add Adds/subtracts a value to/from a counter cache Selects a cache cas Compares and sets counter values cd Selects a subsystem or item clear Clears the screen clearcache Clears the cache connect Connects to a remote server container Selects a container counter Selects counters create Creates a cache or a counter describe Displays information about the specified resource disconnect Disconnects from a remote server drop Drops a cache or a counter echo Echoes messages to the output. Useful for adding information to batch runs. encoding Gets/sets the current encoding get Gets an entry from the cache ls Lists resources in a path patch Patch operations put Puts an entry into the cache query Queries a cache remove Removes an entry from the cache replace Puts an entry into the cache reset Resets a counter to its initial value run Reads and executes commands from one or more files schema Manipulates protobuf schemas shutdown Shuts down individual servers or the entire cluster site Manages backup sites user User operations version Shows version information
ã³ãã³ãã«å¯ŸããŠã®ãã«ããèŠãããšãã§ããŸãã
$ bin/cli.sh user -h Usage: cli user [<options>] User operations Options: -h, --help user commands: create Creates a user describe Describes a user remove Removes a user password Changes a user's password groups Sets a user's groups ls Lists all users/groups encrypt-all Encrypts all of the passwords in a property file.
ãµãã³ãã³ããæã€ã³ãã³ãã«å¯ŸããŠã¯ããµãã³ãã³ããæå®ããç¶æ ã§ãã«ããèŠãããšãã§ããŸãã
$ bin/cli.sh user create -h Usage: cli user create [<options>] <username> Creates a user Options: -p, --password The password for the user -r, --realm The realm -a, --algorithms The algorithms used to encrypt the password -g, --groups The groups the user should belong to --plain-text Whether the password should be stored in plain text (not recommended) -f, --users-file The path of the users.properties file -w, --groups-file The path of the groups.properties file -s, --server-root The server root -h, --help Argument: The username for the user
ãŠãŒã¶ãŒãäœæãã
Infinispan Serverã§å©çšããããŠãŒã¶ãŒã®äœæã«ã€ããŠãããã¥ã¡ã³ãã¯ãã¡ãã§ãã
ãªãã·ã§ã³ã¯ããããããã®ã§ãããä»åã¯ãŠãŒã¶ãŒåïŒispn-adminïŒãšãã¹ã¯ãŒããæå®ããŠäœæã
$ bin/cli.sh user create ispn-admin -p password
Connecting to Infinispan Servers
ãŠãŒã¶ãŒãåé€ãããããã¹ã¯ãŒããå€æŽããããšãå¯èœãªããã§ãã
$ bin/cli.sh user -h Usage: cli user [<options>] User operations Options: -h, --help user commands: create Creates a user describe Describes a user remove Removes a user password Changes a user's password groups Sets a user's groups ls Lists all users/groups encrypt-all Encrypts all of the passwords in a property file.
Infinispan Serverã«æ¥ç¶ãã
äœæãããŠãŒã¶ãŒã䜿çšããŠãInfinispan Serverã«æ¥ç¶ããŠã¿ãŸãããã
Connecting to Infinispan Servers
CLIãå®è¡ããŠãconnectãã³ãã³ããå®è¡ãããšããŠãŒã¶ãŒåãšãã¹ã¯ãŒãèãããã®ã§å ¥åããŸãã
$ bin/cli.sh [disconnected]> connect Username: ispn-admin Password: ******** [infinispan-server1-17502@cluster//containers/default]>
ããã§ãInfinispan Serverã«æ¥ç¶ã§ããŸãã
CLIèµ·åæã«ãã-cããªãã·ã§ã³ã§connectãåæã«è¡ãããšãã§ããŸãããã®æãã-ããæå®ãããšããã©ã«ãã®æ¥ç¶å
ã§ãã
ãhttp://localhost:11222ããæå®ããããšã«ãªããŸãã
$ bin/cli.sh -c - # 以äžãå¯ ## $ bin/cli.sh -c localhost:11222 ## $ bin/cli.sh -c http://localhost:11222 Username: ispn-admin Password: [infinispan-server1-17502@cluster//containers/default]>
ããã«ãæ¥ç¶æã«ãŠãŒã¶ãŒåãšãã¹ã¯ãŒããæå®ããå Žåã¯ããã¹ãåã®åã«å«ãã圢ã«ãªããŸãã
$ bin/cli.sh -c http://ispn-admin:password@localhost:11222 [infinispan-server1-17502@cluster//containers/default]>
æ¥ç¶åŸã¯ãã¿ãè£å®ãèãããã«ãªããŸãã
[infinispan-server1-17502@cluster//containers/default]> add cas clearcache counter disconnect encoding help migrate query reset server stats user alias cd connect create drop export logging patch quit run shutdown task version cache clear container describe echo get ls put remove schema site unalias
ãhelpãã³ãã³ãã§ããå©çšå¯èœãªã³ãã³ããèŠãããšã¯ã§ããŸããã
[infinispan-server1-17502@cluster//containers/default]> help Call `help <command>` where command is one of: container replace evict export query abort shutdown server cas end clear site user disconnect echo patch add encoding logging migrate roles clearcache connect start quit ls run stats unalias version reset drop revoke get rollback counter describe commit put create cache task begin schema remove alias cd help grant
Cacheãäœæã»åé€ãã
Cacheã®äœæãåé€ããã£ãŠã¿ãŸãããã
ããã¥ã¡ã³ãã¯ããã¡ãã
Creating Caches with the Infinispan Command Line Interface (CLI)
1çªç°¡åãªã®ã¯ããã³ãã¬ãŒããæå®ããŠCacheãäœæããããšã§ãã
[infinispan-server1-17502@cluster//containers/default]> create cache myCache -t org.infinispan.DIST_SYNC
䜿ããCacheã®ãã³ãã¬ãŒãã¯ããã¡ãã§ããã
å®éã®å®çŸ©ã¯ããã¡ãã«ãªããŸãã
äœæããCacheã¯lsã§èŠããã
[infinispan-server1-17502@cluster//containers/default]> ls caches ___script_cache myCache ___protobuf_metadata
describeã§å®çŸ©ã確èªãããã§ããŸãã
[infinispan-server1-17502@cluster//containers/default]> describe caches/myCache { "distributed-cache" : { "mode" : "SYNC", "remote-timeout" : 17500, "state-transfer" : { "timeout" : 60000 }, "transaction" : { "mode" : "NONE" }, "locking" : { "concurrency-level" : 1000, "acquire-timeout" : 15000, "striping" : false }, "statistics" : true } }
ãšããã§ãserver/conf/infinispan.xmlãèŠãŠãCacheã®å®çŸ©ã¯è¿œå ãããŠããŸããã
<cache-container name="default" statistics="true"> <transport cluster="${infinispan.cluster.name}" stack="${infinispan.cluster.stack:tcp}" node-name="${infinispan.node.name:}"/> </cache-container>
CLIã§äœæããCacheã®å®çŸ©ã¯ããã¡ãã«æžã蟌ãŸããŸãã
server/data/caches.xml
<?xml version="1.0" ?> <infinispan> <cache-container> <distributed-cache mode="SYNC" remote-timeout="17500" name="myCache" statistics="true"> <locking concurrency-level="1000" acquire-timeout="15000" striping="false"/> <transaction mode="NONE"/> <state-transfer timeout="60000"/> </distributed-cache> </cache-container>
ãã®Cacheã®å®çŸ©ã¯ãã¯ã©ã¹ã¿ã«åå ããŠããå šããŒãã«åæ ãããŸãããããšããã¯ã©ã¹ã¿ã«åå ããããŒãã«ãåæ ãããŸãã
ããã²ãšã€ã®äœãæ¹ã¯ãCacheã®å®çŸ©ããã¡ã€ã«ã§äœæãããããæå®ããŠCacheãäœæããŸãã
ããšãã°ããããªãã¡ã€ã«ãçšæããŸãã
cache-snippet.xml
<?xml version="1.0" ?> <infinispan> <cache-container> <distributed-cache mode="SYNC" name="cache"> <transaction mode="NON_XA"/> </distributed-cache> </cache-container> </infinispan>
XMLã®èŠçŽ ã¯ãinfinispanãšcache-containerããããŠCacheã®å®çŸ©ãã²ãšã€ã«ãªããŸãã
ãã¡ãããã-fããªãã·ã§ã³ã§æå®ãã€ã€ãCacheã®ååãæå®ããŠCacheãäœæããŸãã
[infinispan-server1-17502@cluster//containers/default]> create cache transactionalCache -f ./cache-snippet.xml
äœæãããã¡ã€ã«ã«è€æ°ã®Cacheãæžãã«ã¯æžããã®ã§ãããæåŸã«å®çŸ©ããCacheããèŠãŠããªãããã§ãã
ãŸããCacheã®ååã¯å¿
ãæå®ããå¿
èŠããããçšæããCacheã«å®çŸ©ãããååã¯ç¡èŠãããcreate cacheæã«æå®ãã
ååãCacheã«åæ ãããŸãããã³ãã¬ãŒãããã¡ã€ã«ãšããŠçšæããæããªãã§ããããã
Cacheã®èŠçŽ ãšããŠã©ã®ãããªãã®ãå®çŸ©ã§ãããã¯ããã¡ããèŠããšããã§ãããã
Cacheã®åé€ã
[infinispan-server1-17502@cluster//containers/default]> drop cache myCache
ãããæäœ
ãããæäœãèŠãŠã¿ãŸãã
ãããæäœã«ã¯ããã¡ã€ã«ãå
¥åã«ããæ¹æ³ãšãã€ã³ã¿ã©ã¯ãã£ãã«å
¥åããæ¹æ³ããããŸããããã€ã³ã¿ã©ã¯ãã£ãã«
å
¥åããæ¹ã¯çµäºã埮åŠã ã£ãã®ã§ããã¡ã€ã«ã䜿ãæ¹ã ãã«ããŠãããŸãã
Performing Batch Operations with Files
ãããªæãã§ãå®è¡ããã³ãã³ããåæãããã¡ã€ã«ãçšæããŸãã
commands.txt
create cache myCache -t org.infinispan.DIST_SYNC create cache transactionalCache -f ./cache-snippet.xml ls caches
ããšã¯ãCLIã«ã-fããªãã·ã§ã³ã§æå®ããŠå®è¡ããã ãã§ãã
$ bin/cli.sh -c http://ispn-admin:password@localhost:11222 -f commands.txt
ãã¡ã€ã«ãäœããã«ãããªãããããªæãã§ããããã
$ echo ' create cache myCache -t org.infinispan.DIST_SYNC create cache transactionalCache -f ./cache-snippet.xml ls caches ' | bin/cli.sh -c http://ispn-admin:password@localhost:11222 -f -
ã€ã³ã¿ã©ã¯ãã£ãã«å®è¡ããæ¹æ³ããå°ãå€ãããã®ã§ãã
Performing Batch Operations Interactively
ã¡ãªã¿ã«ãä»åã¯ã-cãã«ãŠãŒã¶ãŒåãšãã¹ã¯ãŒããæå®ããŸããããæå®ããªãã£ãå Žåã¯ã³ãã³ãå®è¡æã«å¯Ÿè©±çã«
èãããããšã«ãªããŸãã
$ bin/cli.sh -c - -f commands.txt Username: ispn-admin Password:
ããŒããã¯ã©ã¹ã¿ãåæ¢ãã
ãshutdownãã³ãã³ãã§ãããŒããã¯ã©ã¹ã¿ãåæ¢ããããšãã§ããŸãã
ç¹å®ã®ããŒããæå®ããŠããã®ããŒããåæ¢ããŸãã
[infinispan-server1-17502@cluster//containers/default]> shutdown server infinispan-server1-17502
ã¯ã©ã¹ã¿ãåæ¢ãã¯ã©ã¹ã¿ã«åå ããŠããå šããŒããåæ¢ããŸãã
[infinispan-server1-17502@cluster//containers/default]> shutdown cluster
èµ·åãåèµ·åã¯ã§ããªãããã§ããâŠã